{
  "project_root": ".",
  "generated_at": "2026-02-02T19:29:13.109054",
  "modules": [
    {
      "name": "generate_semantic_map",
      "type": "Module",
      "tier": "CRITICAL",
      "start_line": 1,
      "end_line": 1000,
      "tags": {
        "TIER": "CRITICAL",
        "SEMANTICS": "semantic_analysis, parser, map_generator, compliance_checker, tier_validation, svelte_props, data_flow",
        "PURPOSE": "Scans the codebase to generate a Semantic Map and Compliance Report based on the System Standard.",
        "LAYER": "DevOps/Tooling",
        "INVARIANT": "All DEF anchors must have matching closing anchors; TIER determines validation strictness."
      },
      "relations": [
        {
          "type": "READS",
          "target": "FileSystem"
        },
        {
          "type": "PRODUCES",
          "target": "semantics/semantic_map.json"
        },
        {
          "type": "PRODUCES",
          "target": "specs/project_map.md"
        },
        {
          "type": "PRODUCES",
          "target": "semantics/reports/semantic_report_*.md"
        }
      ],
      "children": [
        {
          "name": "__init__",
          "type": "Function",
          "tier": "TRIVIAL",
          "start_line": 25,
          "end_line": 32,
          "tags": {
            "TIER": "TRIVIAL",
            "PURPOSE": "Mock init for self-containment.",
            "PRE": "name is a string.",
            "POST": "Instance initialized."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "__enter__",
          "type": "Function",
          "tier": "TRIVIAL",
          "start_line": 34,
          "end_line": 41,
          "tags": {
            "TIER": "TRIVIAL",
            "PURPOSE": "Mock enter.",
            "PRE": "Instance initialized.",
            "POST": "Returns self."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "__exit__",
          "type": "Function",
          "tier": "TRIVIAL",
          "start_line": 43,
          "end_line": 50,
          "tags": {
            "TIER": "TRIVIAL",
            "PURPOSE": "Mock exit.",
            "PRE": "Context entered.",
            "POST": "Context exited."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "Tier",
          "type": "Class",
          "tier": "TRIVIAL",
          "start_line": 57,
          "end_line": 63,
          "tags": {
            "TIER": "TRIVIAL",
            "PURPOSE": "Enumeration of semantic tiers defining validation strictness."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "Severity",
          "type": "Class",
          "tier": "TRIVIAL",
          "start_line": 67,
          "end_line": 73,
          "tags": {
            "TIER": "TRIVIAL",
            "PURPOSE": "Severity levels for compliance issues."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "ComplianceIssue",
          "type": "Class",
          "tier": "TRIVIAL",
          "start_line": 119,
          "end_line": 134,
          "tags": {
            "TIER": "TRIVIAL",
            "PURPOSE": "Represents a single compliance issue with severity."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "SemanticEntity",
          "type": "Class",
          "tier": "CRITICAL",
          "start_line": 137,
          "end_line": 313,
          "tags": {
            "TIER": "CRITICAL",
            "PURPOSE": "Represents a code entity (Module, Function, Component) found during parsing.",
            "INVARIANT": "start_line is always set; end_line is set upon closure; tier defaults to STANDARD."
          },
          "relations": [],
          "children": [
            {
              "name": "__init__",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 142,
              "end_line": 165,
              "tags": {
                "TIER": "STANDARD",
                "PURPOSE": "Initializes a new SemanticEntity instance.",
                "PRE": "name, type_, start_line, file_path are provided.",
                "POST": "Instance is initialized with default values."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            },
            {
              "name": "get_tier",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 167,
              "end_line": 179,
              "tags": {
                "TIER": "STANDARD",
                "PURPOSE": "Returns the tier of the entity, defaulting to STANDARD.",
                "PRE": "tags dictionary is accessible.",
                "POST": "Returns Tier enum value."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            },
            {
              "name": "to_dict",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 181,
              "end_line": 210,
              "tags": {
                "TIER": "STANDARD",
                "PURPOSE": "Serializes the entity to a dictionary for JSON output.",
                "PRE": "Entity is fully populated.",
                "POST": "Returns a dictionary representation."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            },
            {
              "name": "validate",
              "type": "Function",
              "tier": "CRITICAL",
              "start_line": 212,
              "end_line": 276,
              "tags": {
                "TIER": "CRITICAL",
                "PURPOSE": "Checks for semantic compliance based on TIER requirements.",
                "PRE": "Entity structure is complete; tier is determined.",
                "POST": "Populates self.compliance_issues with severity levels.",
                "SIDE_EFFECT": "Modifies self.compliance_issues list."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            },
            {
              "name": "get_score",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 278,
              "end_line": 312,
              "tags": {
                "TIER": "STANDARD",
                "PURPOSE": "Calculates a compliance score (0.0 to 1.0) based on tier requirements.",
                "PRE": "validate() has been called.",
                "POST": "Returns a float score."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            }
          ],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "get_patterns",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 316,
          "end_line": 351,
          "tags": {
            "TIER": "STANDARD",
            "PURPOSE": "Returns regex patterns for a specific language.",
            "PRE": "lang is either 'python' or 'svelte_js'.",
            "POST": "Returns a dictionary of compiled regex patterns.",
            "PARAM": "lang (str) - 'python' or 'svelte_js'"
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "extract_svelte_props",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 354,
          "end_line": 380,
          "tags": {
            "TIER": "STANDARD",
            "PURPOSE": "Extracts props from Svelte component script section.",
            "PRE": "lines is a list of file lines, start_idx is the starting line index.",
            "POST": "Returns list of prop definitions."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "extract_svelte_events",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 383,
          "end_line": 417,
          "tags": {
            "TIER": "STANDARD",
            "PURPOSE": "Extracts dispatched events from Svelte component.",
            "PRE": "lines is a list of file lines.",
            "POST": "Returns list of event names."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "extract_data_flow",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 420,
          "end_line": 470,
          "tags": {
            "TIER": "STANDARD",
            "PURPOSE": "Extracts store subscriptions and data flow from Svelte component.",
            "PRE": "lines is a list of file lines.",
            "POST": "Returns list of data flow descriptors."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "parse_file",
          "type": "Function",
          "tier": "CRITICAL",
          "start_line": 473,
          "end_line": 660,
          "tags": {
            "TIER": "CRITICAL",
            "PURPOSE": "Parses a single file to extract semantic entities with tier awareness and enhanced Svelte analysis.",
            "PRE": "full_path, rel_path, lang are valid strings.",
            "POST": "Returns extracted entities and list of issues.",
            "INVARIANT": "Every opened anchor must have a matching closing anchor for valid compliance.",
            "PARAM": "lang - Language identifier."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "SemanticMapGenerator",
          "type": "Class",
          "tier": "CRITICAL",
          "start_line": 663,
          "end_line": 993,
          "tags": {
            "TIER": "CRITICAL",
            "PURPOSE": "Orchestrates the mapping process with tier-based validation.",
            "INVARIANT": "All entities are validated according to their TIER requirements."
          },
          "relations": [],
          "children": [
            {
              "name": "__init__",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 668,
              "end_line": 680,
              "tags": {
                "TIER": "STANDARD",
                "PURPOSE": "Initializes the generator with a root directory.",
                "PRE": "root_dir is a valid path string.",
                "POST": "Generator instance is ready."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            },
            {
              "name": "_load_gitignore",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 682,
              "end_line": 698,
              "tags": {
                "TIER": "STANDARD",
                "PURPOSE": "Loads patterns from .gitignore file.",
                "PRE": ".gitignore exists in root_dir.",
                "POST": "Returns set of ignore patterns."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            },
            {
              "name": "_is_ignored",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 700,
              "end_line": 734,
              "tags": {
                "TIER": "STANDARD",
                "PURPOSE": "Checks if a path should be ignored based on .gitignore or hardcoded defaults.",
                "PRE": "rel_path is a valid relative path string.",
                "POST": "Returns True if the path should be ignored."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            },
            {
              "name": "run",
              "type": "Function",
              "tier": "CRITICAL",
              "start_line": 736,
              "end_line": 749,
              "tags": {
                "TIER": "CRITICAL",
                "PURPOSE": "Main execution flow.",
                "PRE": "Generator is initialized.",
                "POST": "Semantic map and reports are generated."
              },
              "relations": [
                {
                  "type": "CALLS",
                  "target": "_walk_and_parse"
                },
                {
                  "type": "CALLS",
                  "target": "_generate_artifacts"
                }
              ],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            },
            {
              "name": "_walk_and_parse",
              "type": "Function",
              "tier": "CRITICAL",
              "start_line": 751,
              "end_line": 780,
              "tags": {
                "TIER": "CRITICAL",
                "PURPOSE": "Recursively walks directories and triggers parsing.",
                "PRE": "root_dir exists.",
                "POST": "All files are scanned and entities extracted."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            },
            {
              "name": "_process_file_results",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 782,
              "end_line": 811,
              "tags": {
                "TIER": "STANDARD",
                "PURPOSE": "Validates entities and calculates file scores with tier awareness.",
                "PRE": "Entities have been parsed from the file.",
                "POST": "File score is calculated and issues collected."
              },
              "relations": [],
              "children": [
                {
                  "name": "validate_recursive",
                  "type": "Function",
                  "tier": "STANDARD",
                  "start_line": 792,
                  "end_line": 805,
                  "tags": {
                    "TIER": "STANDARD",
                    "PURPOSE": "Recursively validates a list of entities.",
                    "PRE": "ent_list is a list of SemanticEntity objects.",
                    "POST": "All entities and their children are validated."
                  },
                  "relations": [],
                  "children": [],
                  "compliance": {
                    "valid": true,
                    "issues": [],
                    "score": 1.0
                  }
                }
              ],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            },
            {
              "name": "_generate_artifacts",
              "type": "Function",
              "tier": "CRITICAL",
              "start_line": 813,
              "end_line": 833,
              "tags": {
                "TIER": "CRITICAL",
                "PURPOSE": "Writes output files with tier-based compliance data.",
                "PRE": "Parsing and validation are complete.",
                "POST": "JSON and Markdown artifacts are written to disk."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            },
            {
              "name": "_generate_report",
              "type": "Function",
              "tier": "CRITICAL",
              "start_line": 835,
              "end_line": 888,
              "tags": {
                "TIER": "CRITICAL",
                "PURPOSE": "Generates the Markdown compliance report with severity levels.",
                "PRE": "File scores and issues are available.",
                "POST": "Markdown report is created in reports directory."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            },
            {
              "name": "_collect_issues",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 890,
              "end_line": 902,
              "tags": {
                "TIER": "STANDARD",
                "PURPOSE": "Helper to collect issues for a specific file from the entity tree.",
                "PRE": "entities list and file_path are valid.",
                "POST": "issues list is populated with compliance issues."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            },
            {
              "name": "_generate_compressed_map",
              "type": "Function",
              "tier": "CRITICAL",
              "start_line": 904,
              "end_line": 921,
              "tags": {
                "TIER": "CRITICAL",
                "PURPOSE": "Generates the token-optimized project map with enhanced Svelte details.",
                "PRE": "Entities have been processed.",
                "POST": "Markdown project map is written."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            },
            {
              "name": "_write_entity_md",
              "type": "Function",
              "tier": "CRITICAL",
              "start_line": 923,
              "end_line": 991,
              "tags": {
                "TIER": "CRITICAL",
                "PURPOSE": "Recursive helper to write entity tree to Markdown with tier badges and enhanced details.",
                "PRE": "f is an open file handle, entity is valid.",
                "POST": "Entity details are written to the file."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            }
          ],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "to_dict",
          "type": "Function",
          "tier": "TRIVIAL",
          "start_line": 128,
          "end_line": 128,
          "tags": {
            "PURPOSE": "Auto-detected function (orphan)",
            "TIER": "TRIVIAL"
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        }
      ],
      "compliance": {
        "valid": true,
        "issues": [],
        "score": 1.0
      }
    },
    {
      "name": "stores_module",
      "type": "Module",
      "tier": "STANDARD",
      "start_line": 1,
      "end_line": 70,
      "tags": {
        "SEMANTICS": "state, stores, svelte, plugins, tasks",
        "PURPOSE": "Global state management using Svelte stores.",
        "LAYER": "UI-State"
      },
      "relations": [],
      "children": [
        {
          "name": "plugins",
          "type": "Data",
          "tier": "STANDARD",
          "start_line": 9,
          "end_line": 12,
          "tags": {
            "PURPOSE": "Store for the list of available plugins."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "tasks",
          "type": "Data",
          "tier": "STANDARD",
          "start_line": 14,
          "end_line": 17,
          "tags": {
            "PURPOSE": "Store for the list of tasks."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "selectedPlugin",
          "type": "Data",
          "tier": "STANDARD",
          "start_line": 19,
          "end_line": 22,
          "tags": {
            "PURPOSE": "Store for the currently selected plugin."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "selectedTask",
          "type": "Data",
          "tier": "STANDARD",
          "start_line": 24,
          "end_line": 27,
          "tags": {
            "PURPOSE": "Store for the currently selected task."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "currentPage",
          "type": "Data",
          "tier": "STANDARD",
          "start_line": 29,
          "end_line": 32,
          "tags": {
            "PURPOSE": "Store for the current page."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "taskLogs",
          "type": "Data",
          "tier": "STANDARD",
          "start_line": 34,
          "end_line": 37,
          "tags": {
            "PURPOSE": "Store for the logs of the currently selected task."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "fetchPlugins",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 39,
          "end_line": 53,
          "tags": {
            "PURPOSE": "Fetches plugins from the API and updates the plugins store.",
            "PRE": "None.",
            "POST": "plugins store is updated with data from the API."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 39
              },
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 39
              }
            ],
            "score": 0.8
          }
        },
        {
          "name": "fetchTasks",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 55,
          "end_line": 69,
          "tags": {
            "PURPOSE": "Fetches tasks from the API and updates the tasks store.",
            "PRE": "None.",
            "POST": "tasks store is updated with data from the API."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 55
              },
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 55
              }
            ],
            "score": 0.8
          }
        }
      ],
      "compliance": {
        "valid": true,
        "issues": [
          {
            "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
            "severity": "WARNING",
            "line_number": 1
          }
        ],
        "score": 0.85
      }
    },
    {
      "name": "toasts_module",
      "type": "Module",
      "tier": "STANDARD",
      "start_line": 1,
      "end_line": 38,
      "tags": {
        "SEMANTICS": "notification, toast, feedback, state",
        "PURPOSE": "Manages toast notifications using a Svelte writable store.",
        "LAYER": "UI-State"
      },
      "relations": [],
      "children": [
        {
          "name": "toasts",
          "type": "Data",
          "tier": "STANDARD",
          "start_line": 8,
          "end_line": 11,
          "tags": {
            "PURPOSE": "Writable store containing the list of active toasts."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "addToast",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 13,
          "end_line": 26,
          "tags": {
            "PURPOSE": "Adds a new toast message.",
            "PRE": "message string is provided.",
            "POST": "New toast is added to the store and scheduled for removal.",
            "PARAM": "duration (number) - Duration in ms before the toast is removed."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 13
              },
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 13
              }
            ],
            "score": 0.8
          }
        },
        {
          "name": "removeToast",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 28,
          "end_line": 37,
          "tags": {
            "PURPOSE": "Removes a toast message by ID.",
            "PRE": "id is provided.",
            "POST": "Toast is removed from the store.",
            "PARAM": "id (string) - The ID of the toast to remove."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 28
              },
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 28
              }
            ],
            "score": 0.8
          }
        }
      ],
      "compliance": {
        "valid": true,
        "issues": [
          {
            "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
            "severity": "WARNING",
            "line_number": 1
          }
        ],
        "score": 0.85
      }
    },
    {
      "name": "api_module",
      "type": "Module",
      "tier": "STANDARD",
      "start_line": 1,
      "end_line": 170,
      "tags": {
        "SEMANTICS": "api, client, fetch, rest",
        "PURPOSE": "Handles all communication with the backend API.",
        "LAYER": "Infra-API"
      },
      "relations": [],
      "children": [
        {
          "name": "getWsUrl",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 11,
          "end_line": 26,
          "tags": {
            "PURPOSE": "Returns the WebSocket URL for a specific task, with fallback logic.",
            "PRE": "taskId is provided.",
            "POST": "Returns valid WebSocket URL string.",
            "PARAM": "taskId (string) - The ID of the task.",
            "RETURN": "string - The WebSocket URL."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 11
              },
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 11
              }
            ],
            "score": 0.8
          }
        },
        {
          "name": "getAuthHeaders",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 28,
          "end_line": 42,
          "tags": {
            "PURPOSE": "Returns headers with Authorization if token exists."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Mandatory Tag: @PRE (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 28
              },
              {
                "message": "Missing Mandatory Tag: @POST (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 28
              },
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 28
              },
              {
                "message": "Missing Mandatory Tag: @PRE (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 28
              },
              {
                "message": "Missing Mandatory Tag: @POST (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 28
              },
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 28
              }
            ],
            "score": 0.26666666666666655
          }
        },
        {
          "name": "fetchApi",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 44,
          "end_line": 72,
          "tags": {
            "PURPOSE": "Generic GET request wrapper.",
            "PRE": "endpoint string is provided.",
            "POST": "Returns Promise resolving to JSON data or throws on error.",
            "PARAM": "endpoint (string) - API endpoint.",
            "RETURN": "Promise<any> - JSON response."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 44
              },
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 44
              }
            ],
            "score": 0.8
          }
        },
        {
          "name": "postApi",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 74,
          "end_line": 105,
          "tags": {
            "PURPOSE": "Generic POST request wrapper.",
            "PRE": "endpoint and body are provided.",
            "POST": "Returns Promise resolving to JSON data or throws on error.",
            "PARAM": "body (object) - Request payload.",
            "RETURN": "Promise<any> - JSON response."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 74
              },
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 74
              }
            ],
            "score": 0.8
          }
        },
        {
          "name": "requestApi",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 107,
          "end_line": 142,
          "tags": {
            "PURPOSE": "Generic request wrapper.",
            "PRE": "endpoint and method are provided.",
            "POST": "Returns Promise resolving to JSON data or throws on error."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 107
              },
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 107
              }
            ],
            "score": 0.8
          }
        },
        {
          "name": "api",
          "type": "Data",
          "tier": "STANDARD",
          "start_line": 144,
          "end_line": 168,
          "tags": {
            "PURPOSE": "API client object with specific methods."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        }
      ],
      "compliance": {
        "valid": true,
        "issues": [
          {
            "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
            "severity": "WARNING",
            "line_number": 1
          }
        ],
        "score": 0.85
      }
    },
    {
      "name": "authStore",
      "type": "Store",
      "tier": "STANDARD",
      "start_line": 1,
      "end_line": 91,
      "tags": {
        "SEMANTICS": "auth, store, svelte, jwt, session",
        "PURPOSE": "Manages the global authentication state on the frontend.",
        "LAYER": "Feature"
      },
      "relations": [
        {
          "type": "MODIFIED_BY",
          "target": "handleLogin, handleLogout"
        },
        {
          "type": "BINDS_TO",
          "target": "Navbar, ProtectedRoute"
        }
      ],
      "children": [
        {
          "name": "AuthState",
          "type": "Interface",
          "tier": "STANDARD",
          "start_line": 11,
          "end_line": 21,
          "tags": {
            "PURPOSE": "Defines the structure of the authentication state."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "createAuthStore",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 30,
          "end_line": 87,
          "tags": {
            "PURPOSE": "Creates and configures the auth store with helper methods.",
            "RETURNS": "{Writable<AuthState>}"
          },
          "relations": [],
          "children": [
            {
              "name": "setToken",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 40,
              "end_line": 52,
              "tags": {
                "PURPOSE": "Updates the store with a new JWT token.",
                "PARAM": "{string} token - The JWT access token."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [
                  {
                    "message": "Missing Mandatory Tag: @PRE (required for STANDARD tier)",
                    "severity": "WARNING",
                    "line_number": 40
                  },
                  {
                    "message": "Missing Mandatory Tag: @POST (required for STANDARD tier)",
                    "severity": "WARNING",
                    "line_number": 40
                  },
                  {
                    "message": "Missing Mandatory Tag: @PRE (required for STANDARD tier)",
                    "severity": "WARNING",
                    "line_number": 40
                  },
                  {
                    "message": "Missing Mandatory Tag: @POST (required for STANDARD tier)",
                    "severity": "WARNING",
                    "line_number": 40
                  },
                  {
                    "message": "Missing Mandatory Tag: @PRE (required for STANDARD tier)",
                    "severity": "WARNING",
                    "line_number": 40
                  },
                  {
                    "message": "Missing Mandatory Tag: @POST (required for STANDARD tier)",
                    "severity": "WARNING",
                    "line_number": 40
                  }
                ],
                "score": 0.26666666666666655
              }
            },
            {
              "name": "setUser",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 53,
              "end_line": 62,
              "tags": {
                "PURPOSE": "Sets the current user profile data.",
                "PARAM": "{any} user - The user profile object."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [
                  {
                    "message": "Missing Mandatory Tag: @PRE (required for STANDARD tier)",
                    "severity": "WARNING",
                    "line_number": 53
                  },
                  {
                    "message": "Missing Mandatory Tag: @POST (required for STANDARD tier)",
                    "severity": "WARNING",
                    "line_number": 53
                  },
                  {
                    "message": "Missing Mandatory Tag: @PRE (required for STANDARD tier)",
                    "severity": "WARNING",
                    "line_number": 53
                  },
                  {
                    "message": "Missing Mandatory Tag: @POST (required for STANDARD tier)",
                    "severity": "WARNING",
                    "line_number": 53
                  },
                  {
                    "message": "Missing Mandatory Tag: @PRE (required for STANDARD tier)",
                    "severity": "WARNING",
                    "line_number": 53
                  },
                  {
                    "message": "Missing Mandatory Tag: @POST (required for STANDARD tier)",
                    "severity": "WARNING",
                    "line_number": 53
                  }
                ],
                "score": 0.26666666666666655
              }
            },
            {
              "name": "logout",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 63,
              "end_line": 74,
              "tags": {
                "PURPOSE": "Clears authentication state and storage."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [
                  {
                    "message": "Missing Mandatory Tag: @PRE (required for STANDARD tier)",
                    "severity": "WARNING",
                    "line_number": 63
                  },
                  {
                    "message": "Missing Mandatory Tag: @POST (required for STANDARD tier)",
                    "severity": "WARNING",
                    "line_number": 63
                  },
                  {
                    "message": "Missing Mandatory Tag: @PRE (required for STANDARD tier)",
                    "severity": "WARNING",
                    "line_number": 63
                  },
                  {
                    "message": "Missing Mandatory Tag: @POST (required for STANDARD tier)",
                    "severity": "WARNING",
                    "line_number": 63
                  },
                  {
                    "message": "Missing Mandatory Tag: @PRE (required for STANDARD tier)",
                    "severity": "WARNING",
                    "line_number": 63
                  },
                  {
                    "message": "Missing Mandatory Tag: @POST (required for STANDARD tier)",
                    "severity": "WARNING",
                    "line_number": 63
                  }
                ],
                "score": 0.26666666666666655
              }
            },
            {
              "name": "setLoading",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 75,
              "end_line": 84,
              "tags": {
                "PURPOSE": "Updates the loading state.",
                "PARAM": "{boolean} loading - Loading status."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [
                  {
                    "message": "Missing Mandatory Tag: @PRE (required for STANDARD tier)",
                    "severity": "WARNING",
                    "line_number": 75
                  },
                  {
                    "message": "Missing Mandatory Tag: @POST (required for STANDARD tier)",
                    "severity": "WARNING",
                    "line_number": 75
                  },
                  {
                    "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                    "severity": "WARNING",
                    "line_number": 75
                  },
                  {
                    "message": "Missing Mandatory Tag: @PRE (required for STANDARD tier)",
                    "severity": "WARNING",
                    "line_number": 75
                  },
                  {
                    "message": "Missing Mandatory Tag: @POST (required for STANDARD tier)",
                    "severity": "WARNING",
                    "line_number": 75
                  },
                  {
                    "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                    "severity": "WARNING",
                    "line_number": 75
                  },
                  {
                    "message": "Missing Mandatory Tag: @PRE (required for STANDARD tier)",
                    "severity": "WARNING",
                    "line_number": 75
                  },
                  {
                    "message": "Missing Mandatory Tag: @POST (required for STANDARD tier)",
                    "severity": "WARNING",
                    "line_number": 75
                  },
                  {
                    "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                    "severity": "WARNING",
                    "line_number": 75
                  }
                ],
                "score": 0.0
              }
            }
          ],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Mandatory Tag: @PRE (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 30
              },
              {
                "message": "Missing Mandatory Tag: @POST (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 30
              },
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 30
              },
              {
                "message": "Missing Mandatory Tag: @PRE (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 30
              },
              {
                "message": "Missing Mandatory Tag: @POST (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 30
              },
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 30
              }
            ],
            "score": 0.26666666666666655
          }
        }
      ],
      "compliance": {
        "valid": true,
        "issues": [],
        "score": 1.0
      }
    },
    {
      "name": "Select",
      "type": "Component",
      "tier": "STANDARD",
      "start_line": 1,
      "end_line": 40,
      "tags": {
        "SEMANTICS": "select, dropdown, form-field, ui-atom",
        "PURPOSE": "Standardized dropdown selection component.",
        "LAYER": "Atom"
      },
      "relations": [],
      "children": [],
      "compliance": {
        "valid": true,
        "issues": [
          {
            "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
            "severity": "WARNING",
            "line_number": 1
          }
        ],
        "score": 0.85
      },
      "props": [
        {
          "name": "label",
          "type": "string ",
          "default": "\"\""
        },
        {
          "name": "value",
          "type": "string | number ",
          "default": "\"\""
        },
        {
          "name": "disabled",
          "type": "boolean ",
          "default": "false"
        }
      ]
    },
    {
      "name": "ui",
      "type": "Module",
      "tier": "STANDARD",
      "start_line": 1,
      "end_line": 18,
      "tags": {
        "SEMANTICS": "ui, components, library, atomic-design",
        "PURPOSE": "Central export point for standardized UI components.",
        "LAYER": "Atom",
        "INVARIANT": "All components exported here must follow Semantic Protocol."
      },
      "relations": [],
      "children": [],
      "compliance": {
        "valid": true,
        "issues": [
          {
            "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
            "severity": "WARNING",
            "line_number": 1
          }
        ],
        "score": 0.85
      }
    },
    {
      "name": "PageHeader",
      "type": "Component",
      "tier": "STANDARD",
      "start_line": 1,
      "end_line": 26,
      "tags": {
        "SEMANTICS": "page-header, layout-atom",
        "PURPOSE": "Standardized page header with title and action area.",
        "LAYER": "Atom"
      },
      "relations": [],
      "children": [],
      "compliance": {
        "valid": true,
        "issues": [
          {
            "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
            "severity": "WARNING",
            "line_number": 1
          }
        ],
        "score": 0.85
      },
      "props": [
        {
          "name": "title",
          "type": "string ",
          "default": "\"\""
        }
      ]
    },
    {
      "name": "Card",
      "type": "Component",
      "tier": "STANDARD",
      "start_line": 1,
      "end_line": 35,
      "tags": {
        "SEMANTICS": "card, container, ui-atom",
        "PURPOSE": "Standardized container with padding and elevation.",
        "LAYER": "Atom"
      },
      "relations": [],
      "children": [],
      "compliance": {
        "valid": true,
        "issues": [
          {
            "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
            "severity": "WARNING",
            "line_number": 1
          }
        ],
        "score": 0.85
      },
      "props": [
        {
          "name": "title",
          "type": "string ",
          "default": "\"\""
        }
      ]
    },
    {
      "name": "Button",
      "type": "Component",
      "tier": "STANDARD",
      "start_line": 1,
      "end_line": 61,
      "tags": {
        "SEMANTICS": "button, ui-atom, interactive",
        "PURPOSE": "Define component interface and default values.",
        "LAYER": "Atom",
        "INVARIANT": "Supports accessible labels and keyboard navigation."
      },
      "relations": [],
      "children": [],
      "compliance": {
        "valid": true,
        "issues": [
          {
            "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
            "severity": "WARNING",
            "line_number": 1
          }
        ],
        "score": 0.85
      },
      "props": [
        {
          "name": "isLoading",
          "type": "boolean ",
          "default": "false"
        },
        {
          "name": "disabled",
          "type": "boolean ",
          "default": "false"
        }
      ]
    },
    {
      "name": "Input",
      "type": "Component",
      "tier": "STANDARD",
      "start_line": 1,
      "end_line": 46,
      "tags": {
        "SEMANTICS": "input, form-field, ui-atom",
        "PURPOSE": "Standardized text input component with label and error handling.",
        "LAYER": "Atom",
        "INVARIANT": "Consistent spacing and focus states."
      },
      "relations": [],
      "children": [],
      "compliance": {
        "valid": true,
        "issues": [
          {
            "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
            "severity": "WARNING",
            "line_number": 1
          }
        ],
        "score": 0.85
      },
      "props": [
        {
          "name": "label",
          "type": "string ",
          "default": "\"\""
        },
        {
          "name": "value",
          "type": "string ",
          "default": "\"\""
        },
        {
          "name": "placeholder",
          "type": "string ",
          "default": "\"\""
        },
        {
          "name": "error",
          "type": "string ",
          "default": "\"\""
        },
        {
          "name": "disabled",
          "type": "boolean ",
          "default": "false"
        }
      ]
    },
    {
      "name": "LanguageSwitcher",
      "type": "Component",
      "tier": "STANDARD",
      "start_line": 1,
      "end_line": 30,
      "tags": {
        "SEMANTICS": "language-switcher, i18n-ui, ui-atom",
        "PURPOSE": "Dropdown component to switch between supported languages.",
        "LAYER": "Atom",
        "RELATION": "BINDS_TO -> i18n.locale"
      },
      "relations": [],
      "children": [],
      "compliance": {
        "valid": true,
        "issues": [
          {
            "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
            "severity": "WARNING",
            "line_number": 1
          }
        ],
        "score": 0.85
      },
      "data_flow": [
        {
          "store": "lib",
          "type": "READS_FROM",
          "line": 11
        },
        {
          "store": "locale",
          "type": "WRITES_TO",
          "line": 24
        }
      ]
    },
    {
      "name": "i18n",
      "type": "Module",
      "tier": "STANDARD",
      "start_line": 1,
      "end_line": 56,
      "tags": {
        "SEMANTICS": "i18n, localization, svelte-store, translation",
        "PURPOSE": "Determines the starting locale.",
        "LAYER": "Infra",
        "INVARIANT": "Persistence is handled via LocalStorage.",
        "RETURNS": "{Locale}"
      },
      "relations": [
        {
          "type": "DEPENDS_ON",
          "target": "locales/ru.json"
        },
        {
          "type": "DEPENDS_ON",
          "target": "locales/en.json"
        }
      ],
      "children": [
        {
          "name": "locale",
          "type": "Store",
          "tier": "STANDARD",
          "start_line": 33,
          "end_line": 43,
          "tags": {
            "PURPOSE": "Holds the current active locale string."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "t",
          "type": "Store",
          "tier": "STANDARD",
          "start_line": 45,
          "end_line": 54,
          "tags": {
            "PURPOSE": "Derived store providing the translation dictionary.",
            "RELATION": "BINDS_TO -> locale"
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        }
      ],
      "compliance": {
        "valid": true,
        "issues": [
          {
            "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
            "severity": "WARNING",
            "line_number": 1
          }
        ],
        "score": 0.85
      }
    },
    {
      "name": "selectPlugin",
      "type": "Function",
      "tier": "STANDARD",
      "start_line": 19,
      "end_line": 32,
      "tags": {
        "PURPOSE": "Handles plugin selection and navigation.",
        "PRE": "plugin object must be provided.",
        "POST": "Navigates to migration or sets selectedPlugin store."
      },
      "relations": [],
      "children": [],
      "compliance": {
        "valid": true,
        "issues": [
          {
            "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
            "severity": "WARNING",
            "line_number": 19
          }
        ],
        "score": 0.9
      }
    },
    {
      "name": "handleFormSubmit",
      "type": "Function",
      "tier": "STANDARD",
      "start_line": 34,
      "end_line": 52,
      "tags": {
        "PURPOSE": "Handles task creation from dynamic form submission.",
        "PRE": "event.detail must contain task parameters.",
        "POST": "Task is created via API and selectedTask store is updated."
      },
      "relations": [],
      "children": [],
      "compliance": {
        "valid": true,
        "issues": [
          {
            "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
            "severity": "WARNING",
            "line_number": 34
          }
        ],
        "score": 0.9
      }
    },
    {
      "name": "load",
      "type": "Function",
      "tier": "STANDARD",
      "start_line": 3,
      "end_line": 23,
      "tags": {
        "PURPOSE": "Loads initial plugin data for the dashboard.",
        "PRE": "None.",
        "POST": "Returns an object with plugins or an error message.",
        "TYPE": "{import('./$types').PageLoad} */"
      },
      "relations": [],
      "children": [],
      "compliance": {
        "valid": true,
        "issues": [
          {
            "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
            "severity": "WARNING",
            "line_number": 3
          }
        ],
        "score": 0.9
      }
    },
    {
      "name": "TaskManagementPage",
      "type": "Component",
      "tier": "STANDARD",
      "start_line": 1,
      "end_line": 176,
      "tags": {
        "SEMANTICS": "tasks, management, history, logs",
        "PURPOSE": "Page for managing and monitoring tasks.",
        "LAYER": "Page",
        "RELATION": "USES -> TaskLogViewer"
      },
      "relations": [],
      "children": [
        {
          "name": "loadInitialData",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 26,
          "end_line": 49,
          "tags": {
            "PURPOSE": "Loads tasks and environments on page initialization.",
            "PRE": "API must be reachable.",
            "POST": "tasks and environments variables are populated."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "refreshTasks",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 51,
          "end_line": 68,
          "tags": {
            "PURPOSE": "Periodically refreshes the task list.",
            "PRE": "API must be reachable.",
            "POST": "tasks variable is updated if data is valid."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 51
              },
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 51
              }
            ],
            "score": 0.8
          }
        },
        {
          "name": "handleSelectTask",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 70,
          "end_line": 80,
          "tags": {
            "PURPOSE": "Updates the selected task ID when a task is clicked.",
            "PRE": "event.detail.id must be provided.",
            "POST": "selectedTaskId is updated."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 70
              },
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 70
              }
            ],
            "score": 0.8
          }
        },
        {
          "name": "handleRunBackup",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 82,
          "end_line": 106,
          "tags": {
            "PURPOSE": "Triggers a manual backup task for the selected environment.",
            "PRE": "selectedEnvId must not be empty.",
            "POST": "Backup task is created and task list is refreshed."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 82
              },
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 82
              }
            ],
            "score": 0.8
          }
        }
      ],
      "compliance": {
        "valid": true,
        "issues": [
          {
            "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
            "severity": "WARNING",
            "line_number": 1
          }
        ],
        "score": 0.85
      },
      "data_flow": [
        {
          "store": "lib",
          "type": "READS_FROM",
          "line": 15
        },
        {
          "store": "lib",
          "type": "READS_FROM",
          "line": 16
        },
        {
          "store": "t",
          "type": "WRITES_TO",
          "line": 119
        },
        {
          "store": "t",
          "type": "WRITES_TO",
          "line": 123
        },
        {
          "store": "t",
          "type": "WRITES_TO",
          "line": 128
        },
        {
          "store": "t",
          "type": "READS_FROM",
          "line": 141
        },
        {
          "store": "t",
          "type": "WRITES_TO",
          "line": 151
        },
        {
          "store": "t",
          "type": "WRITES_TO",
          "line": 154
        },
        {
          "store": "t",
          "type": "READS_FROM",
          "line": 157
        },
        {
          "store": "t",
          "type": "READS_FROM",
          "line": 164
        }
      ]
    },
    {
      "name": "LoginPage",
      "type": "Component",
      "tier": "STANDARD",
      "start_line": 1,
      "end_line": 161,
      "tags": {
        "TIER": "STANDARD",
        "SEMANTICS": "login, auth, ui, form",
        "PURPOSE": "Provides the user interface for local and ADFS authentication.",
        "LAYER": "UI",
        "RELATION": "CALLS -> api.auth.login",
        "INVARIANT": "Shows both local login form and ADFS SSO button."
      },
      "relations": [],
      "children": [
        {
          "name": "handleLogin",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 24,
          "end_line": 75,
          "tags": {
            "PURPOSE": "Submits the local login form to the backend.",
            "PRE": "Username and password are not empty.",
            "POST": "User is authenticated and redirected on success."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 24
              },
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 24
              }
            ],
            "score": 0.8
          }
        },
        {
          "name": "handleADFSLogin",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 77,
          "end_line": 84,
          "tags": {
            "PURPOSE": "Redirects the user to the ADFS login endpoint."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Mandatory Tag: @PRE (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 77
              },
              {
                "message": "Missing Mandatory Tag: @POST (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 77
              },
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 77
              },
              {
                "message": "Missing Mandatory Tag: @PRE (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 77
              },
              {
                "message": "Missing Mandatory Tag: @POST (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 77
              },
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 77
              }
            ],
            "score": 0.26666666666666655
          }
        }
      ],
      "compliance": {
        "valid": true,
        "issues": [],
        "score": 1.0
      },
      "data_flow": [
        {
          "store": "app",
          "type": "READS_FROM",
          "line": 17
        },
        {
          "store": "auth",
          "type": "READS_FROM",
          "line": 87
        }
      ]
    },
    {
      "name": "AdminRolesPage",
      "type": "Component",
      "tier": "STANDARD",
      "start_line": 1,
      "end_line": 236,
      "tags": {
        "TIER": "STANDARD",
        "SEMANTICS": "admin, role-management, rbac",
        "PURPOSE": "UI for managing system roles and their permissions.",
        "LAYER": "Domain",
        "RELATION": "DEPENDS_ON -> frontend.src.components.auth.ProtectedRoute",
        "INVARIANT": "Only accessible by users with Admin role."
      },
      "relations": [],
      "children": [
        {
          "name": "loadData",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 35,
          "end_line": 57,
          "tags": {
            "PURPOSE": "Fetches roles and available permissions.",
            "PRE": "Component mounted.",
            "POST": "roles and permissions arrays populated."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "openCreateModal",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 59,
          "end_line": 72,
          "tags": {
            "PURPOSE": "Initializes state for creating a new role.",
            "PRE": "None.",
            "POST": "showModal is true, roleForm is reset."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "openEditModal",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 74,
          "end_line": 91,
          "tags": {
            "PURPOSE": "Initializes state for editing an existing role.",
            "PRE": "role object is provided.",
            "POST": "showModal is true, roleForm is populated."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 74
              },
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 74
              }
            ],
            "score": 0.8
          }
        },
        {
          "name": "handleSaveRole",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 93,
          "end_line": 115,
          "tags": {
            "PURPOSE": "Submits role data (create or update).",
            "PRE": "roleForm contains valid data.",
            "POST": "Role is saved, modal closed, data reloaded."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "handleDeleteRole",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 117,
          "end_line": 136,
          "tags": {
            "PURPOSE": "Deletes a role after confirmation.",
            "PRE": "role object is provided.",
            "POST": "Role is deleted if confirmed, data reloaded."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        }
      ],
      "compliance": {
        "valid": true,
        "issues": [],
        "score": 1.0
      },
      "data_flow": [
        {
          "store": "lib",
          "type": "READS_FROM",
          "line": 16
        },
        {
          "store": "t",
          "type": "READS_FROM",
          "line": 124
        },
        {
          "store": "t",
          "type": "WRITES_TO",
          "line": 145
        },
        {
          "store": "t",
          "type": "READS_FROM",
          "line": 150
        },
        {
          "store": "t",
          "type": "READS_FROM",
          "line": 155
        },
        {
          "store": "t",
          "type": "WRITES_TO",
          "line": 163
        },
        {
          "store": "t",
          "type": "WRITES_TO",
          "line": 164
        },
        {
          "store": "t",
          "type": "WRITES_TO",
          "line": 165
        },
        {
          "store": "t",
          "type": "WRITES_TO",
          "line": 166
        },
        {
          "store": "t",
          "type": "WRITES_TO",
          "line": 184
        },
        {
          "store": "t",
          "type": "WRITES_TO",
          "line": 185
        },
        {
          "store": "t",
          "type": "READS_FROM",
          "line": 198
        },
        {
          "store": "t",
          "type": "READS_FROM",
          "line": 198
        },
        {
          "store": "t",
          "type": "WRITES_TO",
          "line": 202
        },
        {
          "store": "t",
          "type": "WRITES_TO",
          "line": 206
        },
        {
          "store": "t",
          "type": "WRITES_TO",
          "line": 210
        },
        {
          "store": "t",
          "type": "WRITES_TO",
          "line": 219
        },
        {
          "store": "t",
          "type": "WRITES_TO",
          "line": 222
        },
        {
          "store": "t",
          "type": "WRITES_TO",
          "line": 223
        }
      ]
    },
    {
      "name": "AdminUsersPage",
      "type": "Component",
      "tier": "STANDARD",
      "start_line": 1,
      "end_line": 284,
      "tags": {
        "SEMANTICS": "admin, user-management, rbac",
        "PURPOSE": "UI for managing system users and their roles.",
        "LAYER": "Feature",
        "RELATION": "DEPENDS_ON -> frontend.src.components.auth.ProtectedRoute",
        "INVARIANT": "Only accessible by users with \"admin:users\" permission."
      },
      "relations": [],
      "children": [
        {
          "name": "loadData",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 37,
          "end_line": 59,
          "tags": {
            "PURPOSE": "Fetches users and roles from the backend.",
            "PRE": "Component mounted.",
            "POST": "users and roles arrays populated."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "openCreateModal",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 61,
          "end_line": 72,
          "tags": {
            "PURPOSE": "Prepares the form for creating a new user.",
            "POST": "showModal is true, isEditing is false, userForm is reset."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Mandatory Tag: @PRE (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 61
              },
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 61
              },
              {
                "message": "Missing Mandatory Tag: @PRE (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 61
              },
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 61
              }
            ],
            "score": 0.5333333333333333
          }
        },
        {
          "name": "openEditModal",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 74,
          "end_line": 93,
          "tags": {
            "PURPOSE": "Prepares the form for editing an existing user.",
            "PRE": "user object must be valid.",
            "POST": "showModal is true, isEditing is true, userForm populated with user data.",
            "PARAM": "{Object} user - The user object to edit."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 74
              },
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 74
              }
            ],
            "score": 0.8
          }
        },
        {
          "name": "handleSaveUser",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 95,
          "end_line": 122,
          "tags": {
            "PURPOSE": "Submits user data to the backend (create or update).",
            "PRE": "userForm must be valid.",
            "POST": "User created or updated, modal closed, data reloaded.",
            "RELATION": "CALLS -> adminService.updateUser"
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "handleDeleteUser",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 124,
          "end_line": 150,
          "tags": {
            "PURPOSE": "Deletes a user after confirmation.",
            "PRE": "user object must be valid.",
            "POST": "User deleted if confirmed, data reloaded.",
            "RELATION": "CALLS -> adminService.deleteUser",
            "PARAM": "{Object} user - The user to delete."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        }
      ],
      "compliance": {
        "valid": true,
        "issues": [
          {
            "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
            "severity": "WARNING",
            "line_number": 1
          }
        ],
        "score": 0.85
      },
      "data_flow": [
        {
          "store": "lib",
          "type": "READS_FROM",
          "line": 15
        },
        {
          "store": "t",
          "type": "READS_FROM",
          "line": 135
        },
        {
          "store": "t",
          "type": "WRITES_TO",
          "line": 159
        },
        {
          "store": "t",
          "type": "READS_FROM",
          "line": 164
        },
        {
          "store": "t",
          "type": "WRITES_TO",
          "line": 170
        },
        {
          "store": "t",
          "type": "WRITES_TO",
          "line": 174
        },
        {
          "store": "t",
          "type": "WRITES_TO",
          "line": 182
        },
        {
          "store": "t",
          "type": "WRITES_TO",
          "line": 183
        },
        {
          "store": "t",
          "type": "WRITES_TO",
          "line": 184
        },
        {
          "store": "t",
          "type": "WRITES_TO",
          "line": 185
        },
        {
          "store": "t",
          "type": "WRITES_TO",
          "line": 186
        },
        {
          "store": "t",
          "type": "WRITES_TO",
          "line": 187
        },
        {
          "store": "t",
          "type": "READS_FROM",
          "line": 211
        },
        {
          "store": "t",
          "type": "READS_FROM",
          "line": 211
        },
        {
          "store": "t",
          "type": "WRITES_TO",
          "line": 216
        },
        {
          "store": "t",
          "type": "WRITES_TO",
          "line": 222
        },
        {
          "store": "t",
          "type": "WRITES_TO",
          "line": 222
        },
        {
          "store": "t",
          "type": "READS_FROM",
          "line": 236
        },
        {
          "store": "t",
          "type": "READS_FROM",
          "line": 236
        },
        {
          "store": "t",
          "type": "WRITES_TO",
          "line": 240
        },
        {
          "store": "t",
          "type": "WRITES_TO",
          "line": 244
        },
        {
          "store": "t",
          "type": "WRITES_TO",
          "line": 248
        },
        {
          "store": "t",
          "type": "WRITES_TO",
          "line": 251
        },
        {
          "store": "t",
          "type": "WRITES_TO",
          "line": 257
        },
        {
          "store": "t",
          "type": "WRITES_TO",
          "line": 261
        },
        {
          "store": "t",
          "type": "WRITES_TO",
          "line": 267
        },
        {
          "store": "t",
          "type": "WRITES_TO",
          "line": 270
        },
        {
          "store": "t",
          "type": "WRITES_TO",
          "line": 271
        }
      ]
    },
    {
      "name": "AdminSettingsPage",
      "type": "Component",
      "tier": "STANDARD",
      "start_line": 1,
      "end_line": 213,
      "tags": {
        "SEMANTICS": "admin, adfs, mappings, configuration",
        "PURPOSE": "UI for configuring Active Directory Group to local Role mappings for ADFS SSO.",
        "LAYER": "Feature",
        "RELATION": "DEPENDS_ON -> frontend.src.components.auth.ProtectedRoute",
        "INVARIANT": "Only accessible by users with \"admin:settings\" permission."
      },
      "relations": [],
      "children": [
        {
          "name": "loadData",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 31,
          "end_line": 62,
          "tags": {
            "PURPOSE": "Fetches AD mappings and roles from the backend to populate the UI.",
            "PRE": "Component is mounted and user has active session.",
            "POST": "mappings and roles variables are updated with backend data.",
            "RETURNS": "{Promise<void>}",
            "RELATION": "CALLS -> adminService.getADGroupMappings"
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "handleCreateMapping",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 64,
          "end_line": 94,
          "tags": {
            "PURPOSE": "Submits a new AD Group to Role mapping to the backend.",
            "PRE": "'newMapping' object contains valid 'ad_group' and 'role_id'.",
            "POST": "A new mapping is created in the database and the table is refreshed.",
            "RETURNS": "{Promise<void>}",
            "RELATION": "CALLS -> adminService.createADGroupMapping"
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        }
      ],
      "compliance": {
        "valid": true,
        "issues": [
          {
            "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
            "severity": "WARNING",
            "line_number": 1
          }
        ],
        "score": 0.85
      },
      "data_flow": [
        {
          "store": "lib",
          "type": "READS_FROM",
          "line": 15
        },
        {
          "store": "t",
          "type": "WRITES_TO",
          "line": 103
        },
        {
          "store": "t",
          "type": "READS_FROM",
          "line": 108
        },
        {
          "store": "t",
          "type": "WRITES_TO",
          "line": 114
        },
        {
          "store": "t",
          "type": "WRITES_TO",
          "line": 118
        },
        {
          "store": "t",
          "type": "WRITES_TO",
          "line": 126
        },
        {
          "store": "t",
          "type": "WRITES_TO",
          "line": 127
        },
        {
          "store": "t",
          "type": "READS_FROM",
          "line": 148
        },
        {
          "store": "t",
          "type": "WRITES_TO",
          "line": 161
        },
        {
          "store": "t",
          "type": "WRITES_TO",
          "line": 164
        },
        {
          "store": "t",
          "type": "WRITES_TO",
          "line": 172
        },
        {
          "store": "t",
          "type": "WRITES_TO",
          "line": 175
        },
        {
          "store": "t",
          "type": "WRITES_TO",
          "line": 181
        },
        {
          "store": "t",
          "type": "READS_FROM",
          "line": 193
        },
        {
          "store": "t",
          "type": "READS_FROM",
          "line": 199
        }
      ]
    },
    {
      "name": "LLMSettingsPage",
      "type": "Component",
      "tier": "STANDARD",
      "start_line": 1,
      "end_line": 48,
      "tags": {
        "TIER": "STANDARD",
        "PURPOSE": "Admin settings page for LLM provider configuration.",
        "LAYER": "UI",
        "RELATION": "CALLS -> frontend/src/components/llm/ProviderConfig.svelte"
      },
      "relations": [],
      "children": [],
      "compliance": {
        "valid": true,
        "issues": [
          {
            "message": "Missing Mandatory Tag: @SEMANTICS (required for STANDARD tier)",
            "severity": "WARNING",
            "line_number": 1
          }
        ],
        "score": 0.85
      }
    },
    {
      "name": "+page",
      "type": "Module",
      "tier": "TRIVIAL",
      "start_line": 1,
      "end_line": 48,
      "tags": {
        "PURPOSE": "Auto-generated module for frontend/src/routes/admin/settings/llm/+page.svelte",
        "TIER": "TRIVIAL",
        "LAYER": "Unknown"
      },
      "relations": [],
      "children": [
        {
          "name": "fetchProviders",
          "type": "Function",
          "tier": "TRIVIAL",
          "start_line": 17,
          "end_line": 17,
          "tags": {
            "PURPOSE": "Auto-detected function (orphan)",
            "TIER": "TRIVIAL"
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        }
      ],
      "compliance": {
        "valid": true,
        "issues": [],
        "score": 1.0
      }
    },
    {
      "name": "MigrationDashboard",
      "type": "Component",
      "tier": "STANDARD",
      "start_line": 1,
      "end_line": 391,
      "tags": {
        "SEMANTICS": "migration, dashboard, environment, selection, database-replacement",
        "PURPOSE": "Main dashboard for configuring and starting migrations.",
        "LAYER": "Page",
        "RELATION": "USES -> EnvSelector",
        "INVARIANT": "Migration cannot start without source and target environments."
      },
      "relations": [],
      "children": [
        {
          "name": "fetchEnvironments",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 54,
          "end_line": 69,
          "tags": {
            "PURPOSE": "Fetches the list of environments from the API.",
            "PRE": "None.",
            "POST": "environments state is updated."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 54
              },
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 54
              }
            ],
            "score": 0.8
          }
        },
        {
          "name": "fetchDashboards",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 71,
          "end_line": 87,
          "tags": {
            "PURPOSE": "Fetches dashboards for the selected source environment.",
            "PRE": "envId is a valid environment ID.",
            "PARAM": "envId The environment ID.",
            "POST": "dashboards state is updated."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 71
              },
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 71
              }
            ],
            "score": 0.8
          }
        },
        {
          "name": "fetchDatabases",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 94,
          "end_line": 123,
          "tags": {
            "PURPOSE": "Fetches databases from both environments and gets suggestions.",
            "PRE": "sourceEnvId and targetEnvId must be set.",
            "POST": "sourceDatabases, targetDatabases, mappings, and suggestions are updated."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 94
              },
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 94
              }
            ],
            "score": 0.8
          }
        },
        {
          "name": "handleMappingUpdate",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 125,
          "end_line": 153,
          "tags": {
            "PURPOSE": "Saves a mapping to the backend.",
            "PRE": "event.detail contains sourceUuid and targetUuid.",
            "POST": "Mapping is saved and local mappings list is updated."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 125
              },
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 125
              }
            ],
            "score": 0.8
          }
        },
        {
          "name": "handleViewLogs",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 155,
          "end_line": 165,
          "tags": {
            "PURPOSE": "Opens the log viewer for a specific task.",
            "PRE": "event.detail contains task object.",
            "POST": "logViewer state updated and showLogViewer set to true."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 155
              },
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 155
              }
            ],
            "score": 0.8
          }
        },
        {
          "name": "handlePasswordPrompt",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 167,
          "end_line": 189,
          "tags": {
            "PURPOSE": "Reactive logic to show password prompt when a task is awaiting input.",
            "PRE": "selectedTask status is AWAITING_INPUT.",
            "POST": "showPasswordPrompt set to true with request data."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 167
              },
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 167
              }
            ],
            "score": 0.8
          }
        },
        {
          "name": "handleResumeMigration",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 191,
          "end_line": 209,
          "tags": {
            "PURPOSE": "Resumes a migration task with provided passwords.",
            "PRE": "event.detail contains passwords.",
            "POST": "resumeTask is called and showPasswordPrompt is hidden on success."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 191
              },
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 191
              }
            ],
            "score": 0.8
          }
        },
        {
          "name": "startMigration",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 211,
          "end_line": 266,
          "tags": {
            "PURPOSE": "Starts the migration process.",
            "PRE": "sourceEnvId and targetEnvId must be set and different.",
            "POST": "Migration task is started and selectedTask is updated."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 211
              },
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 211
              }
            ],
            "score": 0.8
          }
        },
        {
          "name": "DashboardSelectionSection",
          "type": "Component",
          "tier": "STANDARD",
          "start_line": 306,
          "end_line": 320,
          "tags": {},
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Mandatory Tag: @PURPOSE (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 306
              },
              {
                "message": "Missing Mandatory Tag: @LAYER (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 306
              },
              {
                "message": "Missing Mandatory Tag: @SEMANTICS (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 306
              },
              {
                "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 306
              },
              {
                "message": "Missing Mandatory Tag: @PURPOSE (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 306
              },
              {
                "message": "Missing Mandatory Tag: @LAYER (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 306
              },
              {
                "message": "Missing Mandatory Tag: @SEMANTICS (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 306
              },
              {
                "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 306
              }
            ],
            "score": 0.0
          }
        }
      ],
      "compliance": {
        "valid": true,
        "issues": [
          {
            "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
            "severity": "WARNING",
            "line_number": 1
          }
        ],
        "score": 0.85
      },
      "data_flow": [
        {
          "store": "lib",
          "type": "READS_FROM",
          "line": 25
        },
        {
          "store": "lib",
          "type": "READS_FROM",
          "line": 26
        },
        {
          "store": "selectedTask",
          "type": "READS_FROM",
          "line": 176
        },
        {
          "store": "selectedTask",
          "type": "READS_FROM",
          "line": 176
        },
        {
          "store": "selectedTask",
          "type": "READS_FROM",
          "line": 176
        },
        {
          "store": "selectedTask",
          "type": "WRITES_TO",
          "line": 177
        },
        {
          "store": "selectedTask",
          "type": "READS_FROM",
          "line": 183
        },
        {
          "store": "selectedTask",
          "type": "READS_FROM",
          "line": 183
        },
        {
          "store": "selectedTask",
          "type": "READS_FROM",
          "line": 196
        },
        {
          "store": "selectedTask",
          "type": "READS_FROM",
          "line": 200
        },
        {
          "store": "t",
          "type": "WRITES_TO",
          "line": 271
        },
        {
          "store": "selectedTask",
          "type": "READS_FROM",
          "line": 275
        },
        {
          "store": "t",
          "type": "READS_FROM",
          "line": 280
        }
      ]
    },
    {
      "name": "MappingManagement",
      "type": "Component",
      "tier": "STANDARD",
      "start_line": 1,
      "end_line": 180,
      "tags": {
        "SEMANTICS": "mapping, management, database, fuzzy-matching",
        "PURPOSE": "Page for managing database mappings between environments.",
        "LAYER": "Page",
        "RELATION": "USES -> MappingTable",
        "INVARIANT": "Mappings are saved to the backend for persistence."
      },
      "relations": [],
      "children": [
        {
          "name": "fetchEnvironments",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 36,
          "end_line": 49,
          "tags": {
            "PURPOSE": "Fetches the list of environments.",
            "PRE": "None.",
            "POST": "environments array is populated."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 36
              },
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 36
              }
            ],
            "score": 0.8
          }
        },
        {
          "name": "fetchDatabases",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 53,
          "end_line": 83,
          "tags": {
            "PURPOSE": "Fetches databases from both environments and gets suggestions.",
            "PRE": "sourceEnvId and targetEnvId must be set.",
            "POST": "sourceDatabases, targetDatabases, mappings, and suggestions are updated."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 53
              },
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 53
              }
            ],
            "score": 0.8
          }
        },
        {
          "name": "handleUpdate",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 85,
          "end_line": 114,
          "tags": {
            "PURPOSE": "Saves a mapping to the backend.",
            "PRE": "event.detail contains sourceUuid and targetUuid.",
            "POST": "Mapping is saved and local mappings list is updated."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 85
              },
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 85
              }
            ],
            "score": 0.8
          }
        }
      ],
      "compliance": {
        "valid": true,
        "issues": [
          {
            "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
            "severity": "WARNING",
            "line_number": 1
          }
        ],
        "score": 0.85
      },
      "data_flow": [
        {
          "store": "lib",
          "type": "READS_FROM",
          "line": 18
        },
        {
          "store": "lib",
          "type": "READS_FROM",
          "line": 19
        }
      ]
    },
    {
      "name": "StoragePage",
      "type": "Component",
      "tier": "STANDARD",
      "start_line": 1,
      "end_line": 213,
      "tags": {
        "TIER": "STANDARD",
        "SEMANTICS": "storage, files, management",
        "PURPOSE": "Main page for file storage management.",
        "LAYER": "UI",
        "RELATION": "CONTAINS -> FileUpload",
        "INVARIANT": "Always displays tabs for Backups and Repositories."
      },
      "relations": [],
      "children": [
        {
          "name": "loadFiles",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 25,
          "end_line": 60,
          "tags": {
            "PURPOSE": "Fetches the list of files from the server.",
            "POST": "Updates the `files` array with the latest data."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Mandatory Tag: @PRE (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 25
              },
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 25
              },
              {
                "message": "Missing Mandatory Tag: @PRE (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 25
              },
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 25
              }
            ],
            "score": 0.5333333333333333
          }
        },
        {
          "name": "handleDelete",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 62,
          "end_line": 79,
          "tags": {
            "PURPOSE": "Handles the file deletion process.",
            "PARAM": "{CustomEvent} event - The delete event containing category and path."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Mandatory Tag: @PRE (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 62
              },
              {
                "message": "Missing Mandatory Tag: @POST (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 62
              },
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 62
              },
              {
                "message": "Missing Mandatory Tag: @PRE (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 62
              },
              {
                "message": "Missing Mandatory Tag: @POST (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 62
              },
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 62
              }
            ],
            "score": 0.26666666666666655
          }
        },
        {
          "name": "handleNavigate",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 81,
          "end_line": 90,
          "tags": {
            "PURPOSE": "Updates the current path and reloads files when navigating into a directory.",
            "PARAM": "{CustomEvent} event - The navigation event containing the new path."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Mandatory Tag: @PRE (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 81
              },
              {
                "message": "Missing Mandatory Tag: @POST (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 81
              },
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 81
              },
              {
                "message": "Missing Mandatory Tag: @PRE (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 81
              },
              {
                "message": "Missing Mandatory Tag: @POST (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 81
              },
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 81
              }
            ],
            "score": 0.26666666666666655
          }
        },
        {
          "name": "navigateUp",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 92,
          "end_line": 105,
          "tags": {
            "PURPOSE": "Navigates one level up in the directory structure.",
            "PRE": "currentPath is set and deeper than activeTab root.",
            "POST": "currentPath is moved up one directory level."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 92
              },
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 92
              }
            ],
            "score": 0.8
          }
        }
      ],
      "compliance": {
        "valid": true,
        "issues": [],
        "score": 1.0
      },
      "data_flow": [
        {
          "store": "app",
          "type": "READS_FROM",
          "line": 17
        },
        {
          "store": "t",
          "type": "READS_FROM",
          "line": 55
        },
        {
          "store": "t",
          "type": "READS_FROM",
          "line": 69
        },
        {
          "store": "t",
          "type": "READS_FROM",
          "line": 73
        },
        {
          "store": "t",
          "type": "READS_FROM",
          "line": 76
        },
        {
          "store": "page",
          "type": "WRITES_TO",
          "line": 108
        },
        {
          "store": "t",
          "type": "WRITES_TO",
          "line": 132
        },
        {
          "store": "t",
          "type": "WRITES_TO",
          "line": 135
        },
        {
          "store": "t",
          "type": "READS_FROM",
          "line": 155
        },
        {
          "store": "t",
          "type": "READS_FROM",
          "line": 155
        },
        {
          "store": "t",
          "type": "READS_FROM",
          "line": 169
        },
        {
          "store": "t",
          "type": "READS_FROM",
          "line": 175
        }
      ]
    },
    {
      "name": "MapperPage",
      "type": "Component",
      "tier": "STANDARD",
      "start_line": 1,
      "end_line": 25,
      "tags": {
        "SEMANTICS": "mapper, page, tool",
        "PURPOSE": "Page for the dataset column mapper tool.",
        "LAYER": "UI"
      },
      "relations": [],
      "children": [],
      "compliance": {
        "valid": true,
        "issues": [
          {
            "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
            "severity": "WARNING",
            "line_number": 1
          }
        ],
        "score": 0.85
      },
      "data_flow": [
        {
          "store": "lib",
          "type": "READS_FROM",
          "line": 10
        }
      ]
    },
    {
      "name": "DebugPage",
      "type": "Component",
      "tier": "STANDARD",
      "start_line": 1,
      "end_line": 25,
      "tags": {
        "SEMANTICS": "debug, page, tool",
        "PURPOSE": "Page for system diagnostics and debugging.",
        "LAYER": "UI"
      },
      "relations": [],
      "children": [],
      "compliance": {
        "valid": true,
        "issues": [
          {
            "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
            "severity": "WARNING",
            "line_number": 1
          }
        ],
        "score": 0.85
      },
      "data_flow": [
        {
          "store": "lib",
          "type": "READS_FROM",
          "line": 10
        }
      ]
    },
    {
      "name": "handleSaveGlobal",
      "type": "Function",
      "tier": "STANDARD",
      "start_line": 46,
      "end_line": 62,
      "tags": {
        "PURPOSE": "Saves global application settings.",
        "PRE": "settings.settings must contain valid configuration.",
        "POST": "Global settings are updated via API."
      },
      "relations": [],
      "children": [],
      "compliance": {
        "valid": true,
        "issues": [
          {
            "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
            "severity": "WARNING",
            "line_number": 46
          }
        ],
        "score": 0.9
      }
    },
    {
      "name": "handleSaveStorage",
      "type": "Function",
      "tier": "STANDARD",
      "start_line": 64,
      "end_line": 80,
      "tags": {
        "PURPOSE": "Saves storage-specific settings.",
        "PRE": "settings.settings.storage must contain valid configuration.",
        "POST": "Storage settings are updated via API."
      },
      "relations": [],
      "children": [],
      "compliance": {
        "valid": true,
        "issues": [
          {
            "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
            "severity": "WARNING",
            "line_number": 64
          }
        ],
        "score": 0.9
      }
    },
    {
      "name": "handleAddOrUpdateEnv",
      "type": "Function",
      "tier": "STANDARD",
      "start_line": 82,
      "end_line": 108,
      "tags": {
        "PURPOSE": "Adds a new environment or updates an existing one.",
        "PRE": "newEnv must contain valid environment details.",
        "POST": "Environment is saved and page is reloaded to reflect changes."
      },
      "relations": [],
      "children": [],
      "compliance": {
        "valid": true,
        "issues": [
          {
            "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
            "severity": "WARNING",
            "line_number": 82
          }
        ],
        "score": 0.9
      }
    },
    {
      "name": "handleDeleteEnv",
      "type": "Function",
      "tier": "STANDARD",
      "start_line": 110,
      "end_line": 129,
      "tags": {
        "PURPOSE": "Deletes a Superset environment.",
        "PRE": "id must be a valid environment ID.",
        "POST": "Environment is removed and page is reloaded."
      },
      "relations": [],
      "children": [],
      "compliance": {
        "valid": true,
        "issues": [
          {
            "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
            "severity": "WARNING",
            "line_number": 110
          }
        ],
        "score": 0.9
      }
    },
    {
      "name": "handleTestEnv",
      "type": "Function",
      "tier": "STANDARD",
      "start_line": 131,
      "end_line": 152,
      "tags": {
        "PURPOSE": "Tests the connection to a Superset environment.",
        "PRE": "id must be a valid environment ID.",
        "POST": "Displays success or error toast based on connection result."
      },
      "relations": [],
      "children": [],
      "compliance": {
        "valid": true,
        "issues": [
          {
            "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
            "severity": "WARNING",
            "line_number": 131
          }
        ],
        "score": 0.9
      }
    },
    {
      "name": "editEnv",
      "type": "Function",
      "tier": "STANDARD",
      "start_line": 154,
      "end_line": 163,
      "tags": {
        "PURPOSE": "Populates the environment form for editing.",
        "PRE": "env object must be provided.",
        "POST": "newEnv and editingEnvId are updated."
      },
      "relations": [],
      "children": [],
      "compliance": {
        "valid": true,
        "issues": [
          {
            "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
            "severity": "WARNING",
            "line_number": 154
          }
        ],
        "score": 0.9
      }
    },
    {
      "name": "resetEnvForm",
      "type": "Function",
      "tier": "STANDARD",
      "start_line": 165,
      "end_line": 181,
      "tags": {
        "PURPOSE": "Resets the environment creation/edit form to default state.",
        "PRE": "None.",
        "POST": "newEnv is cleared and editingEnvId is set to null."
      },
      "relations": [],
      "children": [],
      "compliance": {
        "valid": true,
        "issues": [
          {
            "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
            "severity": "WARNING",
            "line_number": 165
          }
        ],
        "score": 0.9
      }
    },
    {
      "name": "load",
      "type": "Function",
      "tier": "STANDARD",
      "start_line": 3,
      "end_line": 34,
      "tags": {
        "PURPOSE": "Loads application settings and environment list.",
        "PRE": "API must be reachable.",
        "POST": "Returns settings object or default values on error.",
        "TYPE": "{import('./$types').PageLoad} */"
      },
      "relations": [],
      "children": [],
      "compliance": {
        "valid": true,
        "issues": [
          {
            "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
            "severity": "WARNING",
            "line_number": 3
          }
        ],
        "score": 0.9
      }
    },
    {
      "name": "ConnectionsSettingsPage",
      "type": "Component",
      "tier": "STANDARD",
      "start_line": 1,
      "end_line": 40,
      "tags": {
        "SEMANTICS": "settings, connections, page",
        "PURPOSE": "Page for managing database connection configurations.",
        "LAYER": "UI"
      },
      "relations": [],
      "children": [
        {
          "name": "handleSuccess",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 13,
          "end_line": 23,
          "tags": {
            "PURPOSE": "Refreshes the connection list after a successful creation.",
            "PRE": "listComponent must be bound.",
            "POST": "Triggers the fetchConnections method on the list component."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 13
              },
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 13
              }
            ],
            "score": 0.8
          }
        }
      ],
      "compliance": {
        "valid": true,
        "issues": [
          {
            "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
            "severity": "WARNING",
            "line_number": 1
          }
        ],
        "score": 0.85
      }
    },
    {
      "name": "GitSettingsPage",
      "type": "Component",
      "tier": "STANDARD",
      "start_line": 1,
      "end_line": 182,
      "tags": {
        "SEMANTICS": "git, settings, configuration, integration",
        "PURPOSE": "Manage Git server configurations for dashboard versioning.",
        "LAYER": "Page",
        "RELATION": "USES -> Button, Input, Card, PageHeader, Select",
        "INVARIANT": "All configurations must be validated via connection test."
      },
      "relations": [],
      "children": [
        {
          "name": "loadConfigs",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 33,
          "end_line": 46,
          "tags": {
            "PURPOSE": "Fetches existing git configurations.",
            "PRE": "Component is mounted.",
            "POST": "configs state is populated."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 33
              },
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 33
              }
            ],
            "score": 0.8
          }
        },
        {
          "name": "handleTest",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 50,
          "end_line": 71,
          "tags": {
            "PURPOSE": "Tests connection to a git server with current form data.",
            "PRE": "newConfig contains valid provider, url, and pat.",
            "POST": "testing state is managed; toast shown with result."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 50
              },
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 50
              }
            ],
            "score": 0.8
          }
        },
        {
          "name": "handleSave",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 73,
          "end_line": 89,
          "tags": {
            "PURPOSE": "Saves a new git configuration.",
            "PRE": "newConfig is valid and tested.",
            "POST": "New config is saved to DB and added to configs list."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 73
              },
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 73
              }
            ],
            "score": 0.8
          }
        },
        {
          "name": "handleDelete",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 91,
          "end_line": 108,
          "tags": {
            "PURPOSE": "Deletes a git configuration by ID.",
            "PARAM": "{string} id - Configuration ID.",
            "PRE": "id is valid; user confirmed deletion.",
            "POST": "Configuration is removed from DB and local state."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 91
              },
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 91
              }
            ],
            "score": 0.8
          }
        }
      ],
      "compliance": {
        "valid": true,
        "issues": [
          {
            "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
            "severity": "WARNING",
            "line_number": 1
          }
        ],
        "score": 0.85
      },
      "data_flow": [
        {
          "store": "lib",
          "type": "READS_FROM",
          "line": 17
        },
        {
          "store": "lib",
          "type": "READS_FROM",
          "line": 18
        }
      ]
    },
    {
      "name": "GitDashboardPage",
      "type": "Component",
      "tier": "STANDARD",
      "start_line": 1,
      "end_line": 93,
      "tags": {
        "PURPOSE": "Dashboard management page for Git integration.",
        "LAYER": "Page",
        "SEMANTICS": "git, dashboard, management, ui"
      },
      "relations": [],
      "children": [
        {
          "name": "fetchEnvironments",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 22,
          "end_line": 38,
          "tags": {
            "PURPOSE": "Fetches the list of deployment environments from the API.",
            "PRE": "Component is mounted.",
            "POST": "`environments` array is populated with data from /api/environments."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 22
              },
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 22
              }
            ],
            "score": 0.8
          }
        },
        {
          "name": "fetchDashboards",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 40,
          "end_line": 56,
          "tags": {
            "PURPOSE": "Fetches dashboards for a specific environment.",
            "PRE": "`envId` is a valid environment ID.",
            "POST": "`dashboards` array is updated with results from the environment."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 40
              },
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 40
              }
            ],
            "score": 0.8
          }
        }
      ],
      "compliance": {
        "valid": true,
        "issues": [
          {
            "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
            "severity": "WARNING",
            "line_number": 1
          }
        ],
        "score": 0.85
      },
      "data_flow": [
        {
          "store": "lib",
          "type": "READS_FROM",
          "line": 13
        },
        {
          "store": "lib",
          "type": "READS_FROM",
          "line": 14
        }
      ]
    },
    {
      "name": "Dashboard",
      "type": "Component",
      "tier": "STANDARD",
      "start_line": 1,
      "end_line": 64,
      "tags": {
        "SEMANTICS": "dashboard, plugins, tools, list",
        "PURPOSE": "Displays the list of available plugins and allows selecting one.",
        "LAYER": "UI",
        "RELATION": "DEPENDS_ON -> frontend/src/lib/stores.js",
        "PROPS": "None",
        "EVENTS": "None"
      },
      "relations": [],
      "children": [
        {
          "name": "onMount",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 17,
          "end_line": 27,
          "tags": {
            "PURPOSE": "Fetch plugins when the component mounts.",
            "PRE": "Component is mounting.",
            "POST": "plugins store is populated with available tools."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "selectPlugin",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 29,
          "end_line": 40,
          "tags": {
            "PURPOSE": "Selects a plugin to display its form.",
            "PRE": "plugin object is provided.",
            "POST": "selectedPlugin store is updated.",
            "PARAM": "{Object} plugin - The plugin object to select."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 29
              },
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 29
              }
            ],
            "score": 0.8
          }
        }
      ],
      "compliance": {
        "valid": true,
        "issues": [
          {
            "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
            "severity": "WARNING",
            "line_number": 1
          }
        ],
        "score": 0.85
      },
      "data_flow": [
        {
          "store": "plugins",
          "type": "READS_FROM",
          "line": 47
        }
      ]
    },
    {
      "name": "Settings",
      "type": "Component",
      "tier": "STANDARD",
      "start_line": 1,
      "end_line": 340,
      "tags": {
        "SEMANTICS": "settings, ui, configuration",
        "PURPOSE": "The main settings page for the application, allowing management of environments and global settings.",
        "LAYER": "UI",
        "RELATION": "USES -> stores.js",
        "PROPS": "None",
        "EVENTS": "None",
        "INVARIANT": "Settings changes must be saved to the backend."
      },
      "relations": [],
      "children": [
        {
          "name": "loadSettings",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 49,
          "end_line": 66,
          "tags": {
            "PURPOSE": "Loads settings from the backend.",
            "PRE": "Component mounted or refresh requested.",
            "POST": "settings object is populated with backend data."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 49
              },
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 49
              }
            ],
            "score": 0.8
          }
        },
        {
          "name": "handleSaveGlobal",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 68,
          "end_line": 85,
          "tags": {
            "PURPOSE": "Saves global settings to the backend.",
            "PRE": "settings.settings contains valid configuration.",
            "POST": "Backend global settings are updated."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 68
              },
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 68
              }
            ],
            "score": 0.8
          }
        },
        {
          "name": "handleAddOrUpdateEnv",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 87,
          "end_line": 111,
          "tags": {
            "PURPOSE": "Adds or updates an environment.",
            "PRE": "newEnv contains valid environment details.",
            "POST": "Environment list is updated on backend and reloaded locally."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 87
              },
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 87
              }
            ],
            "score": 0.8
          }
        },
        {
          "name": "handleDeleteEnv",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 113,
          "end_line": 134,
          "tags": {
            "PURPOSE": "Deletes an environment.",
            "PRE": "id of environment to delete is provided.",
            "POST": "Environment is removed from backend and list is reloaded.",
            "PARAM": "{string} id - The ID of the environment to delete."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 113
              },
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 113
              }
            ],
            "score": 0.8
          }
        },
        {
          "name": "handleTestEnv",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 136,
          "end_line": 159,
          "tags": {
            "PURPOSE": "Tests the connection to an environment.",
            "PRE": "Environment ID is valid.",
            "POST": "Connection test result is displayed via toast.",
            "PARAM": "{string} id - The ID of the environment to test."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 136
              },
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 136
              }
            ],
            "score": 0.8
          }
        },
        {
          "name": "editEnv",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 161,
          "end_line": 172,
          "tags": {
            "PURPOSE": "Sets the form to edit an existing environment.",
            "PRE": "env object is provided.",
            "POST": "newEnv is populated with env data and editingEnvId is set.",
            "PARAM": "{Object} env - The environment object to edit."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 161
              },
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 161
              }
            ],
            "score": 0.8
          }
        },
        {
          "name": "resetEnvForm",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 174,
          "end_line": 195,
          "tags": {
            "PURPOSE": "Resets the environment form.",
            "PRE": "None.",
            "POST": "newEnv is reset to initial state and editingEnvId is cleared."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 174
              },
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 174
              }
            ],
            "score": 0.8
          }
        }
      ],
      "compliance": {
        "valid": true,
        "issues": [
          {
            "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
            "severity": "WARNING",
            "line_number": 1
          }
        ],
        "score": 0.85
      }
    },
    {
      "name": "getConnections",
      "type": "Function",
      "tier": "STANDARD",
      "start_line": 9,
      "end_line": 21,
      "tags": {
        "PURPOSE": "Fetch a list of saved connections.",
        "PRE": "None.",
        "POST": "Returns a promise resolving to an array of connections.",
        "RETURNS": "{Promise<Array>} List of connections."
      },
      "relations": [],
      "children": [],
      "compliance": {
        "valid": true,
        "issues": [
          {
            "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
            "severity": "WARNING",
            "line_number": 9
          }
        ],
        "score": 0.9
      }
    },
    {
      "name": "createConnection",
      "type": "Function",
      "tier": "STANDARD",
      "start_line": 23,
      "end_line": 36,
      "tags": {
        "PURPOSE": "Create a new connection configuration.",
        "PRE": "connectionData must be a valid object.",
        "POST": "Returns a promise resolving to the created connection.",
        "PARAM": "{Object} connectionData - The connection data.",
        "RETURNS": "{Promise<Object>} The created connection instance."
      },
      "relations": [],
      "children": [],
      "compliance": {
        "valid": true,
        "issues": [
          {
            "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
            "severity": "WARNING",
            "line_number": 23
          }
        ],
        "score": 0.9
      }
    },
    {
      "name": "deleteConnection",
      "type": "Function",
      "tier": "STANDARD",
      "start_line": 38,
      "end_line": 50,
      "tags": {
        "PURPOSE": "Delete a connection configuration.",
        "PRE": "connectionId must be a valid string.",
        "POST": "Returns a promise that resolves when deletion is complete.",
        "PARAM": "{string} connectionId - The ID of the connection to delete."
      },
      "relations": [],
      "children": [],
      "compliance": {
        "valid": true,
        "issues": [
          {
            "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
            "severity": "WARNING",
            "line_number": 38
          }
        ],
        "score": 0.9
      }
    },
    {
      "name": "GitServiceClient",
      "type": "Module",
      "tier": "STANDARD",
      "start_line": 1,
      "end_line": 258,
      "tags": {
        "SEMANTICS": "git, service, api, client",
        "PURPOSE": "API client for Git operations, managing the communication between frontend and backend.",
        "LAYER": "Service",
        "RELATION": "DEPENDS_ON -> specs/011-git-integration-dashboard/contracts/api.md"
      },
      "relations": [],
      "children": [
        {
          "name": "gitService",
          "type": "Action",
          "tier": "STANDARD",
          "start_line": 13,
          "end_line": 256,
          "tags": {
            "PURPOSE": "Retrieves the diff for specific files or the whole repository.",
            "PRE": "dashboardId must be a valid integer.",
            "POST": "Returns the Git diff string.",
            "RETURNS": "{Promise<string>} The diff content.",
            "PARAM": "{boolean} staged - Whether to show staged changes."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        }
      ],
      "compliance": {
        "valid": true,
        "issues": [
          {
            "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
            "severity": "WARNING",
            "line_number": 1
          }
        ],
        "score": 0.85
      }
    },
    {
      "name": "runTask",
      "type": "Function",
      "tier": "STANDARD",
      "start_line": 9,
      "end_line": 23,
      "tags": {
        "PURPOSE": "Start a new task for a given plugin.",
        "PRE": "pluginId and params must be provided.",
        "POST": "Returns a promise resolving to the task instance.",
        "PARAM": "{Object} params - Parameters for the plugin.",
        "RETURNS": "{Promise<Object>} The created task instance."
      },
      "relations": [],
      "children": [],
      "compliance": {
        "valid": true,
        "issues": [
          {
            "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
            "severity": "WARNING",
            "line_number": 9
          }
        ],
        "score": 0.9
      }
    },
    {
      "name": "getTaskStatus",
      "type": "Function",
      "tier": "STANDARD",
      "start_line": 25,
      "end_line": 38,
      "tags": {
        "PURPOSE": "Fetch details for a specific task (to poll status or get result).",
        "PRE": "taskId must be provided.",
        "POST": "Returns a promise resolving to task details.",
        "PARAM": "{string} taskId - The ID of the task.",
        "RETURNS": "{Promise<Object>} Task details."
      },
      "relations": [],
      "children": [],
      "compliance": {
        "valid": true,
        "issues": [
          {
            "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
            "severity": "WARNING",
            "line_number": 25
          }
        ],
        "score": 0.9
      }
    },
    {
      "name": "adminService",
      "type": "Module",
      "tier": "STANDARD",
      "start_line": 1,
      "end_line": 241,
      "tags": {
        "TIER": "STANDARD",
        "SEMANTICS": "admin, users, roles, ad-mappings, api",
        "PURPOSE": "Service for Admin-related API calls (User and Role management).",
        "LAYER": "Service",
        "INVARIANT": "All requests must include valid Admin JWT token (handled by api client)."
      },
      "relations": [
        {
          "type": "DEPENDS_ON",
          "target": "frontend.src.lib.api"
        }
      ],
      "children": [
        {
          "name": "getUsers",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 15,
          "end_line": 34,
          "tags": {
            "PURPOSE": "Fetches all registered users from the backend.",
            "PRE": "User must be authenticated with Admin privileges.",
            "POST": "Returns an array of user objects.",
            "RETURNS": "{Promise<Array>}",
            "RELATION": "CALLS -> backend.src.api.routes.admin.list_users"
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "createUser",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 36,
          "end_line": 56,
          "tags": {
            "PURPOSE": "Creates a new local user.",
            "PRE": "User must be authenticated with Admin privileges.",
            "PARAM": "{Object} userData - User details (username, email, password, roles, is_active).",
            "POST": "New user record created in auth.db.",
            "RETURNS": "{Promise<Object>}",
            "RELATION": "CALLS -> backend.src.api.routes.admin.create_user"
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "getRoles",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 58,
          "end_line": 75,
          "tags": {
            "PURPOSE": "Fetches all available system roles.",
            "RETURNS": "{Promise<Array>}",
            "RELATION": "CALLS -> backend.src.api.routes.admin.list_roles"
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Mandatory Tag: @PRE (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 58
              },
              {
                "message": "Missing Mandatory Tag: @POST (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 58
              },
              {
                "message": "Missing Mandatory Tag: @PRE (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 58
              },
              {
                "message": "Missing Mandatory Tag: @POST (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 58
              }
            ],
            "score": 0.4666666666666666
          }
        },
        {
          "name": "getADGroupMappings",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 77,
          "end_line": 93,
          "tags": {
            "PURPOSE": "Fetches mappings between AD groups and local roles.",
            "RETURNS": "{Promise<Array>}"
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Mandatory Tag: @PRE (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 77
              },
              {
                "message": "Missing Mandatory Tag: @POST (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 77
              },
              {
                "message": "Missing Mandatory Tag: @PRE (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 77
              },
              {
                "message": "Missing Mandatory Tag: @POST (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 77
              }
            ],
            "score": 0.4666666666666666
          }
        },
        {
          "name": "createADGroupMapping",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 95,
          "end_line": 112,
          "tags": {
            "PURPOSE": "Creates or updates an AD group to Role mapping.",
            "PARAM": "{Object} mappingData - Mapping details (ad_group, role_id).",
            "RETURNS": "{Promise<Object>}"
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Mandatory Tag: @PRE (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 95
              },
              {
                "message": "Missing Mandatory Tag: @POST (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 95
              },
              {
                "message": "Missing Mandatory Tag: @PRE (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 95
              },
              {
                "message": "Missing Mandatory Tag: @POST (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 95
              }
            ],
            "score": 0.4666666666666666
          }
        },
        {
          "name": "updateUser",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 114,
          "end_line": 132,
          "tags": {
            "PURPOSE": "Updates an existing user.",
            "PARAM": "{Object} userData - Updated user data.",
            "RETURNS": "{Promise<Object>}"
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Mandatory Tag: @PRE (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 114
              },
              {
                "message": "Missing Mandatory Tag: @POST (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 114
              },
              {
                "message": "Missing Mandatory Tag: @PRE (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 114
              },
              {
                "message": "Missing Mandatory Tag: @POST (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 114
              }
            ],
            "score": 0.4666666666666666
          }
        },
        {
          "name": "deleteUser",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 134,
          "end_line": 150,
          "tags": {
            "PURPOSE": "Deletes a user.",
            "PARAM": "{string} userId - Target user ID.",
            "RETURNS": "{Promise<void>}"
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Mandatory Tag: @PRE (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 134
              },
              {
                "message": "Missing Mandatory Tag: @POST (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 134
              },
              {
                "message": "Missing Mandatory Tag: @PRE (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 134
              },
              {
                "message": "Missing Mandatory Tag: @POST (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 134
              }
            ],
            "score": 0.4666666666666666
          }
        },
        {
          "name": "createRole",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 152,
          "end_line": 169,
          "tags": {
            "PURPOSE": "Creates a new role.",
            "PARAM": "{Object} roleData - Role details (name, description, permissions).",
            "RETURNS": "{Promise<Object>}"
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Mandatory Tag: @PRE (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 152
              },
              {
                "message": "Missing Mandatory Tag: @POST (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 152
              },
              {
                "message": "Missing Mandatory Tag: @PRE (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 152
              },
              {
                "message": "Missing Mandatory Tag: @POST (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 152
              }
            ],
            "score": 0.4666666666666666
          }
        },
        {
          "name": "updateRole",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 171,
          "end_line": 189,
          "tags": {
            "PURPOSE": "Updates an existing role.",
            "PARAM": "{Object} roleData - Updated role data.",
            "RETURNS": "{Promise<Object>}"
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Mandatory Tag: @PRE (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 171
              },
              {
                "message": "Missing Mandatory Tag: @POST (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 171
              },
              {
                "message": "Missing Mandatory Tag: @PRE (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 171
              },
              {
                "message": "Missing Mandatory Tag: @POST (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 171
              }
            ],
            "score": 0.4666666666666666
          }
        },
        {
          "name": "deleteRole",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 191,
          "end_line": 207,
          "tags": {
            "PURPOSE": "Deletes a role.",
            "PARAM": "{string} roleId - Target role ID.",
            "RETURNS": "{Promise<void>}"
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Mandatory Tag: @PRE (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 191
              },
              {
                "message": "Missing Mandatory Tag: @POST (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 191
              },
              {
                "message": "Missing Mandatory Tag: @PRE (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 191
              },
              {
                "message": "Missing Mandatory Tag: @POST (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 191
              }
            ],
            "score": 0.4666666666666666
          }
        },
        {
          "name": "getPermissions",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 209,
          "end_line": 225,
          "tags": {
            "PURPOSE": "Fetches all available permissions.",
            "RETURNS": "{Promise<Array>}"
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Mandatory Tag: @PRE (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 209
              },
              {
                "message": "Missing Mandatory Tag: @POST (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 209
              },
              {
                "message": "Missing Mandatory Tag: @PRE (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 209
              },
              {
                "message": "Missing Mandatory Tag: @POST (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 209
              }
            ],
            "score": 0.4666666666666666
          }
        }
      ],
      "compliance": {
        "valid": true,
        "issues": [],
        "score": 1.0
      }
    },
    {
      "name": "getTasks",
      "type": "Function",
      "tier": "STANDARD",
      "start_line": 9,
      "end_line": 32,
      "tags": {
        "PURPOSE": "Fetch a list of tasks with pagination and optional status filter.",
        "PRE": "limit and offset are numbers.",
        "POST": "Returns a promise resolving to a list of tasks.",
        "PARAM": "{string|null} status - Filter by task status (optional).",
        "RETURNS": "{Promise<Array>} List of tasks."
      },
      "relations": [],
      "children": [],
      "compliance": {
        "valid": true,
        "issues": [
          {
            "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
            "severity": "WARNING",
            "line_number": 9
          }
        ],
        "score": 0.9
      }
    },
    {
      "name": "getTask",
      "type": "Function",
      "tier": "STANDARD",
      "start_line": 34,
      "end_line": 47,
      "tags": {
        "PURPOSE": "Fetch details for a specific task.",
        "PRE": "taskId must be provided.",
        "POST": "Returns a promise resolving to task details.",
        "PARAM": "{string} taskId - The ID of the task.",
        "RETURNS": "{Promise<Object>} Task details."
      },
      "relations": [],
      "children": [],
      "compliance": {
        "valid": true,
        "issues": [
          {
            "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
            "severity": "WARNING",
            "line_number": 34
          }
        ],
        "score": 0.9
      }
    },
    {
      "name": "getTaskLogs",
      "type": "Function",
      "tier": "STANDARD",
      "start_line": 49,
      "end_line": 69,
      "tags": {
        "PURPOSE": "Fetch logs for a specific task.",
        "PRE": "taskId must be provided.",
        "POST": "Returns a promise resolving to a list of log entries.",
        "PARAM": "{string} taskId - The ID of the task.",
        "RETURNS": "{Promise<Array>} List of log entries."
      },
      "relations": [],
      "children": [],
      "compliance": {
        "valid": true,
        "issues": [
          {
            "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
            "severity": "WARNING",
            "line_number": 49
          }
        ],
        "score": 0.9
      }
    },
    {
      "name": "resumeTask",
      "type": "Function",
      "tier": "STANDARD",
      "start_line": 71,
      "end_line": 85,
      "tags": {
        "PURPOSE": "Resume a task that is awaiting input (e.g., passwords).",
        "PRE": "taskId and passwords must be provided.",
        "POST": "Returns a promise resolving to the updated task object.",
        "PARAM": "{Object} passwords - Map of database names to passwords.",
        "RETURNS": "{Promise<Object>} Updated task object."
      },
      "relations": [],
      "children": [],
      "compliance": {
        "valid": true,
        "issues": [
          {
            "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
            "severity": "WARNING",
            "line_number": 71
          }
        ],
        "score": 0.9
      }
    },
    {
      "name": "resolveTask",
      "type": "Function",
      "tier": "STANDARD",
      "start_line": 87,
      "end_line": 101,
      "tags": {
        "PURPOSE": "Resolve a task that is awaiting mapping.",
        "PRE": "taskId and resolutionParams must be provided.",
        "POST": "Returns a promise resolving to the updated task object.",
        "PARAM": "{Object} resolutionParams - Resolution parameters.",
        "RETURNS": "{Promise<Object>} Updated task object."
      },
      "relations": [],
      "children": [],
      "compliance": {
        "valid": true,
        "issues": [
          {
            "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
            "severity": "WARNING",
            "line_number": 87
          }
        ],
        "score": 0.9
      }
    },
    {
      "name": "clearTasks",
      "type": "Function",
      "tier": "STANDARD",
      "start_line": 103,
      "end_line": 120,
      "tags": {
        "PURPOSE": "Clear tasks based on status.",
        "PRE": "status is a string or null.",
        "POST": "Returns a promise that resolves when tasks are cleared.",
        "PARAM": "{string|null} status - Filter by task status (optional)."
      },
      "relations": [],
      "children": [],
      "compliance": {
        "valid": true,
        "issues": [
          {
            "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
            "severity": "WARNING",
            "line_number": 103
          }
        ],
        "score": 0.9
      }
    },
    {
      "name": "storageService",
      "type": "Module",
      "tier": "STANDARD",
      "start_line": 1,
      "end_line": 109,
      "tags": {
        "PURPOSE": "Frontend API client for file storage management.",
        "LAYER": "Service",
        "RELATION": "DEPENDS_ON -> backend.api.storage",
        "SEMANTICS": "storage, api, client"
      },
      "relations": [],
      "children": [
        {
          "name": "listFiles",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 11,
          "end_line": 34,
          "tags": {
            "PURPOSE": "Fetches the list of files for a given category and subpath.",
            "PARAM": "{string} [path] - Optional subpath filter.",
            "RETURNS": "{Promise<Array>}",
            "PRE": "category and path should be valid strings if provided.",
            "POST": "Returns a promise resolving to an array of StoredFile objects."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 11
              },
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 11
              }
            ],
            "score": 0.8
          }
        },
        {
          "name": "uploadFile",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 36,
          "end_line": 65,
          "tags": {
            "PURPOSE": "Uploads a file to the storage system.",
            "PARAM": "{string} [path] - Target subpath.",
            "RETURNS": "{Promise<Object>}",
            "PRE": "file must be a valid File object; category must be specified.",
            "POST": "Returns a promise resolving to the metadata of the uploaded file."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 36
              },
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 36
              }
            ],
            "score": 0.8
          }
        },
        {
          "name": "deleteFile",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 67,
          "end_line": 86,
          "tags": {
            "PURPOSE": "Deletes a file or directory from storage.",
            "PARAM": "{string} path - Relative path of the item.",
            "RETURNS": "{Promise<void>}",
            "PRE": "category and path must identify an existing file or directory.",
            "POST": "The specified file or directory is removed from storage."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 67
              },
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 67
              }
            ],
            "score": 0.8
          }
        },
        {
          "name": "downloadFileUrl",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 88,
          "end_line": 100,
          "tags": {
            "PURPOSE": "Returns the URL for downloading a file.",
            "PARAM": "{string} path - Relative path of the file.",
            "RETURNS": "{string}",
            "PRE": "category and path must identify an existing file.",
            "POST": "Returns a valid API URL for file download."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 88
              },
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 88
              }
            ],
            "score": 0.8
          }
        }
      ],
      "compliance": {
        "valid": true,
        "issues": [
          {
            "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
            "severity": "WARNING",
            "line_number": 1
          }
        ],
        "score": 0.85
      }
    },
    {
      "name": "PasswordPrompt",
      "type": "Component",
      "tier": "STANDARD",
      "start_line": 1,
      "end_line": 133,
      "tags": {
        "SEMANTICS": "password, prompt, modal, input, security",
        "PURPOSE": "A modal component to prompt the user for database passwords when a migration task is paused.",
        "LAYER": "UI",
        "RELATION": "EMITS -> resume, cancel"
      },
      "relations": [],
      "children": [
        {
          "name": "handleSubmit",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 21,
          "end_line": 39,
          "tags": {
            "PURPOSE": "Validates and dispatches the passwords to resume the task.",
            "PRE": "All database passwords must be entered.",
            "POST": "'resume' event is dispatched with passwords."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 21
              },
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 21
              }
            ],
            "score": 0.8
          }
        },
        {
          "name": "handleCancel",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 41,
          "end_line": 49,
          "tags": {
            "PURPOSE": "Cancels the password prompt.",
            "PRE": "Modal is open.",
            "POST": "'cancel' event is dispatched and show is set to false."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 41
              },
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 41
              }
            ],
            "score": 0.8
          }
        }
      ],
      "compliance": {
        "valid": true,
        "issues": [
          {
            "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
            "severity": "WARNING",
            "line_number": 1
          }
        ],
        "score": 0.85
      },
      "props": [
        {
          "name": "show",
          "type": "any",
          "default": "false"
        },
        {
          "name": "databases",
          "type": "any",
          "default": "[]"
        },
        {
          "name": "errorMessage",
          "type": "any",
          "default": "\"\""
        }
      ],
      "events": [
        "cancel",
        "resume"
      ]
    },
    {
      "name": "MappingTable",
      "type": "Component",
      "tier": "STANDARD",
      "start_line": 1,
      "end_line": 98,
      "tags": {
        "SEMANTICS": "mapping, table, database, editor",
        "PURPOSE": "Displays and allows editing of database mappings.",
        "LAYER": "Feature",
        "RELATION": "BINDS_TO -> mappings state",
        "INVARIANT": "Each source database can be mapped to one target database."
      },
      "relations": [],
      "children": [
        {
          "name": "updateMapping",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 25,
          "end_line": 34,
          "tags": {
            "PURPOSE": "Updates a mapping for a specific source database.",
            "PRE": "sourceUuid and targetUuid are provided.",
            "POST": "'update' event is dispatched."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 25
              },
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 25
              }
            ],
            "score": 0.8
          }
        },
        {
          "name": "getSuggestion",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 36,
          "end_line": 45,
          "tags": {
            "PURPOSE": "Finds a suggestion for a source database.",
            "PRE": "sourceUuid is provided.",
            "POST": "Returns matching suggestion object or undefined."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 36
              },
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 36
              }
            ],
            "score": 0.8
          }
        }
      ],
      "compliance": {
        "valid": true,
        "issues": [
          {
            "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
            "severity": "WARNING",
            "line_number": 1
          }
        ],
        "score": 0.85
      },
      "events": [
        "update"
      ]
    },
    {
      "name": "TaskLogViewer",
      "type": "Component",
      "tier": "STANDARD",
      "start_line": 1,
      "end_line": 244,
      "tags": {
        "SEMANTICS": "task, log, viewer, modal, inline",
        "PURPOSE": "Displays detailed logs for a specific task in a modal or inline.",
        "LAYER": "UI",
        "RELATION": "USES -> frontend/src/services/taskService.js"
      },
      "relations": [],
      "children": [
        {
          "name": "fetchLogs",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 30,
          "end_line": 53,
          "tags": {
            "PURPOSE": "Fetches logs for the current task.",
            "PRE": "taskId must be set.",
            "POST": "logs array is updated with data from taskService."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 30
              },
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 30
              }
            ],
            "score": 0.8
          }
        },
        {
          "name": "scrollToBottom",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 55,
          "end_line": 68,
          "tags": {
            "PURPOSE": "Scrolls the log container to the bottom.",
            "PRE": "logContainer element must be bound.",
            "POST": "logContainer scrollTop is set to scrollHeight."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 55
              },
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 55
              }
            ],
            "score": 0.8
          }
        },
        {
          "name": "handleScroll",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 70,
          "end_line": 83,
          "tags": {
            "PURPOSE": "Updates auto-scroll preference based on scroll position.",
            "PRE": "logContainer scroll event fired.",
            "POST": "autoScroll boolean is updated."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 70
              },
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 70
              }
            ],
            "score": 0.8
          }
        },
        {
          "name": "close",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 85,
          "end_line": 95,
          "tags": {
            "PURPOSE": "Closes the log viewer modal.",
            "PRE": "Modal is open.",
            "POST": "Modal is closed and close event is dispatched."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 85
              },
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 85
              }
            ],
            "score": 0.8
          }
        },
        {
          "name": "getLogLevelColor",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 97,
          "end_line": 112,
          "tags": {
            "PURPOSE": "Returns the CSS color class for a given log level.",
            "PRE": "level string is provided.",
            "POST": "Returns tailwind color class string."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 97
              },
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 97
              }
            ],
            "score": 0.8
          }
        },
        {
          "name": "onDestroy",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 131,
          "end_line": 140,
          "tags": {
            "PURPOSE": "Cleans up the polling interval.",
            "PRE": "Component is being destroyed.",
            "POST": "Polling interval is cleared."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 131
              },
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 131
              }
            ],
            "score": 0.8
          }
        }
      ],
      "compliance": {
        "valid": true,
        "issues": [
          {
            "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
            "severity": "WARNING",
            "line_number": 1
          }
        ],
        "score": 0.85
      },
      "props": [
        {
          "name": "show",
          "type": "any",
          "default": "false"
        },
        {
          "name": "inline",
          "type": "any",
          "default": "false"
        },
        {
          "name": "taskId",
          "type": "any",
          "default": "null"
        },
        {
          "name": "taskStatus",
          "type": "any",
          "default": "null"
        }
      ],
      "events": [
        "close"
      ],
      "data_flow": [
        {
          "store": "t",
          "type": "READS_FROM",
          "line": 148
        },
        {
          "store": "t",
          "type": "WRITES_TO",
          "line": 150
        },
        {
          "store": "t",
          "type": "WRITES_TO",
          "line": 157
        },
        {
          "store": "t",
          "type": "WRITES_TO",
          "line": 161
        },
        {
          "store": "t",
          "type": "READS_FROM",
          "line": 197
        },
        {
          "store": "t",
          "type": "WRITES_TO",
          "line": 198
        },
        {
          "store": "t",
          "type": "WRITES_TO",
          "line": 205
        },
        {
          "store": "t",
          "type": "WRITES_TO",
          "line": 209
        },
        {
          "store": "t",
          "type": "READS_FROM",
          "line": 236
        }
      ]
    },
    {
      "name": "Footer",
      "type": "Component",
      "tier": "STANDARD",
      "start_line": 1,
      "end_line": 10,
      "tags": {
        "SEMANTICS": "footer, layout, copyright",
        "PURPOSE": "Displays the application footer with copyright information.",
        "LAYER": "UI"
      },
      "relations": [],
      "children": [],
      "compliance": {
        "valid": true,
        "issues": [
          {
            "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
            "severity": "WARNING",
            "line_number": 1
          }
        ],
        "score": 0.85
      }
    },
    {
      "name": "MissingMappingModal",
      "type": "Component",
      "tier": "STANDARD",
      "start_line": 1,
      "end_line": 118,
      "tags": {
        "SEMANTICS": "modal, mapping, prompt, migration",
        "PURPOSE": "Prompts the user to provide a database mapping when one is missing during migration.",
        "LAYER": "Feature",
        "RELATION": "DISPATCHES -> resolve",
        "INVARIANT": "Modal blocks migration progress until resolved or cancelled."
      },
      "relations": [],
      "children": [
        {
          "name": "resolve",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 26,
          "end_line": 39,
          "tags": {
            "PURPOSE": "Dispatches the resolution event with the selected mapping.",
            "PRE": "selectedTargetUuid must be set.",
            "POST": "'resolve' event is dispatched and modal is hidden."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 26
              },
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 26
              }
            ],
            "score": 0.8
          }
        },
        {
          "name": "cancel",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 41,
          "end_line": 49,
          "tags": {
            "PURPOSE": "Cancels the mapping resolution modal.",
            "PRE": "Modal is open.",
            "POST": "'cancel' event is dispatched and modal is hidden."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 41
              },
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 41
              }
            ],
            "score": 0.8
          }
        }
      ],
      "compliance": {
        "valid": true,
        "issues": [
          {
            "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
            "severity": "WARNING",
            "line_number": 1
          }
        ],
        "score": 0.85
      },
      "props": [
        {
          "name": "show",
          "type": "boolean ",
          "default": "false"
        },
        {
          "name": "sourceDbName",
          "type": "string ",
          "default": "\"\""
        },
        {
          "name": "sourceDbUuid",
          "type": "string ",
          "default": "\"\""
        }
      ],
      "events": [
        "cancel",
        "resolve"
      ]
    },
    {
      "name": "DashboardGrid",
      "type": "Component",
      "tier": "STANDARD",
      "start_line": 1,
      "end_line": 319,
      "tags": {
        "SEMANTICS": "dashboard, grid, selection, pagination",
        "PURPOSE": "Displays a grid of dashboards with selection and pagination.",
        "LAYER": "Component",
        "RELATION": "USED_BY -> frontend/src/routes/migration/+page.svelte",
        "INVARIANT": "Selected IDs must be a subset of available dashboards."
      },
      "relations": [],
      "children": [
        {
          "name": "handleValidate",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 43,
          "end_line": 86,
          "tags": {
            "PURPOSE": "Triggers dashboard validation task."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Mandatory Tag: @PRE (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 43
              },
              {
                "message": "Missing Mandatory Tag: @POST (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 43
              },
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 43
              },
              {
                "message": "Missing Mandatory Tag: @PRE (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 43
              },
              {
                "message": "Missing Mandatory Tag: @POST (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 43
              },
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 43
              }
            ],
            "score": 0.26666666666666655
          }
        },
        {
          "name": "handleSort",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 120,
          "end_line": 132,
          "tags": {
            "PURPOSE": "Toggles sort direction or changes sort column.",
            "PRE": "column name is provided.",
            "POST": "sortColumn and sortDirection state updated."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 120
              },
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 120
              }
            ],
            "score": 0.8
          }
        },
        {
          "name": "handleSelectionChange",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 134,
          "end_line": 148,
          "tags": {
            "PURPOSE": "Handles individual checkbox changes.",
            "PRE": "dashboard ID and checked status provided.",
            "POST": "selectedIds array updated and selectionChanged event dispatched."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 134
              },
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 134
              }
            ],
            "score": 0.8
          }
        },
        {
          "name": "handleSelectAll",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 150,
          "end_line": 168,
          "tags": {
            "PURPOSE": "Handles select all checkbox.",
            "PRE": "checked status provided.",
            "POST": "selectedIds array updated for all paginated items and event dispatched."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 150
              },
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 150
              }
            ],
            "score": 0.8
          }
        },
        {
          "name": "goToPage",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 170,
          "end_line": 179,
          "tags": {
            "PURPOSE": "Changes current page.",
            "PRE": "page index is provided.",
            "POST": "currentPage state updated if within valid range."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 170
              },
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 170
              }
            ],
            "score": 0.8
          }
        },
        {
          "name": "openGit",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 181,
          "end_line": 190,
          "tags": {
            "PURPOSE": "Opens the Git management modal for a dashboard."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Mandatory Tag: @PRE (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 181
              },
              {
                "message": "Missing Mandatory Tag: @POST (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 181
              },
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 181
              },
              {
                "message": "Missing Mandatory Tag: @PRE (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 181
              },
              {
                "message": "Missing Mandatory Tag: @POST (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 181
              },
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 181
              }
            ],
            "score": 0.26666666666666655
          }
        }
      ],
      "compliance": {
        "valid": true,
        "issues": [
          {
            "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
            "severity": "WARNING",
            "line_number": 1
          }
        ],
        "score": 0.85
      },
      "props": [
        {
          "name": "dashboards",
          "type": "DashboardMetadata[] ",
          "default": "[]"
        },
        {
          "name": "selectedIds",
          "type": "number[] ",
          "default": "[]"
        },
        {
          "name": "environmentId",
          "type": "string ",
          "default": "\"ss1\""
        }
      ],
      "events": [
        "selectionChanged"
      ],
      "data_flow": [
        {
          "store": "t",
          "type": "WRITES_TO",
          "line": 200
        },
        {
          "store": "t",
          "type": "READS_FROM",
          "line": 219
        },
        {
          "store": "t",
          "type": "READS_FROM",
          "line": 222
        },
        {
          "store": "t",
          "type": "READS_FROM",
          "line": 225
        },
        {
          "store": "t",
          "type": "WRITES_TO",
          "line": 227
        },
        {
          "store": "t",
          "type": "WRITES_TO",
          "line": 228
        },
        {
          "store": "t",
          "type": "READS_FROM",
          "line": 267
        },
        {
          "store": "t",
          "type": "READS_FROM",
          "line": 279
        },
        {
          "store": "t",
          "type": "READS_FROM",
          "line": 291
        },
        {
          "store": "t",
          "type": "READS_FROM",
          "line": 299
        }
      ]
    },
    {
      "name": "Navbar",
      "type": "Component",
      "tier": "STANDARD",
      "start_line": 1,
      "end_line": 80,
      "tags": {
        "SEMANTICS": "navbar, navigation, header, layout",
        "PURPOSE": "Main navigation bar for the application.",
        "LAYER": "UI",
        "RELATION": "USES -> $app/stores"
      },
      "relations": [],
      "children": [],
      "compliance": {
        "valid": true,
        "issues": [
          {
            "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
            "severity": "WARNING",
            "line_number": 1
          }
        ],
        "score": 0.85
      },
      "data_flow": [
        {
          "store": "app",
          "type": "READS_FROM",
          "line": 6
        },
        {
          "store": "app",
          "type": "READS_FROM",
          "line": 9
        },
        {
          "store": "lib",
          "type": "READS_FROM",
          "line": 10
        },
        {
          "store": "lib",
          "type": "READS_FROM",
          "line": 11
        },
        {
          "store": "lib",
          "type": "READS_FROM",
          "line": 12
        },
        {
          "store": "app",
          "type": "READS_FROM",
          "line": 13
        },
        {
          "store": "page",
          "type": "WRITES_TO",
          "line": 31
        },
        {
          "store": "t",
          "type": "READS_FROM",
          "line": 33
        },
        {
          "store": "page",
          "type": "WRITES_TO",
          "line": 37
        },
        {
          "store": "t",
          "type": "READS_FROM",
          "line": 39
        },
        {
          "store": "page",
          "type": "WRITES_TO",
          "line": 42
        },
        {
          "store": "t",
          "type": "READS_FROM",
          "line": 43
        },
        {
          "store": "t",
          "type": "WRITES_TO",
          "line": 46
        },
        {
          "store": "t",
          "type": "WRITES_TO",
          "line": 47
        },
        {
          "store": "t",
          "type": "WRITES_TO",
          "line": 48
        },
        {
          "store": "auth",
          "type": "READS_FROM",
          "line": 52
        },
        {
          "store": "auth",
          "type": "READS_FROM",
          "line": 52
        },
        {
          "store": "page",
          "type": "WRITES_TO",
          "line": 54
        },
        {
          "store": "t",
          "type": "READS_FROM",
          "line": 55
        },
        {
          "store": "t",
          "type": "WRITES_TO",
          "line": 58
        },
        {
          "store": "t",
          "type": "WRITES_TO",
          "line": 59
        },
        {
          "store": "t",
          "type": "WRITES_TO",
          "line": 60
        },
        {
          "store": "t",
          "type": "WRITES_TO",
          "line": 61
        },
        {
          "store": "auth",
          "type": "READS_FROM",
          "line": 67
        },
        {
          "store": "auth",
          "type": "WRITES_TO",
          "line": 69
        }
      ]
    },
    {
      "name": "Navbar",
      "type": "Module",
      "tier": "TRIVIAL",
      "start_line": 1,
      "end_line": 80,
      "tags": {
        "PURPOSE": "Auto-generated module for frontend/src/components/Navbar.svelte",
        "TIER": "TRIVIAL",
        "LAYER": "Unknown"
      },
      "relations": [],
      "children": [
        {
          "name": "handleLogout",
          "type": "Function",
          "tier": "TRIVIAL",
          "start_line": 15,
          "end_line": 15,
          "tags": {
            "PURPOSE": "Auto-detected function (orphan)",
            "TIER": "TRIVIAL"
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        }
      ],
      "compliance": {
        "valid": true,
        "issues": [],
        "score": 1.0
      }
    },
    {
      "name": "TaskHistory",
      "type": "Component",
      "tier": "STANDARD",
      "start_line": 1,
      "end_line": 199,
      "tags": {
        "SEMANTICS": "task, history, list, status, monitoring",
        "PURPOSE": "Displays a list of recent tasks with their status and allows selecting them for viewing logs.",
        "LAYER": "UI",
        "RELATION": "USES -> frontend/src/lib/api.js (inferred)"
      },
      "relations": [],
      "children": [
        {
          "name": "fetchTasks",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 19,
          "end_line": 47,
          "tags": {
            "PURPOSE": "Fetches the list of recent tasks from the API.",
            "PRE": "None.",
            "POST": "tasks array is updated and selectedTask status synchronized."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 19
              },
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 19
              }
            ],
            "score": 0.8
          }
        },
        {
          "name": "clearTasks",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 49,
          "end_line": 65,
          "tags": {
            "PURPOSE": "Clears tasks from the history, optionally filtered by status.",
            "PRE": "User confirms deletion via prompt.",
            "POST": "Tasks are deleted from backend and list is re-fetched."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 49
              },
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 49
              }
            ],
            "score": 0.8
          }
        },
        {
          "name": "selectTask",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 67,
          "end_line": 81,
          "tags": {
            "PURPOSE": "Selects a task and fetches its full details.",
            "PRE": "task object is provided.",
            "POST": "selectedTask store is updated with full task details."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 67
              },
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 67
              }
            ],
            "score": 0.8
          }
        },
        {
          "name": "getStatusColor",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 83,
          "end_line": 97,
          "tags": {
            "PURPOSE": "Returns the CSS color class for a given task status.",
            "PRE": "status string is provided.",
            "POST": "Returns tailwind color class string."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 83
              },
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 83
              }
            ],
            "score": 0.8
          }
        },
        {
          "name": "onMount",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 99,
          "end_line": 107,
          "tags": {
            "PURPOSE": "Initializes the component by fetching tasks and starting polling.",
            "PRE": "Component is mounting.",
            "POST": "Tasks are fetched and 5s polling interval is started."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 99
              },
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 99
              }
            ],
            "score": 0.8
          }
        },
        {
          "name": "onDestroy",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 109,
          "end_line": 116,
          "tags": {
            "PURPOSE": "Cleans up the polling interval when the component is destroyed.",
            "PRE": "Component is being destroyed.",
            "POST": "Polling interval is cleared."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 109
              },
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 109
              }
            ],
            "score": 0.8
          }
        }
      ],
      "compliance": {
        "valid": true,
        "issues": [
          {
            "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
            "severity": "WARNING",
            "line_number": 1
          }
        ],
        "score": 0.85
      },
      "data_flow": [
        {
          "store": "selectedTask",
          "type": "READS_FROM",
          "line": 35
        },
        {
          "store": "selectedTask",
          "type": "WRITES_TO",
          "line": 36
        },
        {
          "store": "selectedTask",
          "type": "WRITES_TO",
          "line": 37
        },
        {
          "store": "selectedTask",
          "type": "WRITES_TO",
          "line": 161
        },
        {
          "store": "selectedTask",
          "type": "WRITES_TO",
          "line": 161
        }
      ]
    },
    {
      "name": "Toast",
      "type": "Component",
      "tier": "STANDARD",
      "start_line": 1,
      "end_line": 31,
      "tags": {
        "SEMANTICS": "toast, notification, feedback, ui",
        "PURPOSE": "Displays transient notifications (toasts) in the bottom-right corner.",
        "LAYER": "UI",
        "RELATION": "DEPENDS_ON -> frontend/src/lib/toasts.js",
        "PROPS": "None",
        "EVENTS": "None"
      },
      "relations": [],
      "children": [],
      "compliance": {
        "valid": true,
        "issues": [
          {
            "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
            "severity": "WARNING",
            "line_number": 1
          }
        ],
        "score": 0.85
      },
      "data_flow": [
        {
          "store": "toasts",
          "type": "READS_FROM",
          "line": 19
        }
      ]
    },
    {
      "name": "TaskRunner",
      "type": "Component",
      "tier": "STANDARD",
      "start_line": 1,
      "end_line": 380,
      "tags": {
        "SEMANTICS": "task, runner, logs, websocket",
        "PURPOSE": "Connects to a WebSocket to display real-time logs for a running task.",
        "LAYER": "UI",
        "RELATION": "DEPENDS_ON -> frontend/src/lib/stores.js",
        "PROPS": "None",
        "EVENTS": "None"
      },
      "relations": [],
      "children": [
        {
          "name": "connect",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 38,
          "end_line": 132,
          "tags": {
            "PURPOSE": "Establishes WebSocket connection with exponential backoff.",
            "PRE": "selectedTask must be set in the store.",
            "POST": "WebSocket instance created and listeners attached."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 38
              },
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 38
              }
            ],
            "score": 0.8
          }
        },
        {
          "name": "fetchTargetDatabases",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 134,
          "end_line": 154,
          "tags": {
            "PURPOSE": "Fetches the list of databases in the target environment.",
            "PRE": "task must be selected and have a target environment parameter.",
            "POST": "targetDatabases array is populated with database objects."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 134
              },
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 134
              }
            ],
            "score": 0.8
          }
        },
        {
          "name": "handleMappingResolve",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 156,
          "end_line": 190,
          "tags": {
            "PURPOSE": "Handles the resolution of a missing database mapping.",
            "PRE": "event.detail contains sourceDbUuid, targetDbUuid, and targetDbName.",
            "POST": "Mapping is saved and task is resumed."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 156
              },
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 156
              }
            ],
            "score": 0.8
          }
        },
        {
          "name": "handlePasswordResume",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 192,
          "end_line": 210,
          "tags": {
            "PURPOSE": "Handles the submission of database passwords to resume a task.",
            "PRE": "event.detail contains passwords dictionary.",
            "POST": "Task resume endpoint is called with passwords."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 192
              },
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 192
              }
            ],
            "score": 0.8
          }
        },
        {
          "name": "startDataTimeout",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 212,
          "end_line": 224,
          "tags": {
            "PURPOSE": "Starts a timeout to detect when the log stream has stalled.",
            "PRE": "None.",
            "POST": "dataTimeout is set to check connection status after 5s."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 212
              },
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 212
              }
            ],
            "score": 0.8
          }
        },
        {
          "name": "resetDataTimeout",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 226,
          "end_line": 235,
          "tags": {
            "PURPOSE": "Resets the data stall timeout.",
            "PRE": "dataTimeout must be active.",
            "POST": "dataTimeout is cleared and restarted."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 226
              },
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 226
              }
            ],
            "score": 0.8
          }
        },
        {
          "name": "onMount",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 237,
          "end_line": 264,
          "tags": {
            "PURPOSE": "Initializes the component and subscribes to task selection changes.",
            "PRE": "Svelte component is mounting.",
            "POST": "Store subscription is created and returned for cleanup."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 237
              },
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 237
              }
            ],
            "score": 0.8
          }
        },
        {
          "name": "onDestroy",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 266,
          "end_line": 280,
          "tags": {
            "PURPOSE": "Close WebSocket connection when the component is destroyed.",
            "PRE": "Component is being destroyed.",
            "POST": "WebSocket is closed and timeouts are cleared."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        }
      ],
      "compliance": {
        "valid": true,
        "issues": [
          {
            "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
            "severity": "WARNING",
            "line_number": 1
          }
        ],
        "score": 0.85
      },
      "data_flow": [
        {
          "store": "selectedTask",
          "type": "READS_FROM",
          "line": 285
        },
        {
          "store": "selectedTask",
          "type": "WRITES_TO",
          "line": 287
        },
        {
          "store": "selectedTask",
          "type": "WRITES_TO",
          "line": 320
        },
        {
          "store": "selectedTask",
          "type": "WRITES_TO",
          "line": 321
        },
        {
          "store": "selectedTask",
          "type": "WRITES_TO",
          "line": 322
        },
        {
          "store": "selectedTask",
          "type": "WRITES_TO",
          "line": 322
        },
        {
          "store": "selectedTask",
          "type": "WRITES_TO",
          "line": 323
        },
        {
          "store": "selectedTask",
          "type": "WRITES_TO",
          "line": 327
        },
        {
          "store": "taskLogs",
          "type": "READS_FROM",
          "line": 334
        },
        {
          "store": "taskLogs",
          "type": "READS_FROM",
          "line": 337
        }
      ]
    },
    {
      "name": "TaskList",
      "type": "Component",
      "tier": "STANDARD",
      "start_line": 1,
      "end_line": 110,
      "tags": {
        "SEMANTICS": "tasks, list, status, history",
        "PURPOSE": "Displays a list of tasks with their status and execution details.",
        "LAYER": "Component",
        "RELATION": "USES -> api.js"
      },
      "relations": [],
      "children": [
        {
          "name": "getStatusColor",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 19,
          "end_line": 34,
          "tags": {
            "PURPOSE": "Returns the CSS color class for a given task status.",
            "PRE": "status string is provided.",
            "POST": "Returns tailwind color class string."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 19
              },
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 19
              }
            ],
            "score": 0.8
          }
        },
        {
          "name": "formatTime",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 36,
          "end_line": 48,
          "tags": {
            "PURPOSE": "Formats a date string using date-fns.",
            "PRE": "dateStr is a valid date string or null.",
            "POST": "Returns human-readable relative time string."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 36
              },
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 36
              }
            ],
            "score": 0.8
          }
        },
        {
          "name": "handleTaskClick",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 50,
          "end_line": 57,
          "tags": {
            "PURPOSE": "Dispatches a select event when a task is clicked.",
            "PRE": "taskId is provided.",
            "POST": "'select' event is dispatched with task ID."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 50
              },
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 50
              }
            ],
            "score": 0.8
          }
        }
      ],
      "compliance": {
        "valid": true,
        "issues": [
          {
            "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
            "severity": "WARNING",
            "line_number": 1
          }
        ],
        "score": 0.85
      },
      "props": [
        {
          "name": "tasks",
          "type": "Array<any> ",
          "default": "[]"
        },
        {
          "name": "loading",
          "type": "boolean ",
          "default": "false"
        }
      ],
      "events": [
        "select"
      ],
      "data_flow": [
        {
          "store": "t",
          "type": "WRITES_TO",
          "line": 62
        },
        {
          "store": "t",
          "type": "WRITES_TO",
          "line": 64
        },
        {
          "store": "t",
          "type": "READS_FROM",
          "line": 98
        }
      ]
    },
    {
      "name": "DynamicForm",
      "type": "Component",
      "tier": "STANDARD",
      "start_line": 1,
      "end_line": 92,
      "tags": {
        "SEMANTICS": "form, schema, dynamic, json-schema",
        "PURPOSE": "Generates a form dynamically based on a JSON schema.",
        "LAYER": "UI",
        "RELATION": "DEPENDS_ON -> svelte:createEventDispatcher",
        "PROPS": "",
        "EVENTS": ""
      },
      "relations": [],
      "children": [
        {
          "name": "handleSubmit",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 23,
          "end_line": 33,
          "tags": {
            "PURPOSE": "Dispatches the submit event with the form data.",
            "PRE": "formData contains user input.",
            "POST": "'submit' event is dispatched with formData."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "initializeForm",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 35,
          "end_line": 48,
          "tags": {
            "PURPOSE": "Initialize form data with default values from the schema.",
            "PRE": "schema is provided and contains properties.",
            "POST": "formData is initialized with default values or empty strings."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 35
              },
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 35
              }
            ],
            "score": 0.8
          }
        }
      ],
      "compliance": {
        "valid": true,
        "issues": [
          {
            "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
            "severity": "WARNING",
            "line_number": 1
          }
        ],
        "score": 0.85
      },
      "props": [
        {
          "name": "schema",
          "type": "any",
          "default": null
        }
      ],
      "events": [
        "submit"
      ]
    },
    {
      "name": "EnvSelector",
      "type": "Component",
      "tier": "STANDARD",
      "start_line": 1,
      "end_line": 60,
      "tags": {
        "SEMANTICS": "environment, selector, dropdown, migration",
        "PURPOSE": "Provides a UI component for selecting source and target environments.",
        "LAYER": "Feature",
        "RELATION": "BINDS_TO -> environments store",
        "INVARIANT": "Source and target environments must be selectable from the list of configured environments."
      },
      "relations": [],
      "children": [
        {
          "name": "handleSelect",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 24,
          "end_line": 36,
          "tags": {
            "PURPOSE": "Dispatches the selection change event.",
            "PRE": "event.target must be an HTMLSelectElement.",
            "POST": "selectedId is updated and 'change' event is dispatched.",
            "PARAM": "{Event} event - The change event from the select element."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 24
              },
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 24
              }
            ],
            "score": 0.8
          }
        }
      ],
      "compliance": {
        "valid": true,
        "issues": [
          {
            "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
            "severity": "WARNING",
            "line_number": 1
          }
        ],
        "score": 0.85
      },
      "props": [
        {
          "name": "label",
          "type": "string ",
          "default": "\"Select Environment\""
        },
        {
          "name": "selectedId",
          "type": "string ",
          "default": "\"\""
        }
      ],
      "events": [
        "change"
      ]
    },
    {
      "name": "ProtectedRoute",
      "type": "Component",
      "tier": "STANDARD",
      "start_line": 1,
      "end_line": 50,
      "tags": {
        "SEMANTICS": "auth, guard, route, protection",
        "PURPOSE": "Wraps content to ensure only authenticated users can access it.",
        "LAYER": "Component",
        "RELATION": "CALLS -> goto",
        "INVARIANT": "Redirects to /login if user is not authenticated."
      },
      "relations": [],
      "children": [],
      "compliance": {
        "valid": true,
        "issues": [
          {
            "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
            "severity": "WARNING",
            "line_number": 1
          }
        ],
        "score": 0.85
      },
      "data_flow": [
        {
          "store": "app",
          "type": "READS_FROM",
          "line": 16
        },
        {
          "store": "auth",
          "type": "READS_FROM",
          "line": 24
        },
        {
          "store": "auth",
          "type": "READS_FROM",
          "line": 24
        },
        {
          "store": "auth",
          "type": "READS_FROM",
          "line": 36
        },
        {
          "store": "auth",
          "type": "READS_FROM",
          "line": 42
        },
        {
          "store": "auth",
          "type": "READS_FROM",
          "line": 46
        }
      ]
    },
    {
      "name": "FileList",
      "type": "Component",
      "tier": "STANDARD",
      "start_line": 1,
      "end_line": 144,
      "tags": {
        "TIER": "STANDARD",
        "SEMANTICS": "storage, files, list, table",
        "PURPOSE": "Displays a table of files with metadata and actions.",
        "LAYER": "UI",
        "RELATION": "DEPENDS_ON -> storageService",
        "PROPS": "files (Array) - List of StoredFile objects.",
        "EVENTS": "delete (filename) - Dispatched when a file is deleted."
      },
      "relations": [],
      "children": [
        {
          "name": "isDirectory",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 23,
          "end_line": 35,
          "tags": {
            "PURPOSE": "Checks if a file object represents a directory.",
            "PRE": "file object has mime_type property.",
            "POST": "Returns boolean.",
            "PARAM": "{Object} file - The file object to check.",
            "RETURN": "{boolean} True if it's a directory, false otherwise."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "formatSize",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 37,
          "end_line": 53,
          "tags": {
            "PURPOSE": "Formats file size in bytes into a human-readable string.",
            "PRE": "bytes is a number.",
            "POST": "Returns formatted string.",
            "PARAM": "{number} bytes - The size in bytes.",
            "RETURN": "{string} Formatted size (e.g., \"1.2 MB\")."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 37
              },
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 37
              }
            ],
            "score": 0.8
          }
        },
        {
          "name": "formatDate",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 55,
          "end_line": 67,
          "tags": {
            "PURPOSE": "Formats an ISO date string into a localized readable format.",
            "PRE": "dateStr is a valid date string.",
            "POST": "Returns localized string.",
            "PARAM": "{string} dateStr - The date string to format.",
            "RETURN": "{string} Localized date and time."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        }
      ],
      "compliance": {
        "valid": true,
        "issues": [],
        "score": 1.0
      },
      "props": [
        {
          "name": "files",
          "type": "any",
          "default": "[]"
        }
      ],
      "events": [
        "delete",
        "navigate"
      ],
      "data_flow": [
        {
          "store": "t",
          "type": "WRITES_TO",
          "line": 75
        },
        {
          "store": "t",
          "type": "WRITES_TO",
          "line": 76
        },
        {
          "store": "t",
          "type": "WRITES_TO",
          "line": 77
        },
        {
          "store": "t",
          "type": "WRITES_TO",
          "line": 78
        },
        {
          "store": "t",
          "type": "WRITES_TO",
          "line": 79
        },
        {
          "store": "t",
          "type": "READS_FROM",
          "line": 117
        },
        {
          "store": "t",
          "type": "READS_FROM",
          "line": 124
        },
        {
          "store": "t",
          "type": "READS_FROM",
          "line": 131
        }
      ]
    },
    {
      "name": "FileUpload",
      "type": "Component",
      "tier": "STANDARD",
      "start_line": 1,
      "end_line": 135,
      "tags": {
        "TIER": "STANDARD",
        "SEMANTICS": "storage, upload, files",
        "PURPOSE": "Provides a form for uploading files to a specific category.",
        "LAYER": "UI",
        "RELATION": "DEPENDS_ON -> storageService",
        "PROPS": "None",
        "EVENTS": "uploaded - Dispatched when a file is successfully uploaded."
      },
      "relations": [],
      "children": [
        {
          "name": "handleUpload",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 21,
          "end_line": 56,
          "tags": {
            "PURPOSE": "Handles the file upload process.",
            "PRE": "A file must be selected in the file input.",
            "POST": "The file is uploaded to the server and a success toast is shown."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 21
              },
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 21
              }
            ],
            "score": 0.8
          }
        },
        {
          "name": "handleDrop",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 58,
          "end_line": 72,
          "tags": {
            "PURPOSE": "Handles the file drop event for drag-and-drop.",
            "PARAM": "{DragEvent} event - The drop event."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Mandatory Tag: @PRE (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 58
              },
              {
                "message": "Missing Mandatory Tag: @POST (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 58
              },
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 58
              },
              {
                "message": "Missing Mandatory Tag: @PRE (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 58
              },
              {
                "message": "Missing Mandatory Tag: @POST (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 58
              },
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 58
              }
            ],
            "score": 0.26666666666666655
          }
        }
      ],
      "compliance": {
        "valid": true,
        "issues": [],
        "score": 1.0
      },
      "events": [
        "uploaded"
      ],
      "data_flow": [
        {
          "store": "t",
          "type": "READS_FROM",
          "line": 47
        },
        {
          "store": "t",
          "type": "READS_FROM",
          "line": 51
        },
        {
          "store": "t",
          "type": "WRITES_TO",
          "line": 77
        },
        {
          "store": "t",
          "type": "WRITES_TO",
          "line": 81
        },
        {
          "store": "t",
          "type": "WRITES_TO",
          "line": 86
        },
        {
          "store": "t",
          "type": "WRITES_TO",
          "line": 87
        },
        {
          "store": "t",
          "type": "READS_FROM",
          "line": 104
        },
        {
          "store": "t",
          "type": "WRITES_TO",
          "line": 115
        },
        {
          "store": "t",
          "type": "WRITES_TO",
          "line": 117
        },
        {
          "store": "t",
          "type": "WRITES_TO",
          "line": 124
        }
      ]
    },
    {
      "name": "ConnectionForm",
      "type": "Component",
      "tier": "STANDARD",
      "start_line": 1,
      "end_line": 95,
      "tags": {
        "SEMANTICS": "connection, form, settings",
        "PURPOSE": "UI component for creating a new database connection configuration.",
        "LAYER": "UI",
        "RELATION": "USES -> frontend/src/services/connectionService.js"
      },
      "relations": [],
      "children": [
        {
          "name": "handleSubmit",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 28,
          "end_line": 52,
          "tags": {
            "PURPOSE": "Submits the connection form to the backend.",
            "PRE": "All required fields (name, host, database, username, password) must be filled.",
            "POST": "A new connection is created via the connection service and a success event is dispatched."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 28
              },
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 28
              }
            ],
            "score": 0.8
          }
        },
        {
          "name": "resetForm",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 54,
          "end_line": 67,
          "tags": {
            "PURPOSE": "Resets the connection form fields to their default values.",
            "PRE": "None.",
            "POST": "All form input variables are reset."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 54
              },
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 54
              }
            ],
            "score": 0.8
          }
        }
      ],
      "compliance": {
        "valid": true,
        "issues": [
          {
            "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
            "severity": "WARNING",
            "line_number": 1
          }
        ],
        "score": 0.85
      },
      "events": [
        "success"
      ],
      "data_flow": [
        {
          "store": "t",
          "type": "WRITES_TO",
          "line": 71
        },
        {
          "store": "t",
          "type": "WRITES_TO",
          "line": 73
        },
        {
          "store": "t",
          "type": "WRITES_TO",
          "line": 76
        },
        {
          "store": "t",
          "type": "WRITES_TO",
          "line": 77
        },
        {
          "store": "t",
          "type": "WRITES_TO",
          "line": 80
        },
        {
          "store": "t",
          "type": "WRITES_TO",
          "line": 83
        },
        {
          "store": "t",
          "type": "WRITES_TO",
          "line": 84
        },
        {
          "store": "t",
          "type": "READS_FROM",
          "line": 89
        }
      ]
    },
    {
      "name": "ConnectionList",
      "type": "Component",
      "tier": "STANDARD",
      "start_line": 1,
      "end_line": 88,
      "tags": {
        "SEMANTICS": "connection, list, settings",
        "PURPOSE": "UI component for listing and deleting saved database connection configurations.",
        "LAYER": "UI",
        "RELATION": "USES -> frontend/src/services/connectionService.js"
      },
      "relations": [],
      "children": [
        {
          "name": "fetchConnections",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 22,
          "end_line": 36,
          "tags": {
            "PURPOSE": "Fetches the list of connections from the backend.",
            "PRE": "None.",
            "POST": "connections array is populated."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 22
              },
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 22
              }
            ],
            "score": 0.8
          }
        },
        {
          "name": "handleDelete",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 38,
          "end_line": 53,
          "tags": {
            "PURPOSE": "Deletes a connection configuration.",
            "PRE": "id is provided and user confirms deletion.",
            "POST": "Connection is deleted from backend and list is reloaded."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 38
              },
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 38
              }
            ],
            "score": 0.8
          }
        }
      ],
      "compliance": {
        "valid": true,
        "issues": [
          {
            "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
            "severity": "WARNING",
            "line_number": 1
          }
        ],
        "score": 0.85
      },
      "data_flow": [
        {
          "store": "t",
          "type": "WRITES_TO",
          "line": 62
        },
        {
          "store": "t",
          "type": "WRITES_TO",
          "line": 65
        },
        {
          "store": "t",
          "type": "WRITES_TO",
          "line": 67
        },
        {
          "store": "t",
          "type": "READS_FROM",
          "line": 80
        }
      ]
    },
    {
      "name": "MapperTool",
      "type": "Component",
      "tier": "STANDARD",
      "start_line": 1,
      "end_line": 250,
      "tags": {
        "SEMANTICS": "mapper, tool, dataset, postgresql, excel",
        "PURPOSE": "UI component for mapping dataset column verbose names using the MapperPlugin.",
        "LAYER": "UI",
        "RELATION": "USES -> frontend/src/services/connectionService.js"
      },
      "relations": [],
      "children": [
        {
          "name": "fetchData",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 35,
          "end_line": 47,
          "tags": {
            "PURPOSE": "Fetches environments and saved connections.",
            "PRE": "None.",
            "POST": "envs and connections arrays are populated."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 35
              },
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 35
              }
            ],
            "score": 0.8
          }
        },
        {
          "name": "handleRunMapper",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 49,
          "end_line": 90,
          "tags": {
            "PURPOSE": "Triggers the MapperPlugin task.",
            "PRE": "selectedEnv and datasetId are set; source-specific fields are valid.",
            "POST": "Mapper task is started and selectedTask is updated."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 49
              },
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 49
              }
            ],
            "score": 0.8
          }
        },
        {
          "name": "handleGenerateDocs",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 92,
          "end_line": 127,
          "tags": {
            "PURPOSE": "Triggers the LLM Documentation task.",
            "PRE": "selectedEnv and datasetId are set.",
            "POST": "Documentation task is started."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 92
              },
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 92
              }
            ],
            "score": 0.8
          }
        }
      ],
      "compliance": {
        "valid": true,
        "issues": [
          {
            "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
            "severity": "WARNING",
            "line_number": 1
          }
        ],
        "score": 0.85
      },
      "data_flow": [
        {
          "store": "t",
          "type": "READS_FROM",
          "line": 44
        },
        {
          "store": "t",
          "type": "READS_FROM",
          "line": 55
        },
        {
          "store": "t",
          "type": "READS_FROM",
          "line": 60
        },
        {
          "store": "t",
          "type": "READS_FROM",
          "line": 65
        },
        {
          "store": "t",
          "type": "READS_FROM",
          "line": 83
        },
        {
          "store": "t",
          "type": "READS_FROM",
          "line": 98
        },
        {
          "store": "t",
          "type": "WRITES_TO",
          "line": 144
        },
        {
          "store": "t",
          "type": "WRITES_TO",
          "line": 149
        },
        {
          "store": "t",
          "type": "READS_FROM",
          "line": 152
        },
        {
          "store": "t",
          "type": "WRITES_TO",
          "line": 159
        },
        {
          "store": "t",
          "type": "WRITES_TO",
          "line": 167
        },
        {
          "store": "t",
          "type": "WRITES_TO",
          "line": 171
        },
        {
          "store": "t",
          "type": "WRITES_TO",
          "line": 175
        },
        {
          "store": "t",
          "type": "WRITES_TO",
          "line": 184
        },
        {
          "store": "t",
          "type": "READS_FROM",
          "line": 187
        },
        {
          "store": "t",
          "type": "WRITES_TO",
          "line": 195
        },
        {
          "store": "t",
          "type": "WRITES_TO",
          "line": 202
        },
        {
          "store": "t",
          "type": "WRITES_TO",
          "line": 212
        },
        {
          "store": "t",
          "type": "READS_FROM",
          "line": 237
        },
        {
          "store": "t",
          "type": "READS_FROM",
          "line": 237
        }
      ]
    },
    {
      "name": "MapperTool",
      "type": "Module",
      "tier": "TRIVIAL",
      "start_line": 1,
      "end_line": 250,
      "tags": {
        "PURPOSE": "Auto-generated module for frontend/src/components/tools/MapperTool.svelte",
        "TIER": "TRIVIAL",
        "LAYER": "Unknown"
      },
      "relations": [],
      "children": [
        {
          "name": "handleApplyDoc",
          "type": "Function",
          "tier": "TRIVIAL",
          "start_line": 129,
          "end_line": 129,
          "tags": {
            "PURPOSE": "Auto-detected function (orphan)",
            "TIER": "TRIVIAL"
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        }
      ],
      "compliance": {
        "valid": true,
        "issues": [],
        "score": 1.0
      }
    },
    {
      "name": "DebugTool",
      "type": "Component",
      "tier": "STANDARD",
      "start_line": 1,
      "end_line": 190,
      "tags": {
        "SEMANTICS": "debug, tool, api, structure",
        "PURPOSE": "UI component for system diagnostics and debugging API responses.",
        "LAYER": "UI",
        "RELATION": "USES -> frontend/src/services/toolsService.js"
      },
      "relations": [],
      "children": [
        {
          "name": "fetchEnvironments",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 27,
          "end_line": 41,
          "tags": {
            "PURPOSE": "Fetches available environments.",
            "PRE": "API is available.",
            "POST": "envs variable is populated.",
            "RETURNS": "{Promise<void>}"
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 27
              },
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 27
              }
            ],
            "score": 0.8
          }
        },
        {
          "name": "handleRunDebug",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 43,
          "end_line": 84,
          "tags": {
            "PURPOSE": "Triggers the debug task.",
            "PRE": "Required fields are selected.",
            "POST": "Task is started and polling begins.",
            "RETURNS": "{Promise<void>}"
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 43
              },
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 43
              }
            ],
            "score": 0.8
          }
        },
        {
          "name": "startPolling",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 86,
          "end_line": 116,
          "tags": {
            "PURPOSE": "Polls for task completion.",
            "PRE": "Task ID is valid.",
            "POST": "Polls until success/failure.",
            "PARAM": "{string} taskId - ID of the task.",
            "RETURNS": "{void}"
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 86
              },
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 86
              }
            ],
            "score": 0.8
          }
        }
      ],
      "compliance": {
        "valid": true,
        "issues": [
          {
            "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
            "severity": "WARNING",
            "line_number": 1
          }
        ],
        "score": 0.85
      }
    },
    {
      "name": "CommitHistory",
      "type": "Component",
      "tier": "STANDARD",
      "start_line": 1,
      "end_line": 95,
      "tags": {
        "SEMANTICS": "git, history, commits, audit",
        "PURPOSE": "Displays the commit history for a specific dashboard.",
        "LAYER": "Component",
        "RELATION": "CALLS -> gitService.getHistory"
      },
      "relations": [],
      "children": [
        {
          "name": "onMount",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 27,
          "end_line": 36,
          "tags": {
            "PURPOSE": "Load history when component is mounted.",
            "PRE": "Component is initialized with dashboardId.",
            "POST": "loadHistory is called."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 27
              },
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 27
              }
            ],
            "score": 0.8
          }
        },
        {
          "name": "loadHistory",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 38,
          "end_line": 57,
          "tags": {
            "PURPOSE": "Fetch commit history from the backend.",
            "PRE": "dashboardId is valid.",
            "POST": "history state is updated."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 38
              },
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 38
              }
            ],
            "score": 0.8
          }
        }
      ],
      "compliance": {
        "valid": true,
        "issues": [
          {
            "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
            "severity": "WARNING",
            "line_number": 1
          }
        ],
        "score": 0.85
      },
      "props": [
        {
          "name": "dashboardId",
          "type": "any",
          "default": null
        }
      ],
      "data_flow": [
        {
          "store": "t",
          "type": "READS_FROM",
          "line": 64
        },
        {
          "store": "t",
          "type": "READS_FROM",
          "line": 67
        },
        {
          "store": "t",
          "type": "WRITES_TO",
          "line": 76
        }
      ]
    },
    {
      "name": "DeploymentModal",
      "type": "Component",
      "tier": "STANDARD",
      "start_line": 1,
      "end_line": 148,
      "tags": {
        "SEMANTICS": "deployment, git, environment, modal",
        "PURPOSE": "Modal for deploying a dashboard to a target environment.",
        "LAYER": "Component",
        "RELATION": "DISPATCHES -> deploy",
        "INVARIANT": "Cannot deploy without a selected environment."
      },
      "relations": [],
      "children": [
        {
          "name": "loadStatus",
          "type": "Watcher",
          "tier": "STANDARD",
          "start_line": 33,
          "end_line": 35,
          "tags": {},
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "loadEnvironments",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 37,
          "end_line": 59,
          "tags": {
            "PURPOSE": "Fetch available environments from API.",
            "POST": "environments state is populated."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Mandatory Tag: @PRE (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 37
              },
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 37
              },
              {
                "message": "Missing Mandatory Tag: @PRE (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 37
              },
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 37
              }
            ],
            "score": 0.5333333333333333
          }
        },
        {
          "name": "handleDeploy",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 61,
          "end_line": 85,
          "tags": {
            "PURPOSE": "Trigger deployment to selected environment.",
            "PRE": "selectedEnv must be set.",
            "POST": "deploy event dispatched on success."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 61
              },
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 61
              }
            ],
            "score": 0.8
          }
        }
      ],
      "compliance": {
        "valid": true,
        "issues": [
          {
            "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
            "severity": "WARNING",
            "line_number": 1
          }
        ],
        "score": 0.85
      },
      "props": [
        {
          "name": "dashboardId",
          "type": "any",
          "default": null
        },
        {
          "name": "show",
          "type": "any",
          "default": "false"
        }
      ],
      "events": [
        "deploy"
      ]
    },
    {
      "name": "ConflictResolver",
      "type": "Component",
      "tier": "STANDARD",
      "start_line": 1,
      "end_line": 142,
      "tags": {
        "SEMANTICS": "git, conflict, resolution, merge",
        "PURPOSE": "UI for resolving merge conflicts (Keep Mine / Keep Theirs).",
        "LAYER": "Component",
        "RELATION": "DISPATCHES -> resolve",
        "INVARIANT": "User must resolve all conflicts before saving.",
        "TYPE": "{Object.<string, 'mine' | 'theirs' | 'manual'>} */"
      },
      "relations": [],
      "children": [
        {
          "name": "resolve",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 29,
          "end_line": 43,
          "tags": {
            "PURPOSE": "Set resolution strategy for a file.",
            "PRE": "file path must exist in conflicts array.",
            "POST": "resolutions state is updated for the given file.",
            "PARAM": "{'mine'|'theirs'} strategy - Resolution strategy."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 29
              },
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 29
              }
            ],
            "score": 0.8
          }
        },
        {
          "name": "handleSave",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 45,
          "end_line": 66,
          "tags": {
            "PURPOSE": "Validate and submit resolutions.",
            "PRE": "All conflicts must have a resolution.",
            "POST": "'resolve' event dispatched if valid."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 45
              },
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 45
              }
            ],
            "score": 0.8
          }
        }
      ],
      "compliance": {
        "valid": true,
        "issues": [
          {
            "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
            "severity": "WARNING",
            "line_number": 1
          }
        ],
        "score": 0.85
      },
      "props": [
        {
          "name": "conflicts",
          "type": "any",
          "default": "[]"
        },
        {
          "name": "show",
          "type": "any",
          "default": "false"
        }
      ],
      "events": [
        "resolve"
      ]
    },
    {
      "name": "CommitModal",
      "type": "Component",
      "tier": "STANDARD",
      "start_line": 1,
      "end_line": 211,
      "tags": {
        "SEMANTICS": "git, commit, modal, version_control, diff",
        "PURPOSE": "\u041c\u043e\u0434\u0430\u043b\u044c\u043d\u043e\u0435 \u043e\u043a\u043d\u043e \u0434\u043b\u044f \u0441\u043e\u0437\u0434\u0430\u043d\u0438\u044f \u043a\u043e\u043c\u043c\u0438\u0442\u0430 \u0441 \u043f\u0440\u043e\u0441\u043c\u043e\u0442\u0440\u043e\u043c \u0438\u0437\u043c\u0435\u043d\u0435\u043d\u0438\u0439 (diff).",
        "LAYER": "Component",
        "RELATION": "DISPATCHES -> commit"
      },
      "relations": [],
      "children": [
        {
          "name": "handleGenerateMessage",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 36,
          "end_line": 55,
          "tags": {
            "PURPOSE": "Generates a commit message using LLM."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Mandatory Tag: @PRE (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 36
              },
              {
                "message": "Missing Mandatory Tag: @POST (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 36
              },
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 36
              },
              {
                "message": "Missing Mandatory Tag: @PRE (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 36
              },
              {
                "message": "Missing Mandatory Tag: @POST (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 36
              },
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 36
              }
            ],
            "score": 0.26666666666666655
          }
        },
        {
          "name": "loadStatus",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 57,
          "end_line": 84,
          "tags": {
            "PURPOSE": "\u0417\u0430\u0433\u0440\u0443\u0436\u0430\u0435\u0442 \u0442\u0435\u043a\u0443\u0449\u0438\u0439 \u0441\u0442\u0430\u0442\u0443\u0441 \u0440\u0435\u043f\u043e\u0437\u0438\u0442\u043e\u0440\u0438\u044f \u0438 diff.",
            "PRE": "dashboardId \u0434\u043e\u043b\u0436\u0435\u043d \u0431\u044b\u0442\u044c \u0432\u0430\u043b\u0438\u0434\u043d\u044b\u043c."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Mandatory Tag: @POST (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 57
              },
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 57
              },
              {
                "message": "Missing Mandatory Tag: @POST (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 57
              },
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 57
              }
            ],
            "score": 0.5333333333333333
          }
        },
        {
          "name": "handleCommit",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 86,
          "end_line": 110,
          "tags": {
            "PURPOSE": "\u0421\u043e\u0437\u0434\u0430\u0435\u0442 \u043a\u043e\u043c\u043c\u0438\u0442 \u0441 \u0443\u043a\u0430\u0437\u0430\u043d\u043d\u044b\u043c \u0441\u043e\u043e\u0431\u0449\u0435\u043d\u0438\u0435\u043c.",
            "PRE": "message \u043d\u0435 \u0434\u043e\u043b\u0436\u043d\u043e \u0431\u044b\u0442\u044c \u043f\u0443\u0441\u0442\u044b\u043c.",
            "POST": "\u041a\u043e\u043c\u043c\u0438\u0442 \u0441\u043e\u0437\u0434\u0430\u043d, \u0441\u043e\u0431\u044b\u0442\u0438\u0435 \u043e\u0442\u043f\u0440\u0430\u0432\u043b\u0435\u043d\u043e, \u043c\u043e\u0434\u0430\u043b\u044c\u043d\u043e\u0435 \u043e\u043a\u043d\u043e \u0437\u0430\u043a\u0440\u044b\u0442\u043e."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 86
              },
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 86
              }
            ],
            "score": 0.8
          }
        }
      ],
      "compliance": {
        "valid": true,
        "issues": [
          {
            "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
            "severity": "WARNING",
            "line_number": 1
          }
        ],
        "score": 0.85
      },
      "props": [
        {
          "name": "dashboardId",
          "type": "any",
          "default": null
        },
        {
          "name": "show",
          "type": "any",
          "default": "false"
        }
      ],
      "events": [
        "commit"
      ]
    },
    {
      "name": "BranchSelector",
      "type": "Component",
      "tier": "STANDARD",
      "start_line": 1,
      "end_line": 178,
      "tags": {
        "SEMANTICS": "git, branch, selection, checkout",
        "PURPOSE": "UI \u0434\u043b\u044f \u0432\u044b\u0431\u043e\u0440\u0430 \u0438 \u0441\u043e\u0437\u0434\u0430\u043d\u0438\u044f \u0432\u0435\u0442\u043e\u043a Git.",
        "LAYER": "Component",
        "RELATION": "DISPATCHES -> change"
      },
      "relations": [],
      "children": [
        {
          "name": "onMount",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 35,
          "end_line": 44,
          "tags": {
            "PURPOSE": "Load branches when component is mounted.",
            "PRE": "Component is initialized.",
            "POST": "loadBranches is called."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 35
              },
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 35
              }
            ],
            "score": 0.8
          }
        },
        {
          "name": "loadBranches",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 46,
          "end_line": 65,
          "tags": {
            "PURPOSE": "\u0417\u0430\u0433\u0440\u0443\u0436\u0430\u0435\u0442 \u0441\u043f\u0438\u0441\u043e\u043a \u0432\u0435\u0442\u043e\u043a \u0434\u043b\u044f \u0434\u0430\u0448\u0431\u043e\u0440\u0434\u0430.",
            "PRE": "dashboardId is provided.",
            "POST": "branches \u043e\u0431\u043d\u043e\u0432\u043b\u0435\u043d."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 46
              },
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 46
              }
            ],
            "score": 0.8
          }
        },
        {
          "name": "handleSelect",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 67,
          "end_line": 76,
          "tags": {
            "PURPOSE": "Handles branch selection from dropdown.",
            "PRE": "event contains branch name.",
            "POST": "handleCheckout is called with selected branch."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 67
              },
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 67
              }
            ],
            "score": 0.8
          }
        },
        {
          "name": "handleCheckout",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 78,
          "end_line": 97,
          "tags": {
            "PURPOSE": "\u041f\u0435\u0440\u0435\u043a\u043b\u044e\u0447\u0430\u0435\u0442 \u0442\u0435\u043a\u0443\u0449\u0443\u044e \u0432\u0435\u0442\u043a\u0443.",
            "PARAM": "{string} branchName - \u0418\u043c\u044f \u0432\u0435\u0442\u043a\u0438.",
            "POST": "currentBranch \u043e\u0431\u043d\u043e\u0432\u043b\u0435\u043d, \u0441\u043e\u0431\u044b\u0442\u0438\u0435 \u043e\u0442\u043f\u0440\u0430\u0432\u043b\u0435\u043d\u043e."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Mandatory Tag: @PRE (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 78
              },
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 78
              },
              {
                "message": "Missing Mandatory Tag: @PRE (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 78
              },
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 78
              }
            ],
            "score": 0.5333333333333333
          }
        },
        {
          "name": "handleCreate",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 99,
          "end_line": 120,
          "tags": {
            "PURPOSE": "\u0421\u043e\u0437\u0434\u0430\u0435\u0442 \u043d\u043e\u0432\u0443\u044e \u0432\u0435\u0442\u043a\u0443.",
            "PRE": "newBranchName is not empty.",
            "POST": "\u041d\u043e\u0432\u0430\u044f \u0432\u0435\u0442\u043a\u0430 \u0441\u043e\u0437\u0434\u0430\u043d\u0430 \u0438 \u0437\u0430\u0433\u0440\u0443\u0436\u0435\u043d\u0430; showCreate reset."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 99
              },
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 99
              }
            ],
            "score": 0.8
          }
        }
      ],
      "compliance": {
        "valid": true,
        "issues": [
          {
            "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
            "severity": "WARNING",
            "line_number": 1
          }
        ],
        "score": 0.85
      },
      "props": [
        {
          "name": "dashboardId",
          "type": "any",
          "default": null
        },
        {
          "name": "currentBranch",
          "type": "any",
          "default": "'main'"
        }
      ],
      "events": [
        "change"
      ],
      "data_flow": [
        {
          "store": "t",
          "type": "READS_FROM",
          "line": 142
        },
        {
          "store": "t",
          "type": "READS_FROM",
          "line": 163
        },
        {
          "store": "t",
          "type": "READS_FROM",
          "line": 171
        }
      ]
    },
    {
      "name": "GitManager",
      "type": "Component",
      "tier": "STANDARD",
      "start_line": 1,
      "end_line": 300,
      "tags": {
        "SEMANTICS": "git, manager, dashboard, version_control, initialization",
        "PURPOSE": "\u0426\u0435\u043d\u0442\u0440\u0430\u043b\u044c\u043d\u044b\u0439 \u043a\u043e\u043c\u043f\u043e\u043d\u0435\u043d\u0442 \u0434\u043b\u044f \u0443\u043f\u0440\u0430\u0432\u043b\u0435\u043d\u0438\u044f Git-\u043e\u043f\u0435\u0440\u0430\u0446\u0438\u044f\u043c\u0438 \u043a\u043e\u043d\u043a\u0440\u0435\u0442\u043d\u043e\u0433\u043e \u0434\u0430\u0448\u0431\u043e\u0440\u0434\u0430.",
        "LAYER": "Component",
        "RELATION": "CALLS -> gitService"
      },
      "relations": [],
      "children": [
        {
          "name": "checkStatus",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 51,
          "end_line": 72,
          "tags": {
            "PURPOSE": "\u041f\u0440\u043e\u0432\u0435\u0440\u044f\u0435\u0442, \u0438\u043d\u0438\u0446\u0438\u0430\u043b\u0438\u0437\u0438\u0440\u043e\u0432\u0430\u043d \u043b\u0438 \u0440\u0435\u043f\u043e\u0437\u0438\u0442\u043e\u0440\u0438\u0439 \u0434\u043b\u044f \u0434\u0430\u043d\u043d\u043e\u0433\u043e \u0434\u0430\u0448\u0431\u043e\u0440\u0434\u0430.",
            "PRE": "Component is mounted and has dashboardId.",
            "POST": "initialized state is set; configs loaded if not initialized."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 51
              },
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 51
              }
            ],
            "score": 0.8
          }
        },
        {
          "name": "handleInit",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 74,
          "end_line": 96,
          "tags": {
            "PURPOSE": "\u0418\u043d\u0438\u0446\u0438\u0430\u043b\u0438\u0437\u0438\u0440\u0443\u0435\u0442 \u0440\u0435\u043f\u043e\u0437\u0438\u0442\u043e\u0440\u0438\u0439 \u0434\u043b\u044f \u0434\u0430\u0448\u0431\u043e\u0440\u0434\u0430.",
            "PRE": "selectedConfigId and remoteUrl are provided.",
            "POST": "Repository is created on backend; initialized set to true."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 74
              },
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 74
              }
            ],
            "score": 0.8
          }
        },
        {
          "name": "handleSync",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 98,
          "end_line": 117,
          "tags": {
            "PURPOSE": "\u0421\u0438\u043d\u0445\u0440\u043e\u043d\u0438\u0437\u0438\u0440\u0443\u0435\u0442 \u0441\u043e\u0441\u0442\u043e\u044f\u043d\u0438\u0435 Superset \u0441 \u043b\u043e\u043a\u0430\u043b\u044c\u043d\u044b\u043c Git-\u0440\u0435\u043f\u043e\u0437\u0438\u0442\u043e\u0440\u0438\u0435\u043c.",
            "PRE": "Repository is initialized.",
            "POST": "Dashboard YAMLs are exported to Git and staged."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 98
              },
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 98
              }
            ],
            "score": 0.8
          }
        },
        {
          "name": "handlePush",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 119,
          "end_line": 136,
          "tags": {
            "PURPOSE": "Pushes local commits to the remote repository.",
            "PRE": "Repository is initialized and has commits.",
            "POST": "Changes are pushed to origin."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 119
              },
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 119
              }
            ],
            "score": 0.8
          }
        },
        {
          "name": "handlePull",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 138,
          "end_line": 155,
          "tags": {
            "PURPOSE": "Pulls changes from the remote repository.",
            "PRE": "Repository is initialized.",
            "POST": "Local branch is updated with remote changes."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 138
              },
              {
                "message": "Missing Belief State Logging: Function should use console.log with [ID][STATE] (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 138
              }
            ],
            "score": 0.8
          }
        }
      ],
      "compliance": {
        "valid": true,
        "issues": [
          {
            "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
            "severity": "WARNING",
            "line_number": 1
          }
        ],
        "score": 0.85
      },
      "props": [
        {
          "name": "dashboardId",
          "type": "any",
          "default": null
        },
        {
          "name": "dashboardTitle",
          "type": "any",
          "default": "\"\""
        },
        {
          "name": "show",
          "type": "any",
          "default": "false"
        }
      ],
      "data_flow": [
        {
          "store": "t",
          "type": "WRITES_TO",
          "line": 164
        },
        {
          "store": "t",
          "type": "READS_FROM",
          "line": 183
        },
        {
          "store": "t",
          "type": "WRITES_TO",
          "line": 188
        },
        {
          "store": "t",
          "type": "WRITES_TO",
          "line": 197
        },
        {
          "store": "t",
          "type": "READS_FROM",
          "line": 208
        },
        {
          "store": "t",
          "type": "WRITES_TO",
          "line": 218
        },
        {
          "store": "t",
          "type": "WRITES_TO",
          "line": 223
        },
        {
          "store": "t",
          "type": "READS_FROM",
          "line": 230
        },
        {
          "store": "t",
          "type": "READS_FROM",
          "line": 237
        },
        {
          "store": "t",
          "type": "READS_FROM",
          "line": 246
        },
        {
          "store": "t",
          "type": "READS_FROM",
          "line": 254
        },
        {
          "store": "t",
          "type": "WRITES_TO",
          "line": 260
        },
        {
          "store": "t",
          "type": "READS_FROM",
          "line": 267
        }
      ]
    },
    {
      "name": "DocPreview",
      "type": "Component",
      "tier": "STANDARD",
      "start_line": 1,
      "end_line": 79,
      "tags": {
        "TIER": "STANDARD",
        "PURPOSE": "UI component for previewing generated dataset documentation before saving.",
        "LAYER": "UI",
        "RELATION": "DEPENDS_ON -> backend/src/plugins/llm_analysis/plugin.py",
        "TYPE": "{Object} */"
      },
      "relations": [],
      "children": [],
      "compliance": {
        "valid": true,
        "issues": [
          {
            "message": "Missing Mandatory Tag: @SEMANTICS (required for STANDARD tier)",
            "severity": "WARNING",
            "line_number": 1
          }
        ],
        "score": 0.85
      },
      "props": [
        {
          "name": "documentation",
          "type": "any",
          "default": "null"
        },
        {
          "name": "onSave",
          "type": "any",
          "default": "async (doc) => {}"
        },
        {
          "name": "onCancel",
          "type": "any",
          "default": "() => {}"
        }
      ],
      "data_flow": [
        {
          "store": "t",
          "type": "WRITES_TO",
          "line": 34
        },
        {
          "store": "t",
          "type": "WRITES_TO",
          "line": 37
        },
        {
          "store": "t",
          "type": "WRITES_TO",
          "line": 40
        },
        {
          "store": "t",
          "type": "READS_FROM",
          "line": 65
        },
        {
          "store": "t",
          "type": "READS_FROM",
          "line": 72
        },
        {
          "store": "t",
          "type": "READS_FROM",
          "line": 72
        }
      ]
    },
    {
      "name": "DocPreview",
      "type": "Module",
      "tier": "TRIVIAL",
      "start_line": 1,
      "end_line": 79,
      "tags": {
        "PURPOSE": "Auto-generated module for frontend/src/components/llm/DocPreview.svelte",
        "TIER": "TRIVIAL",
        "LAYER": "Unknown"
      },
      "relations": [],
      "children": [
        {
          "name": "handleSave",
          "type": "Function",
          "tier": "TRIVIAL",
          "start_line": 19,
          "end_line": 19,
          "tags": {
            "PURPOSE": "Auto-detected function (orphan)",
            "TIER": "TRIVIAL"
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        }
      ],
      "compliance": {
        "valid": true,
        "issues": [],
        "score": 1.0
      }
    },
    {
      "name": "ProviderConfig",
      "type": "Component",
      "tier": "STANDARD",
      "start_line": 1,
      "end_line": 219,
      "tags": {
        "TIER": "STANDARD",
        "PURPOSE": "UI form for managing LLM provider configurations.",
        "LAYER": "UI",
        "RELATION": "DEPENDS_ON -> backend/src/api/routes/llm.py",
        "TYPE": "{Array} */"
      },
      "relations": [],
      "children": [],
      "compliance": {
        "valid": true,
        "issues": [
          {
            "message": "Missing Mandatory Tag: @SEMANTICS (required for STANDARD tier)",
            "severity": "WARNING",
            "line_number": 1
          }
        ],
        "score": 0.85
      },
      "props": [
        {
          "name": "providers",
          "type": "any",
          "default": "[]"
        },
        {
          "name": "onSave",
          "type": "any",
          "default": "() => {}"
        }
      ],
      "data_flow": [
        {
          "store": "t",
          "type": "WRITES_TO",
          "line": 55
        },
        {
          "store": "t",
          "type": "WRITES_TO",
          "line": 62
        },
        {
          "store": "t",
          "type": "WRITES_TO",
          "line": 64
        },
        {
          "store": "t",
          "type": "WRITES_TO",
          "line": 67
        },
        {
          "store": "t",
          "type": "WRITES_TO",
          "line": 103
        },
        {
          "store": "t",
          "type": "READS_FROM",
          "line": 108
        },
        {
          "store": "t",
          "type": "WRITES_TO",
          "line": 115
        },
        {
          "store": "t",
          "type": "WRITES_TO",
          "line": 115
        },
        {
          "store": "t",
          "type": "WRITES_TO",
          "line": 119
        },
        {
          "store": "t",
          "type": "WRITES_TO",
          "line": 124
        },
        {
          "store": "t",
          "type": "WRITES_TO",
          "line": 133
        },
        {
          "store": "t",
          "type": "WRITES_TO",
          "line": 138
        },
        {
          "store": "t",
          "type": "WRITES_TO",
          "line": 143
        },
        {
          "store": "t",
          "type": "WRITES_TO",
          "line": 149
        },
        {
          "store": "t",
          "type": "READS_FROM",
          "line": 164
        },
        {
          "store": "t",
          "type": "READS_FROM",
          "line": 171
        },
        {
          "store": "t",
          "type": "READS_FROM",
          "line": 171
        },
        {
          "store": "t",
          "type": "READS_FROM",
          "line": 177
        },
        {
          "store": "t",
          "type": "READS_FROM",
          "line": 191
        },
        {
          "store": "t",
          "type": "READS_FROM",
          "line": 201
        },
        {
          "store": "t",
          "type": "READS_FROM",
          "line": 213
        }
      ]
    },
    {
      "name": "ProviderConfig",
      "type": "Module",
      "tier": "TRIVIAL",
      "start_line": 1,
      "end_line": 219,
      "tags": {
        "PURPOSE": "Auto-generated module for frontend/src/components/llm/ProviderConfig.svelte",
        "TIER": "TRIVIAL",
        "LAYER": "Unknown"
      },
      "relations": [],
      "children": [
        {
          "name": "resetForm",
          "type": "Function",
          "tier": "TRIVIAL",
          "start_line": 33,
          "end_line": 33,
          "tags": {
            "PURPOSE": "Auto-detected function (orphan)",
            "TIER": "TRIVIAL"
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "handleEdit",
          "type": "Function",
          "tier": "TRIVIAL",
          "start_line": 46,
          "end_line": 46,
          "tags": {
            "PURPOSE": "Auto-detected function (orphan)",
            "TIER": "TRIVIAL"
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "testConnection",
          "type": "Function",
          "tier": "TRIVIAL",
          "start_line": 52,
          "end_line": 52,
          "tags": {
            "PURPOSE": "Auto-detected function (orphan)",
            "TIER": "TRIVIAL"
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "handleSubmit",
          "type": "Function",
          "tier": "TRIVIAL",
          "start_line": 73,
          "end_line": 73,
          "tags": {
            "PURPOSE": "Auto-detected function (orphan)",
            "TIER": "TRIVIAL"
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "toggleActive",
          "type": "Function",
          "tier": "TRIVIAL",
          "start_line": 88,
          "end_line": 88,
          "tags": {
            "PURPOSE": "Auto-detected function (orphan)",
            "TIER": "TRIVIAL"
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        }
      ],
      "compliance": {
        "valid": true,
        "issues": [],
        "score": 1.0
      }
    },
    {
      "name": "ValidationReport",
      "type": "Module",
      "tier": "TRIVIAL",
      "start_line": 1,
      "end_line": 75,
      "tags": {
        "PURPOSE": "Auto-generated module for frontend/src/components/llm/ValidationReport.svelte",
        "TIER": "TRIVIAL",
        "LAYER": "Unknown"
      },
      "relations": [],
      "children": [
        {
          "name": "getStatusColor",
          "type": "Function",
          "tier": "TRIVIAL",
          "start_line": 8,
          "end_line": 8,
          "tags": {
            "PURPOSE": "Auto-detected function (orphan)",
            "TIER": "TRIVIAL"
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        }
      ],
      "compliance": {
        "valid": true,
        "issues": [],
        "score": 1.0
      }
    },
    {
      "name": "backend.delete_running_tasks",
      "type": "Module",
      "tier": "STANDARD",
      "start_line": 2,
      "end_line": 44,
      "tags": {
        "PURPOSE": "Script to delete tasks with RUNNING status from the database.",
        "LAYER": "Utility",
        "SEMANTICS": "maintenance, database, cleanup"
      },
      "relations": [],
      "children": [
        {
          "name": "delete_running_tasks",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 11,
          "end_line": 40,
          "tags": {
            "PURPOSE": "Delete all tasks with RUNNING status from the database.",
            "PRE": "Database is accessible and TaskRecord model is defined.",
            "POST": "All tasks with status 'RUNNING' are removed from the database."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Belief State Logging: Function should use belief_scope (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 11
              },
              {
                "message": "Missing Belief State Logging: Function should use belief_scope (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 11
              }
            ],
            "score": 0.8
          }
        }
      ],
      "compliance": {
        "valid": true,
        "issues": [
          {
            "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
            "severity": "WARNING",
            "line_number": 2
          }
        ],
        "score": 0.85
      }
    },
    {
      "name": "AppModule",
      "type": "Module",
      "tier": "STANDARD",
      "start_line": 1,
      "end_line": 216,
      "tags": {
        "SEMANTICS": "app, main, entrypoint, fastapi",
        "PURPOSE": "The main entry point for the FastAPI application. It initializes the app, configures CORS, sets up dependencies, includes API routers, and defines the WebSocket endpoint for log streaming.",
        "LAYER": "UI (API)",
        "RELATION": "Depends on the dependency module and API route modules."
      },
      "relations": [],
      "children": [
        {
          "name": "App",
          "type": "Global",
          "tier": "STANDARD",
          "start_line": 27,
          "end_line": 35,
          "tags": {
            "SEMANTICS": "app, fastapi, instance",
            "PURPOSE": "The global FastAPI application instance."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "startup_event",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 37,
          "end_line": 47,
          "tags": {
            "PURPOSE": "Handles application startup tasks, such as starting the scheduler.",
            "PRE": "None.",
            "POST": "Scheduler is started."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "shutdown_event",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 49,
          "end_line": 59,
          "tags": {
            "PURPOSE": "Handles application shutdown tasks, such as stopping the scheduler.",
            "PRE": "None.",
            "POST": "Scheduler is stopped."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "log_requests",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 75,
          "end_line": 104,
          "tags": {
            "PURPOSE": "Middleware to log incoming HTTP requests and their response status.",
            "PRE": "request is a FastAPI Request object.",
            "POST": "Logs request and response details.",
            "PARAM": "call_next (Callable) - The next middleware or route handler."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "websocket_endpoint",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 120,
          "end_line": 177,
          "tags": {
            "PURPOSE": "Provides a WebSocket endpoint for real-time log streaming of a task.",
            "PRE": "task_id must be a valid task ID.",
            "POST": "WebSocket connection is managed and logs are streamed until disconnect."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "StaticFiles",
          "type": "Mount",
          "tier": "STANDARD",
          "start_line": 179,
          "end_line": 215,
          "tags": {
            "SEMANTICS": "static, frontend, spa",
            "PURPOSE": "Mounts the frontend build directory to serve static assets."
          },
          "relations": [],
          "children": [
            {
              "name": "serve_spa",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 187,
              "end_line": 204,
              "tags": {
                "PURPOSE": "Serves frontend static files or index.html for SPA routing.",
                "PRE": "file_path is requested by the client.",
                "POST": "Returns the requested file or index.html as a fallback."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            },
            {
              "name": "read_root",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 206,
              "end_line": 214,
              "tags": {
                "PURPOSE": "A simple root endpoint to confirm that the API is running when frontend is missing.",
                "PRE": "None.",
                "POST": "Returns a JSON message indicating API status."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            }
          ],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "network_error_handler",
          "type": "Function",
          "tier": "TRIVIAL",
          "start_line": 82,
          "end_line": 82,
          "tags": {
            "PURPOSE": "Auto-detected function (orphan)",
            "TIER": "TRIVIAL"
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        }
      ],
      "compliance": {
        "valid": true,
        "issues": [
          {
            "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
            "severity": "WARNING",
            "line_number": 1
          }
        ],
        "score": 0.85
      }
    },
    {
      "name": "Dependencies",
      "type": "Module",
      "tier": "STANDARD",
      "start_line": 1,
      "end_line": 153,
      "tags": {
        "SEMANTICS": "dependency, injection, singleton, factory, auth, jwt",
        "PURPOSE": "Manages the creation and provision of shared application dependencies, such as the PluginLoader and TaskManager, to avoid circular imports.",
        "LAYER": "Core",
        "RELATION": "Used by the main app and API routers to get access to shared instances."
      },
      "relations": [],
      "children": [
        {
          "name": "get_config_manager",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 31,
          "end_line": 40,
          "tags": {
            "PURPOSE": "Dependency injector for the ConfigManager.",
            "PRE": "Global config_manager must be initialized.",
            "POST": "Returns shared ConfigManager instance.",
            "RETURN": "ConfigManager - The shared config manager instance."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "get_plugin_loader",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 54,
          "end_line": 63,
          "tags": {
            "PURPOSE": "Dependency injector for the PluginLoader.",
            "PRE": "Global plugin_loader must be initialized.",
            "POST": "Returns shared PluginLoader instance.",
            "RETURN": "PluginLoader - The shared plugin loader instance."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "get_task_manager",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 65,
          "end_line": 74,
          "tags": {
            "PURPOSE": "Dependency injector for the TaskManager.",
            "PRE": "Global task_manager must be initialized.",
            "POST": "Returns shared TaskManager instance.",
            "RETURN": "TaskManager - The shared task manager instance."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "get_scheduler_service",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 76,
          "end_line": 85,
          "tags": {
            "PURPOSE": "Dependency injector for the SchedulerService.",
            "PRE": "Global scheduler_service must be initialized.",
            "POST": "Returns shared SchedulerService instance.",
            "RETURN": "SchedulerService - The shared scheduler service instance."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "oauth2_scheme",
          "type": "Variable",
          "tier": "STANDARD",
          "start_line": 87,
          "end_line": 90,
          "tags": {
            "PURPOSE": "OAuth2 password bearer scheme for token extraction."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "get_current_user",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 92,
          "end_line": 120,
          "tags": {
            "PURPOSE": "Dependency for retrieving the currently authenticated user from a JWT.",
            "PRE": "JWT token provided in Authorization header.",
            "POST": "Returns the User object if token is valid.",
            "THROW": "HTTPException 401 if token is invalid or user not found.",
            "PARAM": "db (Session) - Auth database session.",
            "RETURN": "User - The authenticated user."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "has_permission",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 122,
          "end_line": 151,
          "tags": {
            "PURPOSE": "Dependency for checking if the current user has a specific permission.",
            "PRE": "User is authenticated.",
            "POST": "Returns True if user has permission.",
            "THROW": "HTTPException 403 if permission is denied.",
            "PARAM": "action (str) - The action identifier (READ, EXECUTE, WRITE).",
            "RETURN": "User - The authenticated user if permission granted."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "permission_checker",
          "type": "Function",
          "tier": "TRIVIAL",
          "start_line": 131,
          "end_line": 131,
          "tags": {
            "PURPOSE": "Auto-detected function (orphan)",
            "TIER": "TRIVIAL"
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        }
      ],
      "compliance": {
        "valid": true,
        "issues": [
          {
            "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
            "severity": "WARNING",
            "line_number": 1
          }
        ],
        "score": 0.85
      }
    },
    {
      "name": "backend.src.scripts.seed_permissions",
      "type": "Module",
      "tier": "STANDARD",
      "start_line": 1,
      "end_line": 116,
      "tags": {
        "SEMANTICS": "setup, database, auth, permissions, seeding",
        "PURPOSE": "Populates the auth database with initial system permissions.",
        "LAYER": "Scripts",
        "INVARIANT": "Safe to run multiple times (idempotent)."
      },
      "relations": [
        {
          "type": "USES",
          "target": "backend.src.core.database.get_auth_db"
        },
        {
          "type": "USES",
          "target": "backend.src.models.auth.Permission"
        }
      ],
      "children": [
        {
          "name": "INITIAL_PERMISSIONS",
          "type": "Constant",
          "tier": "STANDARD",
          "start_line": 24,
          "end_line": 49,
          "tags": {},
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "seed_permissions",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 51,
          "end_line": 111,
          "tags": {
            "PURPOSE": "Inserts missing permissions into the database.",
            "POST": "All INITIAL_PERMISSIONS exist in the DB."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Mandatory Tag: @PRE (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 51
              },
              {
                "message": "Missing Mandatory Tag: @PRE (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 51
              }
            ],
            "score": 0.7333333333333334
          }
        }
      ],
      "compliance": {
        "valid": true,
        "issues": [
          {
            "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
            "severity": "WARNING",
            "line_number": 1
          }
        ],
        "score": 0.85
      }
    },
    {
      "name": "backend.src.scripts.init_auth_db",
      "type": "Module",
      "tier": "STANDARD",
      "start_line": 1,
      "end_line": 44,
      "tags": {
        "SEMANTICS": "setup, database, auth, migration",
        "PURPOSE": "Initializes the auth database and creates the necessary tables.",
        "LAYER": "Scripts",
        "INVARIANT": "Safe to run multiple times (idempotent)."
      },
      "relations": [
        {
          "type": "CALLS",
          "target": "backend.src.core.database.init_db"
        }
      ],
      "children": [
        {
          "name": "run_init",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 23,
          "end_line": 39,
          "tags": {
            "PURPOSE": "Main entry point for the initialization script.",
            "POST": "auth.db is initialized with the correct schema and seeded permissions."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Mandatory Tag: @PRE (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 23
              },
              {
                "message": "Missing Mandatory Tag: @PRE (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 23
              }
            ],
            "score": 0.7333333333333334
          }
        }
      ],
      "compliance": {
        "valid": true,
        "issues": [
          {
            "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
            "severity": "WARNING",
            "line_number": 1
          }
        ],
        "score": 0.85
      }
    },
    {
      "name": "backend.src.scripts.create_admin",
      "type": "Module",
      "tier": "STANDARD",
      "start_line": 1,
      "end_line": 82,
      "tags": {
        "SEMANTICS": "admin, setup, user, auth, cli",
        "PURPOSE": "CLI tool for creating the initial admin user.",
        "LAYER": "Scripts",
        "INVARIANT": "Admin user must have the \"Admin\" role."
      },
      "relations": [
        {
          "type": "USES",
          "target": "backend.src.core.auth.security"
        },
        {
          "type": "USES",
          "target": "backend.src.core.database"
        },
        {
          "type": "USES",
          "target": "backend.src.models.auth"
        }
      ],
      "children": [
        {
          "name": "create_admin",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 26,
          "end_line": 70,
          "tags": {
            "PURPOSE": "Creates an admin user and necessary roles/permissions.",
            "PRE": "username and password provided via CLI.",
            "POST": "Admin user exists in auth.db.",
            "PARAM": "password (str) - Admin password."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        }
      ],
      "compliance": {
        "valid": true,
        "issues": [
          {
            "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
            "severity": "WARNING",
            "line_number": 1
          }
        ],
        "score": 0.85
      }
    },
    {
      "name": "backend.src.schemas.auth",
      "type": "Module",
      "tier": "STANDARD",
      "start_line": 1,
      "end_line": 128,
      "tags": {
        "TIER": "STANDARD",
        "SEMANTICS": "auth, schemas, pydantic, user, token",
        "PURPOSE": "Pydantic schemas for authentication requests and responses.",
        "LAYER": "API",
        "INVARIANT": "Sensitive fields like password must not be included in response schemas."
      },
      "relations": [
        {
          "type": "DEPENDS_ON",
          "target": "pydantic"
        }
      ],
      "children": [
        {
          "name": "Token",
          "type": "Class",
          "tier": "TRIVIAL",
          "start_line": 17,
          "end_line": 23,
          "tags": {
            "TIER": "TRIVIAL",
            "PURPOSE": "Represents a JWT access token response."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "TokenData",
          "type": "Class",
          "tier": "TRIVIAL",
          "start_line": 25,
          "end_line": 31,
          "tags": {
            "TIER": "TRIVIAL",
            "PURPOSE": "Represents the data encoded in a JWT token."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "PermissionSchema",
          "type": "Class",
          "tier": "TRIVIAL",
          "start_line": 33,
          "end_line": 43,
          "tags": {
            "TIER": "TRIVIAL",
            "PURPOSE": "Represents a permission in API responses."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "RoleSchema",
          "type": "Class",
          "tier": "STANDARD",
          "start_line": 45,
          "end_line": 55,
          "tags": {
            "PURPOSE": "Represents a role in API responses."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 45
              },
              {
                "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 45
              }
            ],
            "score": 0.7000000000000001
          }
        },
        {
          "name": "RoleCreate",
          "type": "Class",
          "tier": "STANDARD",
          "start_line": 57,
          "end_line": 63,
          "tags": {
            "PURPOSE": "Schema for creating a new role."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 57
              },
              {
                "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 57
              }
            ],
            "score": 0.7000000000000001
          }
        },
        {
          "name": "RoleUpdate",
          "type": "Class",
          "tier": "STANDARD",
          "start_line": 65,
          "end_line": 71,
          "tags": {
            "PURPOSE": "Schema for updating an existing role."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 65
              },
              {
                "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 65
              }
            ],
            "score": 0.7000000000000001
          }
        },
        {
          "name": "ADGroupMappingSchema",
          "type": "Class",
          "tier": "STANDARD",
          "start_line": 73,
          "end_line": 82,
          "tags": {
            "PURPOSE": "Represents an AD Group to Role mapping in API responses."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 73
              },
              {
                "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 73
              }
            ],
            "score": 0.7000000000000001
          }
        },
        {
          "name": "ADGroupMappingCreate",
          "type": "Class",
          "tier": "STANDARD",
          "start_line": 84,
          "end_line": 89,
          "tags": {
            "PURPOSE": "Schema for creating an AD Group mapping."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 84
              },
              {
                "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 84
              }
            ],
            "score": 0.7000000000000001
          }
        },
        {
          "name": "UserBase",
          "type": "Class",
          "tier": "STANDARD",
          "start_line": 91,
          "end_line": 97,
          "tags": {
            "PURPOSE": "Base schema for user data."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 91
              },
              {
                "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 91
              }
            ],
            "score": 0.7000000000000001
          }
        },
        {
          "name": "UserCreate",
          "type": "Class",
          "tier": "STANDARD",
          "start_line": 99,
          "end_line": 104,
          "tags": {
            "PURPOSE": "Schema for creating a new user."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 99
              },
              {
                "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 99
              }
            ],
            "score": 0.7000000000000001
          }
        },
        {
          "name": "UserUpdate",
          "type": "Class",
          "tier": "STANDARD",
          "start_line": 106,
          "end_line": 113,
          "tags": {
            "PURPOSE": "Schema for updating an existing user."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 106
              },
              {
                "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 106
              }
            ],
            "score": 0.7000000000000001
          }
        },
        {
          "name": "User",
          "type": "Class",
          "tier": "STANDARD",
          "start_line": 115,
          "end_line": 126,
          "tags": {
            "PURPOSE": "Schema for user data in API responses."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 115
              },
              {
                "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 115
              }
            ],
            "score": 0.7000000000000001
          }
        }
      ],
      "compliance": {
        "valid": true,
        "issues": [],
        "score": 1.0
      }
    },
    {
      "name": "backend.src.core.superset_client",
      "type": "Module",
      "tier": "STANDARD",
      "start_line": 1,
      "end_line": 450,
      "tags": {
        "SEMANTICS": "superset, api, client, rest, http, dashboard, dataset, import, export",
        "PURPOSE": "\u041f\u0440\u0435\u0434\u043e\u0441\u0442\u0430\u0432\u043b\u044f\u0435\u0442 \u0432\u044b\u0441\u043e\u043a\u043e\u0443\u0440\u043e\u0432\u043d\u0435\u0432\u044b\u0439 \u043a\u043b\u0438\u0435\u043d\u0442 \u0434\u043b\u044f \u0432\u0437\u0430\u0438\u043c\u043e\u0434\u0435\u0439\u0441\u0442\u0432\u0438\u044f \u0441 Superset REST API, \u0438\u043d\u043a\u0430\u043f\u0441\u0443\u043b\u0438\u0440\u0443\u044f \u043b\u043e\u0433\u0438\u043a\u0443 \u0437\u0430\u043f\u0440\u043e\u0441\u043e\u0432, \u043e\u0431\u0440\u0430\u0431\u043e\u0442\u043a\u0443 \u043e\u0448\u0438\u0431\u043e\u043a \u0438 \u043f\u0430\u0433\u0438\u043d\u0430\u0446\u0438\u044e.",
        "LAYER": "Core",
        "INVARIANT": "All network operations must use the internal APIClient instance.",
        "PUBLIC_API": "SupersetClient"
      },
      "relations": [
        {
          "type": "USES",
          "target": "backend.src.core.utils.network.APIClient"
        },
        {
          "type": "USES",
          "target": "backend.src.core.config_models.Environment"
        }
      ],
      "children": [
        {
          "name": "SupersetClient",
          "type": "Class",
          "tier": "STANDARD",
          "start_line": 24,
          "end_line": 448,
          "tags": {
            "PURPOSE": "\u041a\u043b\u0430\u0441\u0441-\u043e\u0431\u0451\u0440\u0442\u043a\u0430 \u043d\u0430\u0434 Superset REST API, \u043f\u0440\u0435\u0434\u043e\u0441\u0442\u0430\u0432\u043b\u044f\u044e\u0449\u0438\u0439 \u043c\u0435\u0442\u043e\u0434\u044b \u0434\u043b\u044f \u0440\u0430\u0431\u043e\u0442\u044b \u0441 \u0434\u0430\u0448\u0431\u043e\u0440\u0434\u0430\u043c\u0438 \u0438 \u0434\u0430\u0442\u0430\u0441\u0435\u0442\u0430\u043c\u0438."
          },
          "relations": [],
          "children": [
            {
              "name": "__init__",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 27,
              "end_line": 53,
              "tags": {
                "PURPOSE": "\u0418\u043d\u0438\u0446\u0438\u0430\u043b\u0438\u0437\u0438\u0440\u0443\u0435\u0442 \u043a\u043b\u0438\u0435\u043d\u0442, \u043f\u0440\u043e\u0432\u0435\u0440\u044f\u0435\u0442 \u043a\u043e\u043d\u0444\u0438\u0433\u0443\u0440\u0430\u0446\u0438\u044e \u0438 \u0441\u043e\u0437\u0434\u0430\u0435\u0442 \u0441\u0435\u0442\u0435\u0432\u043e\u0439 \u043a\u043b\u0438\u0435\u043d\u0442.",
                "PRE": "`env` \u0434\u043e\u043b\u0436\u0435\u043d \u0431\u044b\u0442\u044c \u0432\u0430\u043b\u0438\u0434\u043d\u044b\u043c \u043e\u0431\u044a\u0435\u043a\u0442\u043e\u043c Environment.",
                "POST": "\u0410\u0442\u0440\u0438\u0431\u0443\u0442\u044b `env` \u0438 `network` \u0441\u043e\u0437\u0434\u0430\u043d\u044b \u0438 \u0433\u043e\u0442\u043e\u0432\u044b \u043a \u0440\u0430\u0431\u043e\u0442\u0435.",
                "PARAM": "env (Environment) - \u041a\u043e\u043d\u0444\u0438\u0433\u0443\u0440\u0430\u0446\u0438\u044f \u043e\u043a\u0440\u0443\u0436\u0435\u043d\u0438\u044f."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            },
            {
              "name": "authenticate",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 55,
              "end_line": 63,
              "tags": {
                "PURPOSE": "Authenticates the client using the configured credentials.",
                "PRE": "self.network must be initialized with valid auth configuration.",
                "POST": "Client is authenticated and tokens are stored.",
                "RETURN": "Dict[str, str] - Authentication tokens."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            },
            {
              "name": "headers",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 66,
              "end_line": 73,
              "tags": {
                "PURPOSE": "\u0412\u043e\u0437\u0432\u0440\u0430\u0449\u0430\u0435\u0442 \u0431\u0430\u0437\u043e\u0432\u044b\u0435 HTTP-\u0437\u0430\u0433\u043e\u043b\u043e\u0432\u043a\u0438, \u0438\u0441\u043f\u043e\u043b\u044c\u0437\u0443\u0435\u043c\u044b\u0435 \u0441\u0435\u0442\u0435\u0432\u044b\u043c \u043a\u043b\u0438\u0435\u043d\u0442\u043e\u043c.",
                "PRE": "APIClient is initialized and authenticated.",
                "POST": "Returns a dictionary of HTTP headers."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            },
            {
              "name": "get_dashboards",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 77,
              "end_line": 97,
              "tags": {
                "PURPOSE": "\u041f\u043e\u043b\u0443\u0447\u0430\u0435\u0442 \u043f\u043e\u043b\u043d\u044b\u0439 \u0441\u043f\u0438\u0441\u043e\u043a \u0434\u0430\u0448\u0431\u043e\u0440\u0434\u043e\u0432, \u0430\u0432\u0442\u043e\u043c\u0430\u0442\u0438\u0447\u0435\u0441\u043a\u0438 \u043e\u0431\u0440\u0430\u0431\u0430\u0442\u044b\u0432\u0430\u044f \u043f\u0430\u0433\u0438\u043d\u0430\u0446\u0438\u044e.",
                "PARAM": "query (Optional[Dict]) - \u0414\u043e\u043f\u043e\u043b\u043d\u0438\u0442\u0435\u043b\u044c\u043d\u044b\u0435 \u043f\u0430\u0440\u0430\u043c\u0435\u0442\u0440\u044b \u0437\u0430\u043f\u0440\u043e\u0441\u0430 \u0434\u043b\u044f API.",
                "PRE": "Client is authenticated.",
                "POST": "Returns a tuple with total count and list of dashboards.",
                "RETURN": "Tuple[int, List[Dict]] - \u041a\u043e\u0440\u0442\u0435\u0436 (\u043e\u0431\u0449\u0435\u0435 \u043a\u043e\u043b\u0438\u0447\u0435\u0441\u0442\u0432\u043e, \u0441\u043f\u0438\u0441\u043e\u043a \u0434\u0430\u0448\u0431\u043e\u0440\u0434\u043e\u0432)."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            },
            {
              "name": "get_dashboards_summary",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 99,
              "end_line": 121,
              "tags": {
                "PURPOSE": "Fetches dashboard metadata optimized for the grid.",
                "PRE": "Client is authenticated.",
                "POST": "Returns a list of dashboard metadata summaries.",
                "RETURN": "List[Dict]"
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            },
            {
              "name": "export_dashboard",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 123,
              "end_line": 144,
              "tags": {
                "PURPOSE": "\u042d\u043a\u0441\u043f\u043e\u0440\u0442\u0438\u0440\u0443\u0435\u0442 \u0434\u0430\u0448\u0431\u043e\u0440\u0434 \u0432 \u0432\u0438\u0434\u0435 ZIP-\u0430\u0440\u0445\u0438\u0432\u0430.",
                "PARAM": "dashboard_id (int) - ID \u0434\u0430\u0448\u0431\u043e\u0440\u0434\u0430 \u0434\u043b\u044f \u044d\u043a\u0441\u043f\u043e\u0440\u0442\u0430.",
                "PRE": "dashboard_id must exist in Superset.",
                "POST": "Returns ZIP content and filename.",
                "RETURN": "Tuple[bytes, str] - \u0411\u0438\u043d\u0430\u0440\u043d\u043e\u0435 \u0441\u043e\u0434\u0435\u0440\u0436\u0438\u043c\u043e\u0435 ZIP-\u0430\u0440\u0445\u0438\u0432\u0430 \u0438 \u0438\u043c\u044f \u0444\u0430\u0439\u043b\u0430."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            },
            {
              "name": "import_dashboard",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 146,
              "end_line": 173,
              "tags": {
                "PURPOSE": "\u0418\u043c\u043f\u043e\u0440\u0442\u0438\u0440\u0443\u0435\u0442 \u0434\u0430\u0448\u0431\u043e\u0440\u0434 \u0438\u0437 ZIP-\u0444\u0430\u0439\u043b\u0430.",
                "PARAM": "dash_slug (Optional[str]) - Slug \u0434\u0430\u0448\u0431\u043e\u0440\u0434\u0430 \u0434\u043b\u044f \u043f\u043e\u0438\u0441\u043a\u0430 ID.",
                "PRE": "file_name must be a valid ZIP dashboard export.",
                "POST": "Dashboard is imported or re-imported after deletion.",
                "RETURN": "Dict - \u041e\u0442\u0432\u0435\u0442 API \u0432 \u0441\u043b\u0443\u0447\u0430\u0435 \u0443\u0441\u043f\u0435\u0445\u0430."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            },
            {
              "name": "delete_dashboard",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 175,
              "end_line": 189,
              "tags": {
                "PURPOSE": "\u0423\u0434\u0430\u043b\u044f\u0435\u0442 \u0434\u0430\u0448\u0431\u043e\u0440\u0434 \u043f\u043e \u0435\u0433\u043e ID \u0438\u043b\u0438 slug.",
                "PARAM": "dashboard_id (Union[int, str]) - ID \u0438\u043b\u0438 slug \u0434\u0430\u0448\u0431\u043e\u0440\u0434\u0430.",
                "PRE": "dashboard_id must exist.",
                "POST": "Dashboard is removed from Superset."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            },
            {
              "name": "get_datasets",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 195,
              "end_line": 213,
              "tags": {
                "PURPOSE": "\u041f\u043e\u043b\u0443\u0447\u0430\u0435\u0442 \u043f\u043e\u043b\u043d\u044b\u0439 \u0441\u043f\u0438\u0441\u043e\u043a \u0434\u0430\u0442\u0430\u0441\u0435\u0442\u043e\u0432, \u0430\u0432\u0442\u043e\u043c\u0430\u0442\u0438\u0447\u0435\u0441\u043a\u0438 \u043e\u0431\u0440\u0430\u0431\u0430\u0442\u044b\u0432\u0430\u044f \u043f\u0430\u0433\u0438\u043d\u0430\u0446\u0438\u044e.",
                "PARAM": "query (Optional[Dict]) - \u0414\u043e\u043f\u043e\u043b\u043d\u0438\u0442\u0435\u043b\u044c\u043d\u044b\u0435 \u043f\u0430\u0440\u0430\u043c\u0435\u0442\u0440\u044b \u0437\u0430\u043f\u0440\u043e\u0441\u0430.",
                "PRE": "Client is authenticated.",
                "POST": "Returns total count and list of datasets.",
                "RETURN": "Tuple[int, List[Dict]] - \u041a\u043e\u0440\u0442\u0435\u0436 (\u043e\u0431\u0449\u0435\u0435 \u043a\u043e\u043b\u0438\u0447\u0435\u0441\u0442\u0432\u043e, \u0441\u043f\u0438\u0441\u043e\u043a \u0434\u0430\u0442\u0430\u0441\u0435\u0442\u043e\u0432)."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            },
            {
              "name": "get_dataset",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 215,
              "end_line": 228,
              "tags": {
                "PURPOSE": "\u041f\u043e\u043b\u0443\u0447\u0430\u0435\u0442 \u0438\u043d\u0444\u043e\u0440\u043c\u0430\u0446\u0438\u044e \u043e \u043a\u043e\u043d\u043a\u0440\u0435\u0442\u043d\u043e\u043c \u0434\u0430\u0442\u0430\u0441\u0435\u0442\u0435 \u043f\u043e \u0435\u0433\u043e ID.",
                "PARAM": "dataset_id (int) - ID \u0434\u0430\u0442\u0430\u0441\u0435\u0442\u0430.",
                "PRE": "dataset_id must exist.",
                "POST": "Returns dataset details.",
                "RETURN": "Dict - \u0418\u043d\u0444\u043e\u0440\u043c\u0430\u0446\u0438\u044f \u043e \u0434\u0430\u0442\u0430\u0441\u0435\u0442\u0435."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            },
            {
              "name": "update_dataset",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 230,
              "end_line": 249,
              "tags": {
                "PURPOSE": "\u041e\u0431\u043d\u043e\u0432\u043b\u044f\u0435\u0442 \u0434\u0430\u043d\u043d\u044b\u0435 \u0434\u0430\u0442\u0430\u0441\u0435\u0442\u0430 \u043f\u043e \u0435\u0433\u043e ID.",
                "PARAM": "data (Dict) - \u0414\u0430\u043d\u043d\u044b\u0435 \u0434\u043b\u044f \u043e\u0431\u043d\u043e\u0432\u043b\u0435\u043d\u0438\u044f.",
                "PRE": "dataset_id must exist.",
                "POST": "Dataset is updated in Superset.",
                "RETURN": "Dict - \u041e\u0442\u0432\u0435\u0442 API."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            },
            {
              "name": "get_databases",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 255,
              "end_line": 274,
              "tags": {
                "PURPOSE": "\u041f\u043e\u043b\u0443\u0447\u0430\u0435\u0442 \u043f\u043e\u043b\u043d\u044b\u0439 \u0441\u043f\u0438\u0441\u043e\u043a \u0431\u0430\u0437 \u0434\u0430\u043d\u043d\u044b\u0445.",
                "PARAM": "query (Optional[Dict]) - \u0414\u043e\u043f\u043e\u043b\u043d\u0438\u0442\u0435\u043b\u044c\u043d\u044b\u0435 \u043f\u0430\u0440\u0430\u043c\u0435\u0442\u0440\u044b \u0437\u0430\u043f\u0440\u043e\u0441\u0430.",
                "PRE": "Client is authenticated.",
                "POST": "Returns total count and list of databases.",
                "RETURN": "Tuple[int, List[Dict]] - \u041a\u043e\u0440\u0442\u0435\u0436 (\u043e\u0431\u0449\u0435\u0435 \u043a\u043e\u043b\u0438\u0447\u0435\u0441\u0442\u0432\u043e, \u0441\u043f\u0438\u0441\u043e\u043a \u0431\u0430\u0437 \u0434\u0430\u043d\u043d\u044b\u0445)."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            },
            {
              "name": "get_database",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 276,
              "end_line": 289,
              "tags": {
                "PURPOSE": "\u041f\u043e\u043b\u0443\u0447\u0430\u0435\u0442 \u0438\u043d\u0444\u043e\u0440\u043c\u0430\u0446\u0438\u044e \u043e \u043a\u043e\u043d\u043a\u0440\u0435\u0442\u043d\u043e\u0439 \u0431\u0430\u0437\u0435 \u0434\u0430\u043d\u043d\u044b\u0445 \u043f\u043e \u0435\u0451 ID.",
                "PARAM": "database_id (int) - ID \u0431\u0430\u0437\u044b \u0434\u0430\u043d\u043d\u044b\u0445.",
                "PRE": "database_id must exist.",
                "POST": "Returns database details.",
                "RETURN": "Dict - \u0418\u043d\u0444\u043e\u0440\u043c\u0430\u0446\u0438\u044f \u043e \u0431\u0430\u0437\u0435 \u0434\u0430\u043d\u043d\u044b\u0445."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            },
            {
              "name": "get_databases_summary",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 291,
              "end_line": 308,
              "tags": {
                "PURPOSE": "Fetch a summary of databases including uuid, name, and engine.",
                "PRE": "Client is authenticated.",
                "POST": "Returns list of database summaries.",
                "RETURN": "List[Dict] - Summary of databases."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            },
            {
              "name": "get_database_by_uuid",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 310,
              "end_line": 323,
              "tags": {
                "PURPOSE": "Find a database by its UUID.",
                "PARAM": "db_uuid (str) - The UUID of the database.",
                "PRE": "db_uuid must be a valid UUID string.",
                "POST": "Returns database info or None.",
                "RETURN": "Optional[Dict] - Database info if found, else None."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            },
            {
              "name": "_resolve_target_id_for_delete",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 329,
              "end_line": 348,
              "tags": {
                "PURPOSE": "Resolves a dashboard ID from either an ID or a slug.",
                "PRE": "Either dash_id or dash_slug should be provided.",
                "POST": "Returns the resolved ID or None."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            },
            {
              "name": "_do_import",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 350,
              "end_line": 368,
              "tags": {
                "PURPOSE": "Performs the actual multipart upload for import.",
                "PRE": "file_name must be a path to an existing ZIP file.",
                "POST": "Returns the API response from the upload."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            },
            {
              "name": "_validate_export_response",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 370,
              "end_line": 381,
              "tags": {
                "PURPOSE": "Validates that the export response is a non-empty ZIP archive.",
                "PRE": "response must be a valid requests.Response object.",
                "POST": "Raises SupersetAPIError if validation fails."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            },
            {
              "name": "_resolve_export_filename",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 383,
              "end_line": 396,
              "tags": {
                "PURPOSE": "Determines the filename for an exported dashboard.",
                "PRE": "response must contain Content-Disposition header or dashboard_id must be provided.",
                "POST": "Returns a sanitized filename string."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            },
            {
              "name": "_validate_query_params",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 398,
              "end_line": 406,
              "tags": {
                "PURPOSE": "Ensures query parameters have default page and page_size.",
                "PRE": "query can be None or a dictionary.",
                "POST": "Returns a dictionary with at least page and page_size."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            },
            {
              "name": "_fetch_total_object_count",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 408,
              "end_line": 419,
              "tags": {
                "PURPOSE": "Fetches the total number of items for a given endpoint.",
                "PRE": "endpoint must be a valid Superset API path.",
                "POST": "Returns the total count as an integer."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            },
            {
              "name": "_fetch_all_pages",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 421,
              "end_line": 428,
              "tags": {
                "PURPOSE": "Iterates through all pages to collect all data items.",
                "PRE": "pagination_options must contain base_query, total_count, and results_field.",
                "POST": "Returns a combined list of all items."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            },
            {
              "name": "_validate_import_file",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 430,
              "end_line": 444,
              "tags": {
                "PURPOSE": "Validates that the file to be imported is a valid ZIP with metadata.yaml.",
                "PRE": "zip_path must be a path to a file.",
                "POST": "Raises error if file is missing, not a ZIP, or missing metadata."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            }
          ],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 24
              },
              {
                "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 24
              }
            ],
            "score": 0.7000000000000001
          }
        }
      ],
      "compliance": {
        "valid": true,
        "issues": [
          {
            "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
            "severity": "WARNING",
            "line_number": 1
          }
        ],
        "score": 0.85
      }
    },
    {
      "name": "ConfigManagerModule",
      "type": "Module",
      "tier": "STANDARD",
      "start_line": 1,
      "end_line": 284,
      "tags": {
        "SEMANTICS": "config, manager, persistence, json",
        "PURPOSE": "Manages application configuration, including loading/saving to JSON and CRUD for environments.",
        "LAYER": "Core",
        "INVARIANT": "Configuration must always be valid according to AppConfig model.",
        "PUBLIC_API": "ConfigManager"
      },
      "relations": [
        {
          "type": "DEPENDS_ON",
          "target": "ConfigModels"
        },
        {
          "type": "CALLS",
          "target": "logger"
        },
        {
          "type": "WRITES_TO",
          "target": "config.json"
        }
      ],
      "children": [
        {
          "name": "ConfigManager",
          "type": "Class",
          "tier": "STANDARD",
          "start_line": 22,
          "end_line": 282,
          "tags": {
            "PURPOSE": "A class to handle application configuration persistence and management."
          },
          "relations": [
            {
              "type": "WRITES_TO",
              "target": "config.json"
            }
          ],
          "children": [
            {
              "name": "__init__",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 27,
              "end_line": 50,
              "tags": {
                "PURPOSE": "Initializes the ConfigManager.",
                "PRE": "isinstance(config_path, str) and len(config_path) > 0",
                "POST": "self.config is an instance of AppConfig",
                "PARAM": "config_path (str) - Path to the configuration file."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            },
            {
              "name": "_load_config",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 52,
              "end_line": 88,
              "tags": {
                "PURPOSE": "Loads the configuration from disk or creates a default one.",
                "PRE": "self.config_path is set.",
                "POST": "isinstance(return, AppConfig)",
                "RETURN": "AppConfig - The loaded or default configuration."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            },
            {
              "name": "_save_config_to_disk",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 90,
              "end_line": 109,
              "tags": {
                "PURPOSE": "Saves the provided configuration object to disk.",
                "PRE": "isinstance(config, AppConfig)",
                "POST": "Configuration saved to disk.",
                "PARAM": "config (AppConfig) - The configuration to save."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            },
            {
              "name": "save",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 111,
              "end_line": 118,
              "tags": {
                "PURPOSE": "Saves the current configuration state to disk.",
                "PRE": "self.config is set.",
                "POST": "self._save_config_to_disk called."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            },
            {
              "name": "get_config",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 120,
              "end_line": 128,
              "tags": {
                "PURPOSE": "Returns the current configuration.",
                "PRE": "self.config is set.",
                "POST": "Returns self.config.",
                "RETURN": "AppConfig - The current configuration."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            },
            {
              "name": "update_global_settings",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 130,
              "end_line": 150,
              "tags": {
                "PURPOSE": "Updates the global settings and persists the change.",
                "PRE": "isinstance(settings, GlobalSettings)",
                "POST": "self.config.settings updated and saved.",
                "PARAM": "settings (GlobalSettings) - The new global settings."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            },
            {
              "name": "validate_path",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 152,
              "end_line": 171,
              "tags": {
                "PURPOSE": "Validates if a path exists and is writable.",
                "PRE": "path is a string.",
                "POST": "Returns (bool, str) status.",
                "PARAM": "path (str) - The path to validate.",
                "RETURN": "tuple (bool, str) - (is_valid, message)"
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            },
            {
              "name": "get_environments",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 173,
              "end_line": 181,
              "tags": {
                "PURPOSE": "Returns the list of configured environments.",
                "PRE": "self.config is set.",
                "POST": "Returns list of environments.",
                "RETURN": "List[Environment] - List of environments."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            },
            {
              "name": "has_environments",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 183,
              "end_line": 191,
              "tags": {
                "PURPOSE": "Checks if at least one environment is configured.",
                "PRE": "self.config is set.",
                "POST": "Returns boolean indicating if environments exist.",
                "RETURN": "bool - True if at least one environment exists."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            },
            {
              "name": "get_environment",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 193,
              "end_line": 205,
              "tags": {
                "PURPOSE": "Returns a single environment by ID.",
                "PRE": "self.config is set and isinstance(env_id, str) and len(env_id) > 0.",
                "POST": "Returns Environment object if found, None otherwise.",
                "PARAM": "env_id (str) - The ID of the environment to retrieve.",
                "RETURN": "Optional[Environment] - The environment with the given ID, or None."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            },
            {
              "name": "add_environment",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 207,
              "end_line": 226,
              "tags": {
                "PURPOSE": "Adds a new environment to the configuration.",
                "PRE": "isinstance(env, Environment)",
                "POST": "Environment added or updated in self.config.environments.",
                "PARAM": "env (Environment) - The environment to add."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            },
            {
              "name": "update_environment",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 228,
              "end_line": 257,
              "tags": {
                "PURPOSE": "Updates an existing environment.",
                "PRE": "isinstance(env_id, str) and len(env_id) > 0 and isinstance(updated_env, Environment)",
                "POST": "Returns True if environment was found and updated.",
                "PARAM": "updated_env (Environment) - The updated environment data.",
                "RETURN": "bool - True if updated, False otherwise."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            },
            {
              "name": "delete_environment",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 259,
              "end_line": 280,
              "tags": {
                "PURPOSE": "Deletes an environment by ID.",
                "PRE": "isinstance(env_id, str) and len(env_id) > 0",
                "POST": "Environment removed from self.config.environments if it existed.",
                "PARAM": "env_id (str) - The ID of the environment to delete."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            }
          ],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 22
              },
              {
                "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 22
              }
            ],
            "score": 0.7000000000000001
          }
        }
      ],
      "compliance": {
        "valid": true,
        "issues": [
          {
            "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
            "severity": "WARNING",
            "line_number": 1
          }
        ],
        "score": 0.85
      }
    },
    {
      "name": "SchedulerModule",
      "type": "Module",
      "tier": "STANDARD",
      "start_line": 1,
      "end_line": 119,
      "tags": {
        "SEMANTICS": "scheduler, apscheduler, cron, backup",
        "PURPOSE": "Manages scheduled tasks using APScheduler.",
        "LAYER": "Core",
        "RELATION": "Uses TaskManager to run scheduled backups."
      },
      "relations": [],
      "children": [
        {
          "name": "SchedulerService",
          "type": "Class",
          "tier": "STANDARD",
          "start_line": 16,
          "end_line": 118,
          "tags": {
            "SEMANTICS": "scheduler, service, apscheduler",
            "PURPOSE": "Provides a service to manage scheduled backup tasks."
          },
          "relations": [],
          "children": [
            {
              "name": "__init__",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 20,
              "end_line": 30,
              "tags": {
                "PURPOSE": "Initializes the scheduler service with task and config managers.",
                "PRE": "task_manager and config_manager must be provided.",
                "POST": "Scheduler instance is created but not started."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            },
            {
              "name": "start",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 32,
              "end_line": 42,
              "tags": {
                "PURPOSE": "Starts the background scheduler and loads initial schedules.",
                "PRE": "Scheduler should be initialized.",
                "POST": "Scheduler is running and schedules are loaded."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            },
            {
              "name": "stop",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 44,
              "end_line": 53,
              "tags": {
                "PURPOSE": "Stops the background scheduler.",
                "PRE": "Scheduler should be running.",
                "POST": "Scheduler is shut down."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            },
            {
              "name": "load_schedules",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 55,
              "end_line": 68,
              "tags": {
                "PURPOSE": "Loads backup schedules from configuration and registers them.",
                "PRE": "config_manager must have valid configuration.",
                "POST": "All enabled backup jobs are added to the scheduler."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            },
            {
              "name": "add_backup_job",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 70,
              "end_line": 90,
              "tags": {
                "PURPOSE": "Adds a scheduled backup job for an environment.",
                "PRE": "env_id and cron_expression must be valid strings.",
                "POST": "A new job is added to the scheduler or replaced if it already exists.",
                "PARAM": "cron_expression (str) - The cron expression for the schedule."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            },
            {
              "name": "_trigger_backup",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 92,
              "end_line": 116,
              "tags": {
                "PURPOSE": "Triggered by the scheduler to start a backup task.",
                "PRE": "env_id must be a valid environment ID.",
                "POST": "A new backup task is created in the task manager if not already running.",
                "PARAM": "env_id (str) - The ID of the environment."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            }
          ],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 16
              },
              {
                "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 16
              }
            ],
            "score": 0.7000000000000001
          }
        }
      ],
      "compliance": {
        "valid": true,
        "issues": [
          {
            "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
            "severity": "WARNING",
            "line_number": 1
          }
        ],
        "score": 0.85
      }
    },
    {
      "name": "ConfigModels",
      "type": "Module",
      "tier": "STANDARD",
      "start_line": 1,
      "end_line": 63,
      "tags": {
        "SEMANTICS": "config, models, pydantic",
        "PURPOSE": "Defines the data models for application configuration using Pydantic.",
        "LAYER": "Core"
      },
      "relations": [
        {
          "type": "READS_FROM",
          "target": "config.json"
        },
        {
          "type": "USED_BY",
          "target": "ConfigManager"
        }
      ],
      "children": [
        {
          "name": "Schedule",
          "type": "DataClass",
          "tier": "STANDARD",
          "start_line": 12,
          "end_line": 17,
          "tags": {
            "PURPOSE": "Represents a backup schedule configuration."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "Environment",
          "type": "DataClass",
          "tier": "STANDARD",
          "start_line": 19,
          "end_line": 31,
          "tags": {
            "PURPOSE": "Represents a Superset environment configuration."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "LoggingConfig",
          "type": "DataClass",
          "tier": "STANDARD",
          "start_line": 33,
          "end_line": 41,
          "tags": {
            "PURPOSE": "Defines the configuration for the application's logging system."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "GlobalSettings",
          "type": "DataClass",
          "tier": "STANDARD",
          "start_line": 43,
          "end_line": 54,
          "tags": {
            "PURPOSE": "Represents global application settings."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "AppConfig",
          "type": "DataClass",
          "tier": "STANDARD",
          "start_line": 56,
          "end_line": 61,
          "tags": {
            "PURPOSE": "The root configuration model containing all application settings."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        }
      ],
      "compliance": {
        "valid": true,
        "issues": [
          {
            "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
            "severity": "WARNING",
            "line_number": 1
          }
        ],
        "score": 0.85
      }
    },
    {
      "name": "backend.src.core.database",
      "type": "Module",
      "tier": "STANDARD",
      "start_line": 1,
      "end_line": 141,
      "tags": {
        "SEMANTICS": "database, sqlite, sqlalchemy, session, persistence",
        "PURPOSE": "Configures the SQLite database connection and session management.",
        "LAYER": "Core",
        "INVARIANT": "A single engine instance is used for the entire application."
      },
      "relations": [
        {
          "type": "DEPENDS_ON",
          "target": "sqlalchemy"
        },
        {
          "type": "USES",
          "target": "backend.src.models.mapping"
        },
        {
          "type": "USES",
          "target": "backend.src.core.auth.config"
        }
      ],
      "children": [
        {
          "name": "BASE_DIR",
          "type": "Variable",
          "tier": "STANDARD",
          "start_line": 28,
          "end_line": 31,
          "tags": {
            "PURPOSE": "Base directory for the backend (where .db files should reside)."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "DATABASE_URL",
          "type": "Constant",
          "tier": "STANDARD",
          "start_line": 33,
          "end_line": 36,
          "tags": {
            "PURPOSE": "URL for the main mappings database."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "TASKS_DATABASE_URL",
          "type": "Constant",
          "tier": "STANDARD",
          "start_line": 38,
          "end_line": 41,
          "tags": {
            "PURPOSE": "URL for the tasks execution database."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "AUTH_DATABASE_URL",
          "type": "Constant",
          "tier": "STANDARD",
          "start_line": 43,
          "end_line": 52,
          "tags": {
            "PURPOSE": "URL for the authentication database."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "engine",
          "type": "Variable",
          "tier": "STANDARD",
          "start_line": 54,
          "end_line": 57,
          "tags": {
            "PURPOSE": "SQLAlchemy engine for mappings database."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "tasks_engine",
          "type": "Variable",
          "tier": "STANDARD",
          "start_line": 59,
          "end_line": 62,
          "tags": {
            "PURPOSE": "SQLAlchemy engine for tasks database."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "auth_engine",
          "type": "Variable",
          "tier": "STANDARD",
          "start_line": 64,
          "end_line": 67,
          "tags": {
            "PURPOSE": "SQLAlchemy engine for authentication database."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "SessionLocal",
          "type": "Class",
          "tier": "STANDARD",
          "start_line": 69,
          "end_line": 73,
          "tags": {
            "PURPOSE": "A session factory for the main mappings database.",
            "PRE": "engine is initialized."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 69
              },
              {
                "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 69
              }
            ],
            "score": 0.7000000000000001
          }
        },
        {
          "name": "TasksSessionLocal",
          "type": "Class",
          "tier": "STANDARD",
          "start_line": 75,
          "end_line": 79,
          "tags": {
            "PURPOSE": "A session factory for the tasks execution database.",
            "PRE": "tasks_engine is initialized."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 75
              },
              {
                "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 75
              }
            ],
            "score": 0.7000000000000001
          }
        },
        {
          "name": "AuthSessionLocal",
          "type": "Class",
          "tier": "STANDARD",
          "start_line": 81,
          "end_line": 85,
          "tags": {
            "PURPOSE": "A session factory for the authentication database.",
            "PRE": "auth_engine is initialized."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 81
              },
              {
                "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 81
              }
            ],
            "score": 0.7000000000000001
          }
        },
        {
          "name": "init_db",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 87,
          "end_line": 97,
          "tags": {
            "PURPOSE": "Initializes the database by creating all tables.",
            "PRE": "engine, tasks_engine and auth_engine are initialized.",
            "POST": "Database tables created in all databases.",
            "SIDE_EFFECT": "Creates physical database files if they don't exist."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "get_db",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 99,
          "end_line": 111,
          "tags": {
            "PURPOSE": "Dependency for getting a database session.",
            "PRE": "SessionLocal is initialized.",
            "POST": "Session is closed after use.",
            "RETURN": "Generator[Session, None, None]"
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "get_tasks_db",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 113,
          "end_line": 125,
          "tags": {
            "PURPOSE": "Dependency for getting a tasks database session.",
            "PRE": "TasksSessionLocal is initialized.",
            "POST": "Session is closed after use.",
            "RETURN": "Generator[Session, None, None]"
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "get_auth_db",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 127,
          "end_line": 139,
          "tags": {
            "PURPOSE": "Dependency for getting an authentication database session.",
            "PRE": "AuthSessionLocal is initialized.",
            "POST": "Session is closed after use.",
            "RETURN": "Generator[Session, None, None]"
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        }
      ],
      "compliance": {
        "valid": true,
        "issues": [
          {
            "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
            "severity": "WARNING",
            "line_number": 1
          }
        ],
        "score": 0.85
      }
    },
    {
      "name": "LoggerModule",
      "type": "Module",
      "tier": "STANDARD",
      "start_line": 1,
      "end_line": 246,
      "tags": {
        "SEMANTICS": "logging, websocket, streaming, handler",
        "PURPOSE": "Configures the application's logging system, including a custom handler for buffering logs and streaming them over WebSockets.",
        "LAYER": "Core",
        "RELATION": "Used by the main application and other modules to log events. The WebSocketLogHandler is used by the WebSocket endpoint in app.py."
      },
      "relations": [],
      "children": [
        {
          "name": "BeliefFormatter",
          "type": "Class",
          "tier": "STANDARD",
          "start_line": 22,
          "end_line": 38,
          "tags": {
            "PURPOSE": "Custom logging formatter that adds belief state prefixes to log messages."
          },
          "relations": [],
          "children": [
            {
              "name": "format",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 25,
              "end_line": 37,
              "tags": {
                "PURPOSE": "Formats the log record, adding belief state context if available.",
                "PRE": "record is a logging.LogRecord.",
                "POST": "Returns formatted string.",
                "PARAM": "record (logging.LogRecord) - The log record to format.",
                "RETURN": "str - The formatted log message.",
                "SEMANTICS": "logging, formatter, context"
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            }
          ],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 22
              },
              {
                "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 22
              }
            ],
            "score": 0.7000000000000001
          }
        },
        {
          "name": "LogEntry",
          "type": "Class",
          "tier": "STANDARD",
          "start_line": 41,
          "end_line": 50,
          "tags": {
            "SEMANTICS": "log, entry, record, pydantic",
            "PURPOSE": "A Pydantic model representing a single, structured log entry. This is a re-definition for consistency, as it's also defined in task_manager.py."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 41
              },
              {
                "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 41
              }
            ],
            "score": 0.7000000000000001
          }
        },
        {
          "name": "belief_scope",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 52,
          "end_line": 86,
          "tags": {
            "PURPOSE": "Context manager for structured Belief State logging.",
            "PARAM": "message (str) - Optional entry message.",
            "PRE": "anchor_id must be provided.",
            "POST": "Thread-local belief state is updated and entry/exit logs are generated.",
            "SEMANTICS": "logging, context, belief_state"
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "configure_logger",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 88,
          "end_line": 131,
          "tags": {
            "PURPOSE": "Configures the logger with the provided logging settings.",
            "PRE": "config is a valid LoggingConfig instance.",
            "POST": "Logger level, handlers, and belief state flag are updated.",
            "PARAM": "config (LoggingConfig) - The logging configuration.",
            "SEMANTICS": "logging, configuration, initialization"
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "WebSocketLogHandler",
          "type": "Class",
          "tier": "STANDARD",
          "start_line": 133,
          "end_line": 195,
          "tags": {
            "SEMANTICS": "logging, handler, websocket, buffer",
            "PURPOSE": "A custom logging handler that captures log records into a buffer. It is designed to be extended for real-time log streaming over WebSockets."
          },
          "relations": [],
          "children": [
            {
              "name": "__init__",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 141,
              "end_line": 152,
              "tags": {
                "PURPOSE": "Initializes the handler with a fixed-capacity buffer.",
                "PRE": "capacity is an integer.",
                "POST": "Instance initialized with empty deque.",
                "PARAM": "capacity (int) - Maximum number of logs to keep in memory.",
                "SEMANTICS": "logging, initialization, buffer"
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            },
            {
              "name": "emit",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 154,
              "end_line": 180,
              "tags": {
                "PURPOSE": "Captures a log record, formats it, and stores it in the buffer.",
                "PRE": "record is a logging.LogRecord.",
                "POST": "Log is added to the log_buffer.",
                "PARAM": "record (logging.LogRecord) - The log record to emit.",
                "SEMANTICS": "logging, handler, buffer"
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            },
            {
              "name": "get_recent_logs",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 182,
              "end_line": 193,
              "tags": {
                "PURPOSE": "Returns a list of recent log entries from the buffer.",
                "PRE": "None.",
                "POST": "Returns list of LogEntry objects.",
                "RETURN": "List[LogEntry] - List of buffered log entries.",
                "SEMANTICS": "logging, buffer, retrieval"
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            }
          ],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 133
              },
              {
                "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 133
              }
            ],
            "score": 0.7000000000000001
          }
        },
        {
          "name": "Logger",
          "type": "Global",
          "tier": "STANDARD",
          "start_line": 197,
          "end_line": 245,
          "tags": {
            "SEMANTICS": "logger, global, instance",
            "PURPOSE": "The global logger instance for the application, configured with both a console handler and the custom WebSocket handler."
          },
          "relations": [],
          "children": [
            {
              "name": "believed",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 202,
              "end_line": 224,
              "tags": {
                "PURPOSE": "A decorator that wraps a function in a belief scope.",
                "PARAM": "anchor_id (str) - The identifier for the semantic block.",
                "PRE": "anchor_id must be a string.",
                "POST": "Returns a decorator function."
              },
              "relations": [],
              "children": [
                {
                  "name": "decorator",
                  "type": "Function",
                  "tier": "STANDARD",
                  "start_line": 208,
                  "end_line": 222,
                  "tags": {
                    "PURPOSE": "Internal decorator for belief scope.",
                    "PRE": "func must be a callable.",
                    "POST": "Returns the wrapped function."
                  },
                  "relations": [],
                  "children": [
                    {
                      "name": "wrapper",
                      "type": "Function",
                      "tier": "STANDARD",
                      "start_line": 213,
                      "end_line": 220,
                      "tags": {
                        "PURPOSE": "Internal wrapper that enters belief scope.",
                        "PRE": "None.",
                        "POST": "Executes the function within a belief scope."
                      },
                      "relations": [],
                      "children": [],
                      "compliance": {
                        "valid": true,
                        "issues": [],
                        "score": 1.0
                      }
                    }
                  ],
                  "compliance": {
                    "valid": true,
                    "issues": [],
                    "score": 1.0
                  }
                }
              ],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            }
          ],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        }
      ],
      "compliance": {
        "valid": true,
        "issues": [
          {
            "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
            "severity": "WARNING",
            "line_number": 1
          }
        ],
        "score": 0.85
      }
    },
    {
      "name": "PluginLoader",
      "type": "Class",
      "tier": "STANDARD",
      "start_line": 9,
      "end_line": 201,
      "tags": {
        "SEMANTICS": "plugin, loader, dynamic, import",
        "PURPOSE": "Scans a specified directory for Python modules, dynamically loads them, and registers any classes that are valid implementations of the PluginBase interface.",
        "LAYER": "Core",
        "RELATION": "Depends on PluginBase. It is used by the main application to discover and manage available plugins."
      },
      "relations": [],
      "children": [
        {
          "name": "__init__",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 20,
          "end_line": 31,
          "tags": {
            "PURPOSE": "Initializes the PluginLoader with a directory to scan.",
            "PRE": "plugin_dir is a valid directory path.",
            "POST": "Plugins are loaded and registered.",
            "PARAM": "plugin_dir (str) - The directory containing plugin modules."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "_load_plugins",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 33,
          "end_line": 66,
          "tags": {
            "PURPOSE": "Scans the plugin directory and loads all valid plugins.",
            "PRE": "plugin_dir exists or can be created.",
            "POST": "_load_module is called for each .py file."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "_load_module",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 68,
          "end_line": 116,
          "tags": {
            "PURPOSE": "Loads a single Python module and discovers PluginBase implementations.",
            "PRE": "module_name and file_path are valid.",
            "POST": "Plugin classes are instantiated and registered.",
            "PARAM": "file_path (str) - The path to the module file."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "_register_plugin",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 118,
          "end_line": 157,
          "tags": {
            "PURPOSE": "Registers a PluginBase instance and its configuration.",
            "PRE": "plugin_instance is a valid implementation of PluginBase.",
            "POST": "Plugin is added to _plugins and _plugin_configs.",
            "PARAM": "plugin_instance (PluginBase) - The plugin instance to register."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "get_plugin",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 160,
          "end_line": 172,
          "tags": {
            "PURPOSE": "Retrieves a loaded plugin instance by its ID.",
            "PRE": "plugin_id is a string.",
            "POST": "Returns plugin instance or None.",
            "PARAM": "plugin_id (str) - The unique identifier of the plugin.",
            "RETURN": "Optional[PluginBase] - The plugin instance if found, otherwise None."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "get_all_plugin_configs",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 174,
          "end_line": 185,
          "tags": {
            "PURPOSE": "Returns a list of all registered plugin configurations.",
            "PRE": "None.",
            "POST": "Returns list of all PluginConfig objects.",
            "RETURN": "List[PluginConfig] - A list of plugin configurations."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "has_plugin",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 187,
          "end_line": 199,
          "tags": {
            "PURPOSE": "Checks if a plugin with the given ID is registered.",
            "PRE": "plugin_id is a string.",
            "POST": "Returns True if plugin exists.",
            "PARAM": "plugin_id (str) - The unique identifier of the plugin.",
            "RETURN": "bool - True if the plugin is registered, False otherwise."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        }
      ],
      "compliance": {
        "valid": true,
        "issues": [
          {
            "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
            "severity": "WARNING",
            "line_number": 9
          }
        ],
        "score": 0.8
      }
    },
    {
      "name": "backend.src.core.migration_engine",
      "type": "Module",
      "tier": "STANDARD",
      "start_line": 1,
      "end_line": 104,
      "tags": {
        "SEMANTICS": "migration, engine, zip, yaml, transformation",
        "PURPOSE": "Handles the interception and transformation of Superset asset ZIP archives.",
        "LAYER": "Core",
        "INVARIANT": "ZIP structure must be preserved after transformation."
      },
      "relations": [
        {
          "type": "DEPENDS_ON",
          "target": "PyYAML"
        }
      ],
      "children": [
        {
          "name": "MigrationEngine",
          "type": "Class",
          "tier": "STANDARD",
          "start_line": 22,
          "end_line": 102,
          "tags": {
            "PURPOSE": "Engine for transforming Superset export ZIPs."
          },
          "relations": [],
          "children": [
            {
              "name": "transform_zip",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 26,
              "end_line": 78,
              "tags": {
                "PURPOSE": "Extracts ZIP, replaces database UUIDs in YAMLs, and re-packages.",
                "PARAM": "strip_databases (bool) - Whether to remove the databases directory from the archive.",
                "PRE": "zip_path must point to a valid Superset export archive.",
                "POST": "Transformed archive is saved to output_path.",
                "RETURN": "bool - True if successful."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            },
            {
              "name": "_transform_yaml",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 80,
              "end_line": 100,
              "tags": {
                "PURPOSE": "Replaces database_uuid in a single YAML file.",
                "PARAM": "db_mapping (Dict[str, str]) - UUID mapping dictionary.",
                "PRE": "file_path must exist and be readable.",
                "POST": "File is modified in-place if source UUID matches mapping."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [
                  {
                    "message": "Missing Belief State Logging: Function should use belief_scope (required for STANDARD tier)",
                    "severity": "WARNING",
                    "line_number": 80
                  },
                  {
                    "message": "Missing Belief State Logging: Function should use belief_scope (required for STANDARD tier)",
                    "severity": "WARNING",
                    "line_number": 80
                  },
                  {
                    "message": "Missing Belief State Logging: Function should use belief_scope (required for STANDARD tier)",
                    "severity": "WARNING",
                    "line_number": 80
                  }
                ],
                "score": 0.7
              }
            }
          ],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 22
              },
              {
                "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 22
              }
            ],
            "score": 0.7000000000000001
          }
        }
      ],
      "compliance": {
        "valid": true,
        "issues": [
          {
            "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
            "severity": "WARNING",
            "line_number": 1
          }
        ],
        "score": 0.85
      }
    },
    {
      "name": "PluginBase",
      "type": "Class",
      "tier": "STANDARD",
      "start_line": 7,
      "end_line": 128,
      "tags": {
        "SEMANTICS": "plugin, interface, base, abstract",
        "PURPOSE": "Defines the abstract base class that all plugins must implement to be recognized by the system. It enforces a common structure for plugin metadata and execution.",
        "LAYER": "Core",
        "RELATION": "Used by PluginLoader to identify valid plugins.",
        "INVARIANT": "All plugins MUST inherit from this class."
      },
      "relations": [],
      "children": [
        {
          "name": "id",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 21,
          "end_line": 30,
          "tags": {
            "PURPOSE": "Returns the unique identifier for the plugin.",
            "PRE": "Plugin instance exists.",
            "POST": "Returns string ID.",
            "RETURN": "str - Plugin ID."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "name",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 34,
          "end_line": 43,
          "tags": {
            "PURPOSE": "Returns the human-readable name of the plugin.",
            "PRE": "Plugin instance exists.",
            "POST": "Returns string name.",
            "RETURN": "str - Plugin name."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "description",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 47,
          "end_line": 56,
          "tags": {
            "PURPOSE": "Returns a brief description of the plugin.",
            "PRE": "Plugin instance exists.",
            "POST": "Returns string description.",
            "RETURN": "str - Plugin description."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "version",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 60,
          "end_line": 69,
          "tags": {
            "PURPOSE": "Returns the version of the plugin.",
            "PRE": "Plugin instance exists.",
            "POST": "Returns string version.",
            "RETURN": "str - Plugin version."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "required_permission",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 72,
          "end_line": 81,
          "tags": {
            "PURPOSE": "Returns the required permission string to execute this plugin.",
            "PRE": "Plugin instance exists.",
            "POST": "Returns string permission.",
            "RETURN": "str - Required permission (e.g., \"plugin:backup:execute\")."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "ui_route",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 84,
          "end_line": 96,
          "tags": {
            "PURPOSE": "Returns the frontend route for the plugin's UI, if applicable.",
            "PRE": "Plugin instance exists.",
            "POST": "Returns string route or None.",
            "RETURN": "Optional[str] - Frontend route."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "get_schema",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 99,
          "end_line": 111,
          "tags": {
            "PURPOSE": "Returns the JSON schema for the plugin's input parameters.",
            "PRE": "Plugin instance exists.",
            "POST": "Returns dict schema.",
            "RETURN": "Dict[str, Any] - JSON schema."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "execute",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 114,
          "end_line": 127,
          "tags": {
            "PURPOSE": "Executes the plugin's core logic.",
            "PARAM": "params (Dict[str, Any]) - Validated input parameters.",
            "PRE": "params must be a dictionary.",
            "POST": "Plugin execution is completed."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        }
      ],
      "compliance": {
        "valid": true,
        "issues": [
          {
            "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
            "severity": "WARNING",
            "line_number": 7
          }
        ],
        "score": 0.8
      }
    },
    {
      "name": "PluginConfig",
      "type": "Class",
      "tier": "STANDARD",
      "start_line": 130,
      "end_line": 143,
      "tags": {
        "SEMANTICS": "plugin, config, schema, pydantic",
        "PURPOSE": "A Pydantic model used to represent the validated configuration and metadata of a loaded plugin. This object is what gets exposed to the API layer.",
        "LAYER": "Core",
        "RELATION": "Instantiated by PluginLoader after validating a PluginBase instance."
      },
      "relations": [],
      "children": [],
      "compliance": {
        "valid": true,
        "issues": [
          {
            "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
            "severity": "WARNING",
            "line_number": 130
          }
        ],
        "score": 0.8
      }
    },
    {
      "name": "backend.src.core.auth.config",
      "type": "Module",
      "tier": "STANDARD",
      "start_line": 1,
      "end_line": 45,
      "tags": {
        "SEMANTICS": "auth, config, settings, jwt, adfs",
        "PURPOSE": "Centralized configuration for authentication and authorization.",
        "LAYER": "Core",
        "INVARIANT": "All sensitive configuration must have defaults or be loaded from environment."
      },
      "relations": [
        {
          "type": "DEPENDS_ON",
          "target": "pydantic"
        }
      ],
      "children": [
        {
          "name": "AuthConfig",
          "type": "Class",
          "tier": "STANDARD",
          "start_line": 16,
          "end_line": 38,
          "tags": {
            "PURPOSE": "Holds authentication-related settings.",
            "PRE": "Environment variables may be provided via .env file.",
            "POST": "Returns a configuration object with validated settings."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 16
              },
              {
                "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 16
              }
            ],
            "score": 0.7000000000000001
          }
        },
        {
          "name": "auth_config",
          "type": "Variable",
          "tier": "STANDARD",
          "start_line": 40,
          "end_line": 43,
          "tags": {
            "PURPOSE": "Singleton instance of AuthConfig."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        }
      ],
      "compliance": {
        "valid": true,
        "issues": [
          {
            "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
            "severity": "WARNING",
            "line_number": 1
          }
        ],
        "score": 0.85
      }
    },
    {
      "name": "backend.src.core.auth.jwt",
      "type": "Module",
      "tier": "STANDARD",
      "start_line": 1,
      "end_line": 54,
      "tags": {
        "SEMANTICS": "jwt, token, session, auth",
        "PURPOSE": "JWT token generation and validation logic.",
        "LAYER": "Core",
        "INVARIANT": "Tokens must include expiration time and user identifier."
      },
      "relations": [
        {
          "type": "DEPENDS_ON",
          "target": "jose"
        },
        {
          "type": "USES",
          "target": "backend.src.core.auth.config.auth_config"
        }
      ],
      "children": [
        {
          "name": "create_access_token",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 19,
          "end_line": 38,
          "tags": {
            "PURPOSE": "Generates a new JWT access token.",
            "PRE": "data dict contains 'sub' (user_id) and optional 'scopes' (roles).",
            "POST": "Returns a signed JWT string.",
            "PARAM": "expires_delta (Optional[timedelta]) - Custom expiration time.",
            "RETURN": "str - The encoded JWT."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "decode_token",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 40,
          "end_line": 52,
          "tags": {
            "PURPOSE": "Decodes and validates a JWT token.",
            "PRE": "token is a signed JWT string.",
            "POST": "Returns the decoded payload if valid.",
            "PARAM": "token (str) - The JWT to decode.",
            "RETURN": "dict - The decoded payload.",
            "THROW": "jose.JWTError - If token is invalid or expired."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        }
      ],
      "compliance": {
        "valid": true,
        "issues": [
          {
            "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
            "severity": "WARNING",
            "line_number": 1
          }
        ],
        "score": 0.85
      }
    },
    {
      "name": "backend.src.core.auth.oauth",
      "type": "Module",
      "tier": "STANDARD",
      "start_line": 1,
      "end_line": 51,
      "tags": {
        "SEMANTICS": "auth, oauth, oidc, adfs",
        "PURPOSE": "ADFS OIDC configuration and client using Authlib.",
        "LAYER": "Core",
        "INVARIANT": "Must use secure OIDC flows."
      },
      "relations": [
        {
          "type": "DEPENDS_ON",
          "target": "authlib"
        },
        {
          "type": "USES",
          "target": "backend.src.core.auth.config.auth_config"
        }
      ],
      "children": [
        {
          "name": "oauth",
          "type": "Variable",
          "tier": "STANDARD",
          "start_line": 16,
          "end_line": 19,
          "tags": {
            "PURPOSE": "Global Authlib OAuth registry."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "register_adfs",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 21,
          "end_line": 36,
          "tags": {
            "PURPOSE": "Registers the ADFS OIDC client.",
            "PRE": "ADFS configuration is provided in auth_config.",
            "POST": "ADFS client is registered in oauth registry."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Belief State Logging: Function should use belief_scope (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 21
              },
              {
                "message": "Missing Belief State Logging: Function should use belief_scope (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 21
              }
            ],
            "score": 0.8
          }
        },
        {
          "name": "is_adfs_configured",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 38,
          "end_line": 46,
          "tags": {
            "PURPOSE": "Checks if ADFS is properly configured.",
            "PRE": "None.",
            "POST": "Returns True if ADFS client is registered, False otherwise.",
            "RETURN": "bool - Configuration status."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Belief State Logging: Function should use belief_scope (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 38
              },
              {
                "message": "Missing Belief State Logging: Function should use belief_scope (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 38
              }
            ],
            "score": 0.8
          }
        }
      ],
      "compliance": {
        "valid": true,
        "issues": [
          {
            "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
            "severity": "WARNING",
            "line_number": 1
          }
        ],
        "score": 0.85
      }
    },
    {
      "name": "backend.src.core.auth.logger",
      "type": "Module",
      "tier": "STANDARD",
      "start_line": 1,
      "end_line": 31,
      "tags": {
        "SEMANTICS": "auth, logger, audit, security",
        "PURPOSE": "Audit logging for security-related events.",
        "LAYER": "Core",
        "INVARIANT": "Must not log sensitive data like passwords or full tokens."
      },
      "relations": [
        {
          "type": "USES",
          "target": "backend.src.core.logger.belief_scope"
        }
      ],
      "children": [
        {
          "name": "log_security_event",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 15,
          "end_line": 29,
          "tags": {
            "PURPOSE": "Logs a security-related event for audit trails.",
            "PRE": "event_type and username are strings.",
            "POST": "Security event is written to the application log.",
            "PARAM": "details (dict) - Additional non-sensitive metadata."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        }
      ],
      "compliance": {
        "valid": true,
        "issues": [
          {
            "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
            "severity": "WARNING",
            "line_number": 1
          }
        ],
        "score": 0.85
      }
    },
    {
      "name": "backend.src.core.auth.security",
      "type": "Module",
      "tier": "STANDARD",
      "start_line": 1,
      "end_line": 42,
      "tags": {
        "SEMANTICS": "security, password, hashing, bcrypt",
        "PURPOSE": "Utility for password hashing and verification using Passlib.",
        "LAYER": "Core",
        "INVARIANT": "Uses bcrypt for hashing with standard work factor."
      },
      "relations": [
        {
          "type": "DEPENDS_ON",
          "target": "passlib"
        }
      ],
      "children": [
        {
          "name": "pwd_context",
          "type": "Variable",
          "tier": "STANDARD",
          "start_line": 14,
          "end_line": 17,
          "tags": {
            "PURPOSE": "Passlib CryptContext for password management."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "verify_password",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 19,
          "end_line": 29,
          "tags": {
            "PURPOSE": "Verifies a plain password against a hashed password.",
            "PRE": "plain_password is a string, hashed_password is a bcrypt hash.",
            "POST": "Returns True if password matches, False otherwise.",
            "PARAM": "hashed_password (str) - The stored hash.",
            "RETURN": "bool - Verification result."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Belief State Logging: Function should use belief_scope (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 19
              },
              {
                "message": "Missing Belief State Logging: Function should use belief_scope (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 19
              }
            ],
            "score": 0.8
          }
        },
        {
          "name": "get_password_hash",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 31,
          "end_line": 40,
          "tags": {
            "PURPOSE": "Generates a bcrypt hash for a plain password.",
            "PRE": "password is a string.",
            "POST": "Returns a secure bcrypt hash string.",
            "PARAM": "password (str) - The password to hash.",
            "RETURN": "str - The generated hash."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Belief State Logging: Function should use belief_scope (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 31
              },
              {
                "message": "Missing Belief State Logging: Function should use belief_scope (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 31
              }
            ],
            "score": 0.8
          }
        }
      ],
      "compliance": {
        "valid": true,
        "issues": [
          {
            "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
            "severity": "WARNING",
            "line_number": 1
          }
        ],
        "score": 0.85
      }
    },
    {
      "name": "backend.src.core.auth.repository",
      "type": "Module",
      "tier": "STANDARD",
      "start_line": 1,
      "end_line": 123,
      "tags": {
        "SEMANTICS": "auth, repository, database, user, role",
        "PURPOSE": "Data access layer for authentication-related entities.",
        "LAYER": "Core",
        "INVARIANT": "All database operations must be performed within a session."
      },
      "relations": [
        {
          "type": "DEPENDS_ON",
          "target": "sqlalchemy"
        },
        {
          "type": "USES",
          "target": "backend.src.models.auth"
        }
      ],
      "children": [
        {
          "name": "AuthRepository",
          "type": "Class",
          "tier": "STANDARD",
          "start_line": 18,
          "end_line": 121,
          "tags": {
            "PURPOSE": "Encapsulates database operations for authentication."
          },
          "relations": [],
          "children": [
            {
              "name": "__init__",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 21,
              "end_line": 26,
              "tags": {
                "PURPOSE": "Initializes the repository with a database session.",
                "PARAM": "db (Session) - SQLAlchemy session."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [
                  {
                    "message": "Missing Mandatory Tag: @PRE (required for STANDARD tier)",
                    "severity": "WARNING",
                    "line_number": 21
                  },
                  {
                    "message": "Missing Mandatory Tag: @POST (required for STANDARD tier)",
                    "severity": "WARNING",
                    "line_number": 21
                  },
                  {
                    "message": "Missing Mandatory Tag: @PRE (required for STANDARD tier)",
                    "severity": "WARNING",
                    "line_number": 21
                  },
                  {
                    "message": "Missing Mandatory Tag: @POST (required for STANDARD tier)",
                    "severity": "WARNING",
                    "line_number": 21
                  },
                  {
                    "message": "Missing Mandatory Tag: @PRE (required for STANDARD tier)",
                    "severity": "WARNING",
                    "line_number": 21
                  },
                  {
                    "message": "Missing Mandatory Tag: @POST (required for STANDARD tier)",
                    "severity": "WARNING",
                    "line_number": 21
                  }
                ],
                "score": 0.26666666666666655
              }
            },
            {
              "name": "get_user_by_username",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 28,
              "end_line": 37,
              "tags": {
                "PURPOSE": "Retrieves a user by their username.",
                "PRE": "username is a string.",
                "POST": "Returns User object if found, else None.",
                "PARAM": "username (str) - The username to search for.",
                "RETURN": "Optional[User] - The found user or None."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            },
            {
              "name": "get_user_by_id",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 39,
              "end_line": 48,
              "tags": {
                "PURPOSE": "Retrieves a user by their unique ID.",
                "PRE": "user_id is a valid UUID string.",
                "POST": "Returns User object if found, else None.",
                "PARAM": "user_id (str) - The user's unique identifier.",
                "RETURN": "Optional[User] - The found user or None."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            },
            {
              "name": "get_role_by_name",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 50,
              "end_line": 59,
              "tags": {
                "PURPOSE": "Retrieves a role by its name.",
                "PRE": "name is a string.",
                "POST": "Returns Role object if found, else None.",
                "PARAM": "name (str) - The role name to search for.",
                "RETURN": "Optional[Role] - The found role or None."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            },
            {
              "name": "update_last_login",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 61,
              "end_line": 73,
              "tags": {
                "PURPOSE": "Updates the last_login timestamp for a user.",
                "PRE": "user object is a valid User instance.",
                "POST": "User's last_login is updated in the database.",
                "SIDE_EFFECT": "Commits the transaction.",
                "PARAM": "user (User) - The user to update."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            },
            {
              "name": "get_role_by_id",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 75,
              "end_line": 84,
              "tags": {
                "PURPOSE": "Retrieves a role by its unique ID.",
                "PRE": "role_id is a string.",
                "POST": "Returns Role object if found, else None.",
                "PARAM": "role_id (str) - The role's unique identifier.",
                "RETURN": "Optional[Role] - The found role or None."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            },
            {
              "name": "get_permission_by_id",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 86,
              "end_line": 95,
              "tags": {
                "PURPOSE": "Retrieves a permission by its unique ID.",
                "PRE": "perm_id is a string.",
                "POST": "Returns Permission object if found, else None.",
                "PARAM": "perm_id (str) - The permission's unique identifier.",
                "RETURN": "Optional[Permission] - The found permission or None."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            },
            {
              "name": "get_permission_by_resource_action",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 97,
              "end_line": 110,
              "tags": {
                "PURPOSE": "Retrieves a permission by resource and action.",
                "PRE": "resource and action are strings.",
                "POST": "Returns Permission object if found, else None.",
                "PARAM": "action (str) - The action name.",
                "RETURN": "Optional[Permission] - The found permission or None."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            },
            {
              "name": "list_permissions",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 112,
              "end_line": 119,
              "tags": {
                "PURPOSE": "Lists all available permissions.",
                "POST": "Returns a list of all Permission objects.",
                "RETURN": "List[Permission] - List of permissions."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [
                  {
                    "message": "Missing Mandatory Tag: @PRE (required for STANDARD tier)",
                    "severity": "WARNING",
                    "line_number": 112
                  },
                  {
                    "message": "Missing Mandatory Tag: @PRE (required for STANDARD tier)",
                    "severity": "WARNING",
                    "line_number": 112
                  },
                  {
                    "message": "Missing Mandatory Tag: @PRE (required for STANDARD tier)",
                    "severity": "WARNING",
                    "line_number": 112
                  }
                ],
                "score": 0.6333333333333333
              }
            }
          ],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 18
              },
              {
                "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 18
              }
            ],
            "score": 0.7000000000000001
          }
        }
      ],
      "compliance": {
        "valid": true,
        "issues": [
          {
            "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
            "severity": "WARNING",
            "line_number": 1
          }
        ],
        "score": 0.85
      }
    },
    {
      "name": "backend.core.utils.fileio",
      "type": "Module",
      "tier": "STANDARD",
      "start_line": 1,
      "end_line": 488,
      "tags": {
        "SEMANTICS": "file, io, zip, yaml, temp, archive, utility",
        "PURPOSE": "\u041f\u0440\u0435\u0434\u043e\u0441\u0442\u0430\u0432\u043b\u044f\u0435\u0442 \u043d\u0430\u0431\u043e\u0440 \u0443\u0442\u0438\u043b\u0438\u0442 \u0434\u043b\u044f \u0443\u043f\u0440\u0430\u0432\u043b\u0435\u043d\u0438\u044f \u0444\u0430\u0439\u043b\u043e\u0432\u044b\u043c\u0438 \u043e\u043f\u0435\u0440\u0430\u0446\u0438\u044f\u043c\u0438, \u0432\u043a\u043b\u044e\u0447\u0430\u044f \u0440\u0430\u0431\u043e\u0442\u0443 \u0441 \u0432\u0440\u0435\u043c\u0435\u043d\u043d\u044b\u043c\u0438 \u0444\u0430\u0439\u043b\u0430\u043c\u0438, \u0430\u0440\u0445\u0438\u0432\u0430\u043c\u0438 ZIP, \u0444\u0430\u0439\u043b\u0430\u043c\u0438 YAML \u0438 \u043e\u0447\u0438\u0441\u0442\u043a\u0443 \u0434\u0438\u0440\u0435\u043a\u0442\u043e\u0440\u0438\u0439.",
        "LAYER": "Infra",
        "PUBLIC_API": "create_temp_file, remove_empty_directories, read_dashboard_from_disk, calculate_crc32, RetentionPolicy, archive_exports, save_and_unpack_dashboard, update_yamls, create_dashboard_export, sanitize_filename, get_filename_from_headers, consolidate_archive_folders"
      },
      "relations": [
        {
          "type": "DEPENDS_ON",
          "target": "backend.src.core.logger"
        },
        {
          "type": "DEPENDS_ON",
          "target": "pyyaml"
        }
      ],
      "children": [
        {
          "name": "InvalidZipFormatError",
          "type": "Class",
          "tier": "STANDARD",
          "start_line": 26,
          "end_line": 30,
          "tags": {
            "PURPOSE": "Exception raised when a file is not a valid ZIP archive."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 26
              },
              {
                "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 26
              }
            ],
            "score": 0.7000000000000001
          }
        },
        {
          "name": "create_temp_file",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 32,
          "end_line": 71,
          "tags": {
            "PURPOSE": "\u041a\u043e\u043d\u0442\u0435\u043a\u0441\u0442\u043d\u044b\u0439 \u043c\u0435\u043d\u0435\u0434\u0436\u0435\u0440 \u0434\u043b\u044f \u0441\u043e\u0437\u0434\u0430\u043d\u0438\u044f \u0432\u0440\u0435\u043c\u0435\u043d\u043d\u043e\u0433\u043e \u0444\u0430\u0439\u043b\u0430 \u0438\u043b\u0438 \u0434\u0438\u0440\u0435\u043a\u0442\u043e\u0440\u0438\u0438 \u0441 \u0433\u0430\u0440\u0430\u043d\u0442\u0438\u0440\u043e\u0432\u0430\u043d\u043d\u044b\u043c \u0443\u0434\u0430\u043b\u0435\u043d\u0438\u0435\u043c.",
            "PRE": "suffix \u0434\u043e\u043b\u0436\u0435\u043d \u0431\u044b\u0442\u044c \u0441\u0442\u0440\u043e\u043a\u043e\u0439, \u043e\u043f\u0440\u0435\u0434\u0435\u043b\u044f\u044e\u0449\u0435\u0439 \u0442\u0438\u043f \u0440\u0435\u0441\u0443\u0440\u0441\u0430.",
            "POST": "\u0412\u0440\u0435\u043c\u0435\u043d\u043d\u044b\u0439 \u0440\u0435\u0441\u0443\u0440\u0441 \u0441\u043e\u0437\u0434\u0430\u043d \u0438 \u043f\u0443\u0442\u044c \u043a \u043d\u0435\u043c\u0443 \u0432\u043e\u0437\u0432\u0440\u0430\u0449\u0435\u043d; \u0440\u0435\u0441\u0443\u0440\u0441 \u0443\u0434\u0430\u043b\u0435\u043d \u043f\u043e\u0441\u043b\u0435 \u0432\u044b\u0445\u043e\u0434\u0430 \u0438\u0437 \u043a\u043e\u043d\u0442\u0435\u043a\u0441\u0442\u0430.",
            "PARAM": "mode (str) - \u0420\u0435\u0436\u0438\u043c \u0437\u0430\u043f\u0438\u0441\u0438 \u0432 \u0444\u0430\u0439\u043b (e.g., 'wb').",
            "YIELDS": "Path - \u041f\u0443\u0442\u044c \u043a \u0432\u0440\u0435\u043c\u0435\u043d\u043d\u043e\u043c\u0443 \u0440\u0435\u0441\u0443\u0440\u0441\u0443.",
            "THROW": "IOError - \u041f\u0440\u0438 \u043e\u0448\u0438\u0431\u043a\u0430\u0445 \u0441\u043e\u0437\u0434\u0430\u043d\u0438\u044f \u0440\u0435\u0441\u0443\u0440\u0441\u0430."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "remove_empty_directories",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 73,
          "end_line": 96,
          "tags": {
            "PURPOSE": "\u0420\u0435\u043a\u0443\u0440\u0441\u0438\u0432\u043d\u043e \u0443\u0434\u0430\u043b\u044f\u0435\u0442 \u0432\u0441\u0435 \u043f\u0443\u0441\u0442\u044b\u0435 \u043f\u043e\u0434\u0434\u0438\u0440\u0435\u043a\u0442\u043e\u0440\u0438\u0438, \u043d\u0430\u0447\u0438\u043d\u0430\u044f \u0441 \u0443\u043a\u0430\u0437\u0430\u043d\u043d\u043e\u0433\u043e \u043f\u0443\u0442\u0438.",
            "PRE": "root_dir \u0434\u043e\u043b\u0436\u0435\u043d \u0431\u044b\u0442\u044c \u043f\u0443\u0442\u0435\u043c \u043a \u0441\u0443\u0449\u0435\u0441\u0442\u0432\u0443\u044e\u0449\u0435\u0439 \u0434\u0438\u0440\u0435\u043a\u0442\u043e\u0440\u0438\u0438.",
            "POST": "\u0412\u0441\u0435 \u043f\u0443\u0441\u0442\u044b\u0435 \u043f\u043e\u0434\u0434\u0438\u0440\u0435\u043a\u0442\u043e\u0440\u0438\u0438 \u0443\u0434\u0430\u043b\u0435\u043d\u044b, \u0432\u043e\u0437\u0432\u0440\u0430\u0449\u0435\u043d\u043e \u0438\u0445 \u043a\u043e\u043b\u0438\u0447\u0435\u0441\u0442\u0432\u043e.",
            "PARAM": "root_dir (str) - \u041f\u0443\u0442\u044c \u043a \u043a\u043e\u0440\u043d\u0435\u0432\u043e\u0439 \u0434\u0438\u0440\u0435\u043a\u0442\u043e\u0440\u0438\u0438 \u0434\u043b\u044f \u043e\u0447\u0438\u0441\u0442\u043a\u0438.",
            "RETURN": "int - \u041a\u043e\u043b\u0438\u0447\u0435\u0441\u0442\u0432\u043e \u0443\u0434\u0430\u043b\u0435\u043d\u043d\u044b\u0445 \u0434\u0438\u0440\u0435\u043a\u0442\u043e\u0440\u0438\u0439."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "read_dashboard_from_disk",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 98,
          "end_line": 114,
          "tags": {
            "PURPOSE": "\u0427\u0438\u0442\u0430\u0435\u0442 \u0431\u0438\u043d\u0430\u0440\u043d\u043e\u0435 \u0441\u043e\u0434\u0435\u0440\u0436\u0438\u043c\u043e\u0435 \u0444\u0430\u0439\u043b\u0430 \u0441 \u0434\u0438\u0441\u043a\u0430.",
            "PRE": "file_path \u0434\u043e\u043b\u0436\u0435\u043d \u0443\u043a\u0430\u0437\u044b\u0432\u0430\u0442\u044c \u043d\u0430 \u0441\u0443\u0449\u0435\u0441\u0442\u0432\u0443\u044e\u0449\u0438\u0439 \u0444\u0430\u0439\u043b.",
            "POST": "\u0412\u043e\u0437\u0432\u0440\u0430\u0449\u0430\u0435\u0442 \u0431\u0430\u0439\u0442\u044b \u0441\u043e\u0434\u0435\u0440\u0436\u0438\u043c\u043e\u0433\u043e \u0438 \u0438\u043c\u044f \u0444\u0430\u0439\u043b\u0430.",
            "PARAM": "file_path (str) - \u041f\u0443\u0442\u044c \u043a \u0444\u0430\u0439\u043b\u0443.",
            "RETURN": "Tuple[bytes, str] - \u041a\u043e\u0440\u0442\u0435\u0436 (\u0441\u043e\u0434\u0435\u0440\u0436\u0438\u043c\u043e\u0435, \u0438\u043c\u044f \u0444\u0430\u0439\u043b\u0430).",
            "THROW": "FileNotFoundError - \u0415\u0441\u043b\u0438 \u0444\u0430\u0439\u043b \u043d\u0435 \u043d\u0430\u0439\u0434\u0435\u043d."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "calculate_crc32",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 116,
          "end_line": 128,
          "tags": {
            "PURPOSE": "\u0412\u044b\u0447\u0438\u0441\u043b\u044f\u0435\u0442 \u043a\u043e\u043d\u0442\u0440\u043e\u043b\u044c\u043d\u0443\u044e \u0441\u0443\u043c\u043c\u0443 CRC32 \u0434\u043b\u044f \u0444\u0430\u0439\u043b\u0430.",
            "PRE": "file_path \u0434\u043e\u043b\u0436\u0435\u043d \u0431\u044b\u0442\u044c \u043e\u0431\u044a\u0435\u043a\u0442\u043e\u043c Path \u043a \u0441\u0443\u0449\u0435\u0441\u0442\u0432\u0443\u044e\u0449\u0435\u043c\u0443 \u0444\u0430\u0439\u043b\u0443.",
            "POST": "\u0412\u043e\u0437\u0432\u0440\u0430\u0449\u0430\u0435\u0442 8-\u0437\u043d\u0430\u0447\u043d\u0443\u044e hex-\u0441\u0442\u0440\u043e\u043a\u0443 CRC32.",
            "PARAM": "file_path (Path) - \u041f\u0443\u0442\u044c \u043a \u0444\u0430\u0439\u043b\u0443.",
            "RETURN": "str - 8-\u0437\u043d\u0430\u0447\u043d\u043e\u0435 \u0448\u0435\u0441\u0442\u043d\u0430\u0434\u0446\u0430\u0442\u0435\u0440\u0438\u0447\u043d\u043e\u0435 \u043f\u0440\u0435\u0434\u0441\u0442\u0430\u0432\u043b\u0435\u043d\u0438\u0435 CRC32.",
            "THROW": "IOError - \u041f\u0440\u0438 \u043e\u0448\u0438\u0431\u043a\u0430\u0445 \u0447\u0442\u0435\u043d\u0438\u044f \u0444\u0430\u0439\u043b\u0430."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "RetentionPolicy",
          "type": "DataClass",
          "tier": "STANDARD",
          "start_line": 131,
          "end_line": 138,
          "tags": {
            "PURPOSE": "\u041e\u043f\u0440\u0435\u0434\u0435\u043b\u044f\u0435\u0442 \u043f\u043e\u043b\u0438\u0442\u0438\u043a\u0443 \u0445\u0440\u0430\u043d\u0435\u043d\u0438\u044f \u0434\u043b\u044f \u0430\u0440\u0445\u0438\u0432\u043e\u0432 (\u0435\u0436\u0435\u0434\u043d\u0435\u0432\u043d\u044b\u0435, \u0435\u0436\u0435\u043d\u0435\u0434\u0435\u043b\u044c\u043d\u044b\u0435, \u0435\u0436\u0435\u043c\u0435\u0441\u044f\u0447\u043d\u044b\u0435)."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "archive_exports",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 141,
          "end_line": 222,
          "tags": {
            "PURPOSE": "\u0423\u043f\u0440\u0430\u0432\u043b\u044f\u0435\u0442 \u0430\u0440\u0445\u0438\u0432\u043e\u043c \u044d\u043a\u0441\u043f\u043e\u0440\u0442\u0438\u0440\u043e\u0432\u0430\u043d\u043d\u044b\u0445 \u0444\u0430\u0439\u043b\u043e\u0432, \u043f\u0440\u0438\u043c\u0435\u043d\u044f\u044f \u043f\u043e\u043b\u0438\u0442\u0438\u043a\u0443 \u0445\u0440\u0430\u043d\u0435\u043d\u0438\u044f \u0438 \u0434\u0435\u0434\u0443\u043f\u043b\u0438\u043a\u0430\u0446\u0438\u044e.",
            "PRE": "output_dir \u0434\u043e\u043b\u0436\u0435\u043d \u0431\u044b\u0442\u044c \u043f\u0443\u0442\u0435\u043c \u043a \u0441\u0443\u0449\u0435\u0441\u0442\u0432\u0443\u044e\u0449\u0435\u0439 \u0434\u0438\u0440\u0435\u043a\u0442\u043e\u0440\u0438\u0438.",
            "POST": "\u0421\u0442\u0430\u0440\u044b\u0435 \u0438\u043b\u0438 \u0434\u0443\u0431\u043b\u0438\u0440\u0443\u044e\u0449\u0438\u0435\u0441\u044f \u0430\u0440\u0445\u0438\u0432\u044b \u0443\u0434\u0430\u043b\u0435\u043d\u044b \u0441\u043e\u0433\u043b\u0430\u0441\u043d\u043e \u043f\u043e\u043b\u0438\u0442\u0438\u043a\u0435.",
            "PARAM": "deduplicate (bool) - \u0424\u043b\u0430\u0433 \u0434\u043b\u044f \u0432\u043a\u043b\u044e\u0447\u0435\u043d\u0438\u044f \u0443\u0434\u0430\u043b\u0435\u043d\u0438\u044f \u0434\u0443\u0431\u043b\u0438\u043a\u0430\u0442\u043e\u0432 \u043f\u043e CRC32."
          },
          "relations": [
            {
              "type": "CALLS",
              "target": "apply_retention_policy"
            },
            {
              "type": "CALLS",
              "target": "calculate_crc32"
            }
          ],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "apply_retention_policy",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 224,
          "end_line": 257,
          "tags": {
            "PURPOSE": "(Helper) \u041f\u0440\u0438\u043c\u0435\u043d\u044f\u0435\u0442 \u043f\u043e\u043b\u0438\u0442\u0438\u043a\u0443 \u0445\u0440\u0430\u043d\u0435\u043d\u0438\u044f \u043a \u0441\u043f\u0438\u0441\u043a\u0443 \u0444\u0430\u0439\u043b\u043e\u0432, \u0432\u043e\u0437\u0432\u0440\u0430\u0449\u0430\u044f \u0442\u0435, \u0447\u0442\u043e \u043d\u0443\u0436\u043d\u043e \u0441\u043e\u0445\u0440\u0430\u043d\u0438\u0442\u044c.",
            "PRE": "files_with_dates is a list of (Path, date) tuples.",
            "POST": "Returns a set of files to keep.",
            "PARAM": "policy (RetentionPolicy) - \u041f\u043e\u043b\u0438\u0442\u0438\u043a\u0430 \u0445\u0440\u0430\u043d\u0435\u043d\u0438\u044f.",
            "RETURN": "set - \u041c\u043d\u043e\u0436\u0435\u0441\u0442\u0432\u043e \u043f\u0443\u0442\u0435\u0439 \u043a \u0444\u0430\u0439\u043b\u0430\u043c, \u043a\u043e\u0442\u043e\u0440\u044b\u0435 \u0434\u043e\u043b\u0436\u043d\u044b \u0431\u044b\u0442\u044c \u0441\u043e\u0445\u0440\u0430\u043d\u0435\u043d\u044b."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "save_and_unpack_dashboard",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 259,
          "end_line": 288,
          "tags": {
            "PURPOSE": "\u0421\u043e\u0445\u0440\u0430\u043d\u044f\u0435\u0442 \u0431\u0438\u043d\u0430\u0440\u043d\u043e\u0435 \u0441\u043e\u0434\u0435\u0440\u0436\u0438\u043c\u043e\u0435 ZIP-\u0430\u0440\u0445\u0438\u0432\u0430 \u043d\u0430 \u0434\u0438\u0441\u043a \u0438 \u043e\u043f\u0446\u0438\u043e\u043d\u0430\u043b\u044c\u043d\u043e \u0440\u0430\u0441\u043f\u0430\u043a\u043e\u0432\u044b\u0432\u0430\u0435\u0442 \u0435\u0433\u043e.",
            "PRE": "zip_content \u0434\u043e\u043b\u0436\u0435\u043d \u0431\u044b\u0442\u044c \u0431\u0430\u0439\u0442\u0430\u043c\u0438 \u0432\u0430\u043b\u0438\u0434\u043d\u043e\u0433\u043e ZIP-\u0430\u0440\u0445\u0438\u0432\u0430.",
            "POST": "ZIP-\u0444\u0430\u0439\u043b \u0441\u043e\u0445\u0440\u0430\u043d\u0435\u043d, \u0438 \u0435\u0441\u043b\u0438 unpack=True, \u043e\u043d \u0440\u0430\u0441\u043f\u0430\u043a\u043e\u0432\u0430\u043d \u0432 output_dir.",
            "PARAM": "original_filename (Optional[str]) - \u0418\u0441\u0445\u043e\u0434\u043d\u043e\u0435 \u0438\u043c\u044f \u0444\u0430\u0439\u043b\u0430 \u0434\u043b\u044f \u0441\u043e\u0445\u0440\u0430\u043d\u0435\u043d\u0438\u044f.",
            "RETURN": "Tuple[Path, Optional[Path]] - \u041f\u0443\u0442\u044c \u043a ZIP-\u0444\u0430\u0439\u043b\u0443 \u0438, \u0435\u0441\u043b\u0438 \u043f\u0440\u0438\u043c\u0435\u043d\u0438\u043c\u043e, \u043f\u0443\u0442\u044c \u043a \u0434\u0438\u0440\u0435\u043a\u0442\u043e\u0440\u0438\u0438 \u0441 \u0440\u0430\u0441\u043f\u0430\u043a\u043e\u0432\u043a\u043e\u0439.",
            "THROW": "InvalidZipFormatError - \u041f\u0440\u0438 \u043e\u0448\u0438\u0431\u043a\u0435 \u0444\u043e\u0440\u043c\u0430\u0442\u0430 ZIP."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "update_yamls",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 290,
          "end_line": 310,
          "tags": {
            "PURPOSE": "\u041e\u0431\u043d\u043e\u0432\u043b\u044f\u0435\u0442 \u043a\u043e\u043d\u0444\u0438\u0433\u0443\u0440\u0430\u0446\u0438\u0438 \u0432 YAML-\u0444\u0430\u0439\u043b\u0430\u0445, \u0437\u0430\u043c\u0435\u043d\u044f\u044f \u0437\u043d\u0430\u0447\u0435\u043d\u0438\u044f \u0438\u043b\u0438 \u043f\u0440\u0438\u043c\u0435\u043d\u044f\u044f regex.",
            "PRE": "path \u0434\u043e\u043b\u0436\u0435\u043d \u0431\u044b\u0442\u044c \u0441\u0443\u0449\u0435\u0441\u0442\u0432\u0443\u044e\u0449\u0435\u0439 \u0434\u0438\u0440\u0435\u043a\u0442\u043e\u0440\u0438\u0435\u0439.",
            "POST": "\u0412\u0441\u0435 YAML \u0444\u0430\u0439\u043b\u044b \u0432 \u0434\u0438\u0440\u0435\u043a\u0442\u043e\u0440\u0438\u0438 \u043e\u0431\u043d\u043e\u0432\u043b\u0435\u043d\u044b \u0441\u043e\u0433\u043b\u0430\u0441\u043d\u043e \u043f\u0435\u0440\u0435\u0434\u0430\u043d\u043d\u044b\u043c \u043f\u0430\u0440\u0430\u043c\u0435\u0442\u0440\u0430\u043c.",
            "THROW": "FileNotFoundError - \u0415\u0441\u043b\u0438 `path` \u043d\u0435 \u0441\u0443\u0449\u0435\u0441\u0442\u0432\u0443\u0435\u0442.",
            "PARAM": "replace_string (Optional[LiteralString]) - \u0421\u0442\u0440\u043e\u043a\u0430 \u0434\u043b\u044f \u0437\u0430\u043c\u0435\u043d\u044b."
          },
          "relations": [
            {
              "type": "CALLS",
              "target": "_update_yaml_file"
            }
          ],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "_update_yaml_file",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 312,
          "end_line": 377,
          "tags": {
            "PURPOSE": "(Helper) \u041e\u0431\u043d\u043e\u0432\u043b\u044f\u0435\u0442 \u043e\u0434\u0438\u043d YAML \u0444\u0430\u0439\u043b.",
            "PRE": "file_path \u0434\u043e\u043b\u0436\u0435\u043d \u0431\u044b\u0442\u044c \u043e\u0431\u044a\u0435\u043a\u0442\u043e\u043c Path \u043a \u0441\u0443\u0449\u0435\u0441\u0442\u0432\u0443\u044e\u0449\u0435\u043c\u0443 YAML \u0444\u0430\u0439\u043b\u0443.",
            "POST": "\u0424\u0430\u0439\u043b \u043e\u0431\u043d\u043e\u0432\u043b\u0435\u043d \u0441\u043e\u0433\u043b\u0430\u0441\u043d\u043e \u043f\u0435\u0440\u0435\u0434\u0430\u043d\u043d\u044b\u043c \u043a\u043e\u043d\u0444\u0438\u0433\u0443\u0440\u0430\u0446\u0438\u044f\u043c \u0438\u043b\u0438 \u0440\u0435\u0433\u0443\u043b\u044f\u0440\u043d\u043e\u043c\u0443 \u0432\u044b\u0440\u0430\u0436\u0435\u043d\u0438\u044e.",
            "PARAM": "replace_string (Optional[str]) - \u0417\u0430\u043c\u0435\u043d\u0430."
          },
          "relations": [],
          "children": [
            {
              "name": "replacer",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 359,
              "end_line": 368,
              "tags": {
                "PURPOSE": "\u0424\u0443\u043d\u043a\u0446\u0438\u044f \u0437\u0430\u043c\u0435\u043d\u044b, \u0441\u043e\u0445\u0440\u0430\u043d\u044f\u044e\u0449\u0430\u044f \u043a\u0430\u0432\u044b\u0447\u043a\u0438 \u0435\u0441\u043b\u0438 \u043e\u043d\u0438 \u0431\u044b\u043b\u0438.",
                "PRE": "match \u0434\u043e\u043b\u0436\u0435\u043d \u0431\u044b\u0442\u044c \u043e\u0431\u044a\u0435\u043a\u0442\u043e\u043c \u0441\u043e\u0432\u043f\u0430\u0434\u0435\u043d\u0438\u044f \u0440\u0435\u0433\u0443\u043b\u044f\u0440\u043d\u043e\u0433\u043e \u0432\u044b\u0440\u0430\u0436\u0435\u043d\u0438\u044f.",
                "POST": "\u0412\u043e\u0437\u0432\u0440\u0430\u0449\u0430\u0435\u0442 \u0441\u0442\u0440\u043e\u043a\u0443 \u0441 \u043d\u043e\u0432\u044b\u043c \u0437\u043d\u0430\u0447\u0435\u043d\u0438\u0435\u043c, \u0441\u043e\u0445\u0440\u0430\u043d\u044f\u044f \u043f\u0440\u0435\u0444\u0438\u043a\u0441 \u0438 \u043a\u0430\u0432\u044b\u0447\u043a\u0438."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [
                  {
                    "message": "Missing Belief State Logging: Function should use belief_scope (required for STANDARD tier)",
                    "severity": "WARNING",
                    "line_number": 359
                  },
                  {
                    "message": "Missing Belief State Logging: Function should use belief_scope (required for STANDARD tier)",
                    "severity": "WARNING",
                    "line_number": 359
                  },
                  {
                    "message": "Missing Belief State Logging: Function should use belief_scope (required for STANDARD tier)",
                    "severity": "WARNING",
                    "line_number": 359
                  }
                ],
                "score": 0.7
              }
            }
          ],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "create_dashboard_export",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 379,
          "end_line": 405,
          "tags": {
            "PURPOSE": "\u0421\u043e\u0437\u0434\u0430\u0435\u0442 ZIP-\u0430\u0440\u0445\u0438\u0432 \u0438\u0437 \u0443\u043a\u0430\u0437\u0430\u043d\u043d\u044b\u0445 \u0438\u0441\u0445\u043e\u0434\u043d\u044b\u0445 \u043f\u0443\u0442\u0435\u0439.",
            "PRE": "source_paths \u0434\u043e\u043b\u0436\u0435\u043d \u0441\u043e\u0434\u0435\u0440\u0436\u0430\u0442\u044c \u0441\u0443\u0449\u0435\u0441\u0442\u0432\u0443\u044e\u0449\u0438\u0435 \u043f\u0443\u0442\u0438.",
            "POST": "ZIP-\u0430\u0440\u0445\u0438\u0432 \u0441\u043e\u0437\u0434\u0430\u043d \u043f\u043e \u043f\u0443\u0442\u0438 zip_path.",
            "PARAM": "exclude_extensions (Optional[List[str]]) - \u0421\u043f\u0438\u0441\u043e\u043a \u0440\u0430\u0441\u0448\u0438\u0440\u0435\u043d\u0438\u0439 \u0434\u043b\u044f \u0438\u0441\u043a\u043b\u044e\u0447\u0435\u043d\u0438\u044f.",
            "RETURN": "bool - `True` \u043f\u0440\u0438 \u0443\u0441\u043f\u0435\u0445\u0435, `False` \u043f\u0440\u0438 \u043e\u0448\u0438\u0431\u043a\u0435."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "sanitize_filename",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 407,
          "end_line": 416,
          "tags": {
            "PURPOSE": "\u041e\u0447\u0438\u0449\u0430\u0435\u0442 \u0441\u0442\u0440\u043e\u043a\u0443 \u043e\u0442 \u0441\u0438\u043c\u0432\u043e\u043b\u043e\u0432, \u043d\u0435\u0434\u043e\u043f\u0443\u0441\u0442\u0438\u043c\u044b\u0445 \u0432 \u0438\u043c\u0435\u043d\u0430\u0445 \u0444\u0430\u0439\u043b\u043e\u0432.",
            "PRE": "filename \u0434\u043e\u043b\u0436\u0435\u043d \u0431\u044b\u0442\u044c \u0441\u0442\u0440\u043e\u043a\u043e\u0439.",
            "POST": "\u0412\u043e\u0437\u0432\u0440\u0430\u0449\u0430\u0435\u0442 \u0441\u0442\u0440\u043e\u043a\u0443 \u0431\u0435\u0437 \u0441\u043f\u0435\u0446\u0441\u0438\u043c\u0432\u043e\u043b\u043e\u0432.",
            "PARAM": "filename (str) - \u0418\u0441\u0445\u043e\u0434\u043d\u043e\u0435 \u0438\u043c\u044f \u0444\u0430\u0439\u043b\u0430.",
            "RETURN": "str - \u041e\u0447\u0438\u0449\u0435\u043d\u043d\u0430\u044f \u0441\u0442\u0440\u043e\u043a\u0430."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "get_filename_from_headers",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 418,
          "end_line": 430,
          "tags": {
            "PURPOSE": "\u0418\u0437\u0432\u043b\u0435\u043a\u0430\u0435\u0442 \u0438\u043c\u044f \u0444\u0430\u0439\u043b\u0430 \u0438\u0437 HTTP \u0437\u0430\u0433\u043e\u043b\u043e\u0432\u043a\u0430 'Content-Disposition'.",
            "PRE": "headers \u0434\u043e\u043b\u0436\u0435\u043d \u0431\u044b\u0442\u044c \u0441\u043b\u043e\u0432\u0430\u0440\u0435\u043c \u0437\u0430\u0433\u043e\u043b\u043e\u0432\u043a\u043e\u0432.",
            "POST": "\u0412\u043e\u0437\u0432\u0440\u0430\u0449\u0430\u0435\u0442 \u0438\u043c\u044f \u0444\u0430\u0439\u043b\u0430 \u0438\u043b\u0438 None, \u0435\u0441\u043b\u0438 \u0437\u0430\u0433\u043e\u043b\u043e\u0432\u043e\u043a \u043e\u0442\u0441\u0443\u0442\u0441\u0442\u0432\u0443\u0435\u0442.",
            "PARAM": "headers (dict) - \u0421\u043b\u043e\u0432\u0430\u0440\u044c HTTP \u0437\u0430\u0433\u043e\u043b\u043e\u0432\u043a\u043e\u0432.",
            "RETURN": "Optional[str] - \u0418\u043c\u044f \u0444\u0430\u0439\u043b\u0430 or `None`."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "consolidate_archive_folders",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 432,
          "end_line": 486,
          "tags": {
            "PURPOSE": "\u041a\u043e\u043d\u0441\u043e\u043b\u0438\u0434\u0438\u0440\u0443\u0435\u0442 \u0434\u0438\u0440\u0435\u043a\u0442\u043e\u0440\u0438\u0438 \u0430\u0440\u0445\u0438\u0432\u043e\u0432 \u043d\u0430 \u043e\u0441\u043d\u043e\u0432\u0435 \u043e\u0431\u0449\u0435\u0433\u043e \u0441\u043b\u0430\u0433\u0430 \u0432 \u0438\u043c\u0435\u043d\u0438.",
            "PRE": "root_directory \u0434\u043e\u043b\u0436\u0435\u043d \u0431\u044b\u0442\u044c \u043e\u0431\u044a\u0435\u043a\u0442\u043e\u043c Path \u043a \u0441\u0443\u0449\u0435\u0441\u0442\u0432\u0443\u044e\u0449\u0435\u0439 \u0434\u0438\u0440\u0435\u043a\u0442\u043e\u0440\u0438\u0438.",
            "POST": "\u0414\u0438\u0440\u0435\u043a\u0442\u043e\u0440\u0438\u0438 \u0441 \u043e\u0434\u0438\u043d\u0430\u043a\u043e\u0432\u044b\u043c \u043f\u0440\u0435\u0444\u0438\u043a\u0441\u043e\u043c \u043e\u0431\u044a\u0435\u0434\u0438\u043d\u0435\u043d\u044b \u0432 \u043e\u0434\u043d\u0443.",
            "THROW": "TypeError, ValueError - \u0415\u0441\u043b\u0438 `root_directory` \u043d\u0435\u0432\u0430\u043b\u0438\u0434\u0435\u043d.",
            "PARAM": "root_directory (Path) - \u041a\u043e\u0440\u043d\u0435\u0432\u0430\u044f \u0434\u0438\u0440\u0435\u043a\u0442\u043e\u0440\u0438\u044f \u0434\u043b\u044f \u043a\u043e\u043d\u0441\u043e\u043b\u0438\u0434\u0430\u0446\u0438\u0438."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        }
      ],
      "compliance": {
        "valid": true,
        "issues": [
          {
            "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
            "severity": "WARNING",
            "line_number": 1
          }
        ],
        "score": 0.85
      }
    },
    {
      "name": "backend.core.utils.network",
      "type": "Module",
      "tier": "STANDARD",
      "start_line": 1,
      "end_line": 340,
      "tags": {
        "SEMANTICS": "network, http, client, api, requests, session, authentication",
        "PURPOSE": "\u0418\u043d\u043a\u0430\u043f\u0441\u0443\u043b\u0438\u0440\u0443\u0435\u0442 \u043d\u0438\u0437\u043a\u043e\u0443\u0440\u043e\u0432\u043d\u0435\u0432\u0443\u044e HTTP-\u043b\u043e\u0433\u0438\u043a\u0443 \u0434\u043b\u044f \u0432\u0437\u0430\u0438\u043c\u043e\u0434\u0435\u0439\u0441\u0442\u0432\u0438\u044f \u0441 Superset API, \u0432\u043a\u043b\u044e\u0447\u0430\u044f \u0430\u0443\u0442\u0435\u043d\u0442\u0438\u0444\u0438\u043a\u0430\u0446\u0438\u044e, \u0443\u043f\u0440\u0430\u0432\u043b\u0435\u043d\u0438\u0435 \u0441\u0435\u0441\u0441\u0438\u0435\u0439, retry-\u043b\u043e\u0433\u0438\u043a\u0443 \u0438 \u043e\u0431\u0440\u0430\u0431\u043e\u0442\u043a\u0443 \u043e\u0448\u0438\u0431\u043e\u043a.",
        "LAYER": "Infra",
        "PUBLIC_API": "APIClient"
      },
      "relations": [
        {
          "type": "DEPENDS_ON",
          "target": "backend.src.core.logger"
        },
        {
          "type": "DEPENDS_ON",
          "target": "requests"
        }
      ],
      "children": [
        {
          "name": "SupersetAPIError",
          "type": "Class",
          "tier": "STANDARD",
          "start_line": 22,
          "end_line": 34,
          "tags": {
            "PURPOSE": "Base exception for all Superset API related errors."
          },
          "relations": [],
          "children": [
            {
              "name": "__init__",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 25,
              "end_line": 33,
              "tags": {
                "PURPOSE": "Initializes the exception with a message and context.",
                "PRE": "message is a string, context is a dict.",
                "POST": "Exception is initialized with context."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            }
          ],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 22
              },
              {
                "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 22
              }
            ],
            "score": 0.7000000000000001
          }
        },
        {
          "name": "AuthenticationError",
          "type": "Class",
          "tier": "STANDARD",
          "start_line": 36,
          "end_line": 47,
          "tags": {
            "PURPOSE": "Exception raised when authentication fails."
          },
          "relations": [],
          "children": [
            {
              "name": "__init__",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 39,
              "end_line": 46,
              "tags": {
                "PURPOSE": "Initializes the authentication error.",
                "PRE": "message is a string, context is a dict.",
                "POST": "AuthenticationError is initialized."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            }
          ],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 36
              },
              {
                "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 36
              }
            ],
            "score": 0.7000000000000001
          }
        },
        {
          "name": "PermissionDeniedError",
          "type": "Class",
          "tier": "STANDARD",
          "start_line": 49,
          "end_line": 60,
          "tags": {
            "PURPOSE": "Exception raised when access is denied."
          },
          "relations": [],
          "children": [
            {
              "name": "__init__",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 52,
              "end_line": 59,
              "tags": {
                "PURPOSE": "Initializes the permission denied error.",
                "PRE": "message is a string, context is a dict.",
                "POST": "PermissionDeniedError is initialized."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            }
          ],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 49
              },
              {
                "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 49
              }
            ],
            "score": 0.7000000000000001
          }
        },
        {
          "name": "DashboardNotFoundError",
          "type": "Class",
          "tier": "STANDARD",
          "start_line": 62,
          "end_line": 73,
          "tags": {
            "PURPOSE": "Exception raised when a dashboard cannot be found."
          },
          "relations": [],
          "children": [
            {
              "name": "__init__",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 65,
              "end_line": 72,
              "tags": {
                "PURPOSE": "Initializes the not found error with resource ID.",
                "PRE": "resource_id is provided.",
                "POST": "DashboardNotFoundError is initialized."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            }
          ],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 62
              },
              {
                "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 62
              }
            ],
            "score": 0.7000000000000001
          }
        },
        {
          "name": "NetworkError",
          "type": "Class",
          "tier": "STANDARD",
          "start_line": 75,
          "end_line": 87,
          "tags": {
            "PURPOSE": "Exception raised when a network level error occurs."
          },
          "relations": [],
          "children": [
            {
              "name": "__init__",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 78,
              "end_line": 86,
              "tags": {
                "PURPOSE": "Initializes the network error.",
                "PRE": "message is a string.",
                "POST": "NetworkError is initialized."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            }
          ],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 75
              },
              {
                "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 75
              }
            ],
            "score": 0.7000000000000001
          }
        },
        {
          "name": "APIClient",
          "type": "Class",
          "tier": "STANDARD",
          "start_line": 89,
          "end_line": 338,
          "tags": {
            "PURPOSE": "\u0418\u043d\u043a\u0430\u043f\u0441\u0443\u043b\u0438\u0440\u0443\u0435\u0442 HTTP-\u043b\u043e\u0433\u0438\u043a\u0443 \u0434\u043b\u044f \u0440\u0430\u0431\u043e\u0442\u044b \u0441 API, \u0432\u043a\u043b\u044e\u0447\u0430\u044f \u0441\u0435\u0441\u0441\u0438\u0438, \u0430\u0443\u0442\u0435\u043d\u0442\u0438\u0444\u0438\u043a\u0430\u0446\u0438\u044e, \u0438 \u043e\u0431\u0440\u0430\u0431\u043e\u0442\u043a\u0443 \u0437\u0430\u043f\u0440\u043e\u0441\u043e\u0432."
          },
          "relations": [],
          "children": [
            {
              "name": "__init__",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 94,
              "end_line": 111,
              "tags": {
                "PURPOSE": "\u0418\u043d\u0438\u0446\u0438\u0430\u043b\u0438\u0437\u0438\u0440\u0443\u0435\u0442 API \u043a\u043b\u0438\u0435\u043d\u0442 \u0441 \u043a\u043e\u043d\u0444\u0438\u0433\u0443\u0440\u0430\u0446\u0438\u0435\u0439, \u0441\u0435\u0441\u0441\u0438\u0435\u0439 \u0438 \u043b\u043e\u0433\u0433\u0435\u0440\u043e\u043c.",
                "PARAM": "timeout (int) - \u0422\u0430\u0439\u043c\u0430\u0443\u0442 \u0437\u0430\u043f\u0440\u043e\u0441\u043e\u0432.",
                "PRE": "config must contain 'base_url' and 'auth'.",
                "POST": "APIClient instance is initialized with a session."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            },
            {
              "name": "_init_session",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 113,
              "end_line": 130,
              "tags": {
                "PURPOSE": "\u0421\u043e\u0437\u0434\u0430\u0435\u0442 \u0438 \u043d\u0430\u0441\u0442\u0440\u0430\u0438\u0432\u0430\u0435\u0442 `requests.Session` \u0441 retry-\u043b\u043e\u0433\u0438\u043a\u043e\u0439.",
                "PRE": "self.request_settings must be initialized.",
                "POST": "Returns a configured requests.Session instance.",
                "RETURN": "requests.Session - \u041d\u0430\u0441\u0442\u0440\u043e\u0435\u043d\u043d\u0430\u044f \u0441\u0435\u0441\u0441\u0438\u044f."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            },
            {
              "name": "authenticate",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 132,
              "end_line": 171,
              "tags": {
                "PURPOSE": "\u0412\u044b\u043f\u043e\u043b\u043d\u044f\u0435\u0442 \u0430\u0443\u0442\u0435\u043d\u0442\u0438\u0444\u0438\u043a\u0430\u0446\u0438\u044e \u0432 Superset API \u0438 \u043f\u043e\u043b\u0443\u0447\u0430\u0435\u0442 access \u0438 CSRF \u0442\u043e\u043a\u0435\u043d\u044b.",
                "PRE": "self.auth and self.base_url must be valid.",
                "POST": "`self._tokens` \u0437\u0430\u043f\u043e\u043b\u043d\u0435\u043d, `self._authenticated` \u0443\u0441\u0442\u0430\u043d\u043e\u0432\u043b\u0435\u043d \u0432 `True`.",
                "RETURN": "Dict[str, str] - \u0421\u043b\u043e\u0432\u0430\u0440\u044c \u0441 \u0442\u043e\u043a\u0435\u043d\u0430\u043c\u0438.",
                "THROW": "AuthenticationError, NetworkError - \u043f\u0440\u0438 \u043e\u0448\u0438\u0431\u043a\u0430\u0445."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            },
            {
              "name": "headers",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 174,
              "end_line": 187,
              "tags": {
                "PURPOSE": "\u0412\u043e\u0437\u0432\u0440\u0430\u0449\u0430\u0435\u0442 HTTP-\u0437\u0430\u0433\u043e\u043b\u043e\u0432\u043a\u0438 \u0434\u043b\u044f \u0430\u0443\u0442\u0435\u043d\u0442\u0438\u0444\u0438\u0446\u0438\u0440\u043e\u0432\u0430\u043d\u043d\u044b\u0445 \u0437\u0430\u043f\u0440\u043e\u0441\u043e\u0432.",
                "PRE": "APIClient is initialized and authenticated or can be authenticated.",
                "POST": "Returns headers including auth tokens."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            },
            {
              "name": "request",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 189,
              "end_line": 213,
              "tags": {
                "PURPOSE": "\u0412\u044b\u043f\u043e\u043b\u043d\u044f\u0435\u0442 \u0443\u043d\u0438\u0432\u0435\u0440\u0441\u0430\u043b\u044c\u043d\u044b\u0439 HTTP-\u0437\u0430\u043f\u0440\u043e\u0441 \u043a API.",
                "PARAM": "raw_response (bool) - \u0412\u043e\u0437\u0432\u0440\u0430\u0449\u0430\u0442\u044c \u043b\u0438 \u0441\u044b\u0440\u043e\u0439 \u043e\u0442\u0432\u0435\u0442.",
                "PRE": "method and endpoint must be strings.",
                "POST": "Returns response content or raw Response object.",
                "RETURN": "`requests.Response` \u0435\u0441\u043b\u0438 `raw_response=True`, \u0438\u043d\u0430\u0447\u0435 `dict`.",
                "THROW": "SupersetAPIError, NetworkError \u0438 \u0438\u0445 \u043f\u043e\u0434\u043a\u043b\u0430\u0441\u0441\u044b."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            },
            {
              "name": "_handle_http_error",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 215,
              "end_line": 230,
              "tags": {
                "PURPOSE": "(Helper) \u041f\u0440\u0435\u043e\u0431\u0440\u0430\u0437\u0443\u0435\u0442 HTTP \u043e\u0448\u0438\u0431\u043a\u0438 \u0432 \u043a\u0430\u0441\u0442\u043e\u043c\u043d\u044b\u0435 \u0438\u0441\u043a\u043b\u044e\u0447\u0435\u043d\u0438\u044f.",
                "PARAM": "endpoint (str) - \u042d\u043d\u0434\u043f\u043e\u0438\u043d\u0442.",
                "PRE": "e must be a valid HTTPError with a response.",
                "POST": "Raises a specific SupersetAPIError or subclass."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            },
            {
              "name": "_handle_network_error",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 232,
              "end_line": 244,
              "tags": {
                "PURPOSE": "(Helper) \u041f\u0440\u0435\u043e\u0431\u0440\u0430\u0437\u0443\u0435\u0442 \u0441\u0435\u0442\u0435\u0432\u044b\u0435 \u043e\u0448\u0438\u0431\u043a\u0438 \u0432 `NetworkError`.",
                "PARAM": "url (str) - URL.",
                "PRE": "e must be a RequestException.",
                "POST": "Raises a NetworkError."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            },
            {
              "name": "upload_file",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 246,
              "end_line": 273,
              "tags": {
                "PURPOSE": "\u0417\u0430\u0433\u0440\u0443\u0436\u0430\u0435\u0442 \u0444\u0430\u0439\u043b \u043d\u0430 \u0441\u0435\u0440\u0432\u0435\u0440 \u0447\u0435\u0440\u0435\u0437 multipart/form-data.",
                "PARAM": "timeout (Optional[int]) - \u0422\u0430\u0439\u043c\u0430\u0443\u0442.",
                "PRE": "file_info must contain 'file_obj' and 'file_name'.",
                "POST": "File is uploaded and response returned.",
                "RETURN": "\u041e\u0442\u0432\u0435\u0442 API \u0432 \u0432\u0438\u0434\u0435 \u0441\u043b\u043e\u0432\u0430\u0440\u044f.",
                "THROW": "SupersetAPIError, NetworkError, TypeError."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            },
            {
              "name": "_perform_upload",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 275,
              "end_line": 301,
              "tags": {
                "PURPOSE": "(Helper) \u0412\u044b\u043f\u043e\u043b\u043d\u044f\u0435\u0442 POST \u0437\u0430\u043f\u0440\u043e\u0441 \u0441 \u0444\u0430\u0439\u043b\u043e\u043c.",
                "PARAM": "timeout (Optional[int]) - \u0422\u0430\u0439\u043c\u0430\u0443\u0442.",
                "PRE": "url, files, and headers must be provided.",
                "POST": "POST request is performed and JSON response returned.",
                "RETURN": "Dict - \u041e\u0442\u0432\u0435\u0442."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            },
            {
              "name": "fetch_paginated_count",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 303,
              "end_line": 315,
              "tags": {
                "PURPOSE": "\u041f\u043e\u043b\u0443\u0447\u0430\u0435\u0442 \u043e\u0431\u0449\u0435\u0435 \u043a\u043e\u043b\u0438\u0447\u0435\u0441\u0442\u0432\u043e \u044d\u043b\u0435\u043c\u0435\u043d\u0442\u043e\u0432 \u0434\u043b\u044f \u043f\u0430\u0433\u0438\u043d\u0430\u0446\u0438\u0438.",
                "PARAM": "count_field (str) - \u041f\u043e\u043b\u0435 \u0441 \u043a\u043e\u043b\u0438\u0447\u0435\u0441\u0442\u0432\u043e\u043c.",
                "PRE": "query_params must be a dictionary.",
                "POST": "Returns total count of items.",
                "RETURN": "int - \u041a\u043e\u043b\u0438\u0447\u0435\u0441\u0442\u0432\u043e."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            },
            {
              "name": "fetch_paginated_data",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 317,
              "end_line": 336,
              "tags": {
                "PURPOSE": "\u0410\u0432\u0442\u043e\u043c\u0430\u0442\u0438\u0447\u0435\u0441\u043a\u0438 \u0441\u043e\u0431\u0438\u0440\u0430\u0435\u0442 \u0434\u0430\u043d\u043d\u044b\u0435 \u0441\u043e \u0432\u0441\u0435\u0445 \u0441\u0442\u0440\u0430\u043d\u0438\u0446 \u043f\u0430\u0433\u0438\u043d\u0438\u0440\u043e\u0432\u0430\u043d\u043d\u043e\u0433\u043e \u044d\u043d\u0434\u043f\u043e\u0438\u043d\u0442\u0430.",
                "PARAM": "pagination_options (Dict[str, Any]) - \u041e\u043f\u0446\u0438\u0438 \u043f\u0430\u0433\u0438\u043d\u0430\u0446\u0438\u0438.",
                "PRE": "pagination_options must contain 'base_query', 'total_count', 'results_field'.",
                "POST": "Returns all items across all pages.",
                "RETURN": "List[Any] - \u0421\u043f\u0438\u0441\u043e\u043a \u0434\u0430\u043d\u043d\u044b\u0445."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            }
          ],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 89
              },
              {
                "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 89
              }
            ],
            "score": 0.7000000000000001
          }
        }
      ],
      "compliance": {
        "valid": true,
        "issues": [
          {
            "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
            "severity": "WARNING",
            "line_number": 1
          }
        ],
        "score": 0.85
      }
    },
    {
      "name": "backend.src.core.utils.matching",
      "type": "Module",
      "tier": "STANDARD",
      "start_line": 1,
      "end_line": 53,
      "tags": {
        "SEMANTICS": "fuzzy, matching, rapidfuzz, database, mapping",
        "PURPOSE": "Provides utility functions for fuzzy matching database names.",
        "LAYER": "Core",
        "INVARIANT": "Confidence scores are returned as floats between 0.0 and 1.0."
      },
      "relations": [
        {
          "type": "DEPENDS_ON",
          "target": "rapidfuzz"
        }
      ],
      "children": [
        {
          "name": "suggest_mappings",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 15,
          "end_line": 51,
          "tags": {
            "PURPOSE": "Suggests mappings between source and target databases using fuzzy matching.",
            "PRE": "source_databases and target_databases are lists of dictionaries with 'uuid' and 'database_name'.",
            "POST": "Returns a list of suggested mappings with confidence scores.",
            "PARAM": "threshold (int) - Minimum confidence score (0-100).",
            "RETURN": "List[Dict] - Suggested mappings."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Belief State Logging: Function should use belief_scope (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 15
              },
              {
                "message": "Missing Belief State Logging: Function should use belief_scope (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 15
              }
            ],
            "score": 0.8
          }
        }
      ],
      "compliance": {
        "valid": true,
        "issues": [
          {
            "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
            "severity": "WARNING",
            "line_number": 1
          }
        ],
        "score": 0.85
      }
    },
    {
      "name": "backend.core.utils.dataset_mapper",
      "type": "Module",
      "tier": "STANDARD",
      "start_line": 1,
      "end_line": 237,
      "tags": {
        "SEMANTICS": "dataset, mapping, postgresql, xlsx, superset",
        "PURPOSE": "\u042d\u0442\u043e\u0442 \u043c\u043e\u0434\u0443\u043b\u044c \u043e\u0442\u0432\u0435\u0447\u0430\u0435\u0442 \u0437\u0430 \u043e\u0431\u043d\u043e\u0432\u043b\u0435\u043d\u0438\u0435 \u043c\u0435\u0442\u0430\u0434\u0430\u043d\u043d\u044b\u0445 (verbose_map) \u0432 \u0434\u0430\u0442\u0430\u0441\u0435\u0442\u0430\u0445 Superset, \u0438\u0437\u0432\u043b\u0435\u043a\u0430\u044f \u0438\u0445 \u0438\u0437 PostgreSQL \u0438\u043b\u0438 XLSX-\u0444\u0430\u0439\u043b\u043e\u0432.",
        "LAYER": "Domain",
        "PUBLIC_API": "DatasetMapper"
      },
      "relations": [
        {
          "type": "DEPENDS_ON",
          "target": "backend.core.superset_client"
        },
        {
          "type": "DEPENDS_ON",
          "target": "pandas"
        },
        {
          "type": "DEPENDS_ON",
          "target": "psycopg2"
        }
      ],
      "children": [
        {
          "name": "DatasetMapper",
          "type": "Class",
          "tier": "STANDARD",
          "start_line": 18,
          "end_line": 235,
          "tags": {
            "PURPOSE": "\u041a\u043b\u0430\u0441\u0441 \u0434\u043b\u044f \u043c\u0435\u043f\u043f\u0438\u043d\u0433\u0430 \u0438 \u043e\u0431\u043d\u043e\u0432\u043b\u0435\u043d\u0438\u044f verbose_map \u0432 \u0434\u0430\u0442\u0430\u0441\u0435\u0442\u0430\u0445 Superset."
          },
          "relations": [],
          "children": [
            {
              "name": "__init__",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 21,
              "end_line": 26,
              "tags": {
                "PURPOSE": "Initializes the mapper.",
                "POST": "\u041e\u0431\u044a\u0435\u043a\u0442 DatasetMapper \u0438\u043d\u0438\u0446\u0438\u0430\u043b\u0438\u0437\u0438\u0440\u043e\u0432\u0430\u043d."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [
                  {
                    "message": "Missing Mandatory Tag: @PRE (required for STANDARD tier)",
                    "severity": "WARNING",
                    "line_number": 21
                  },
                  {
                    "message": "Missing Mandatory Tag: @PRE (required for STANDARD tier)",
                    "severity": "WARNING",
                    "line_number": 21
                  },
                  {
                    "message": "Missing Mandatory Tag: @PRE (required for STANDARD tier)",
                    "severity": "WARNING",
                    "line_number": 21
                  }
                ],
                "score": 0.6333333333333333
              }
            },
            {
              "name": "get_postgres_comments",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 28,
              "end_line": 91,
              "tags": {
                "PURPOSE": "\u0418\u0437\u0432\u043b\u0435\u043a\u0430\u0435\u0442 \u043a\u043e\u043c\u043c\u0435\u043d\u0442\u0430\u0440\u0438\u0438 \u043a \u043a\u043e\u043b\u043e\u043d\u043a\u0430\u043c \u0438\u0437 \u0441\u0438\u0441\u0442\u0435\u043c\u043d\u043e\u0433\u043e \u043a\u0430\u0442\u0430\u043b\u043e\u0433\u0430 PostgreSQL.",
                "PRE": "table_name \u0438 table_schema \u0434\u043e\u043b\u0436\u043d\u044b \u0431\u044b\u0442\u044c \u0441\u0442\u0440\u043e\u043a\u0430\u043c\u0438.",
                "POST": "\u0412\u043e\u0437\u0432\u0440\u0430\u0449\u0430\u0435\u0442\u0441\u044f \u0441\u043b\u043e\u0432\u0430\u0440\u044c, \u0433\u0434\u0435 \u043a\u043b\u044e\u0447\u0438 - \u0438\u043c\u0435\u043d\u0430 \u043a\u043e\u043b\u043e\u043d\u043e\u043a, \u0437\u043d\u0430\u0447\u0435\u043d\u0438\u044f - \u043a\u043e\u043c\u043c\u0435\u043d\u0442\u0430\u0440\u0438\u0438 \u0438\u0437 \u0411\u0414.",
                "THROW": "Exception - \u041f\u0440\u0438 \u043e\u0448\u0438\u0431\u043a\u0430\u0445 \u043f\u043e\u0434\u043a\u043b\u044e\u0447\u0435\u043d\u0438\u044f \u0438\u043b\u0438 \u0432\u044b\u043f\u043e\u043b\u043d\u0435\u043d\u0438\u044f \u0437\u0430\u043f\u0440\u043e\u0441\u0430 \u043a \u0411\u0414.",
                "PARAM": "table_schema (str) - \u0421\u0445\u0435\u043c\u0430 \u0442\u0430\u0431\u043b\u0438\u0446\u044b.",
                "RETURN": "Dict[str, str] - \u0421\u043b\u043e\u0432\u0430\u0440\u044c \u0441 \u043a\u043e\u043c\u043c\u0435\u043d\u0442\u0430\u0440\u0438\u044f\u043c\u0438 \u043a \u043a\u043e\u043b\u043e\u043d\u043a\u0430\u043c."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            },
            {
              "name": "load_excel_mappings",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 93,
              "end_line": 111,
              "tags": {
                "PURPOSE": "\u0417\u0430\u0433\u0440\u0443\u0436\u0430\u0435\u0442 \u043c\u0435\u043f\u043f\u0438\u043d\u0433\u0438 'column_name' -> 'column_comment' \u0438\u0437 XLSX \u0444\u0430\u0439\u043b\u0430.",
                "PRE": "file_path \u0434\u043e\u043b\u0436\u0435\u043d \u0443\u043a\u0430\u0437\u044b\u0432\u0430\u0442\u044c \u043d\u0430 \u0441\u0443\u0449\u0435\u0441\u0442\u0432\u0443\u044e\u0449\u0438\u0439 XLSX \u0444\u0430\u0439\u043b.",
                "POST": "\u0412\u043e\u0437\u0432\u0440\u0430\u0449\u0430\u0435\u0442\u0441\u044f \u0441\u043b\u043e\u0432\u0430\u0440\u044c \u0441 \u043c\u0435\u043f\u043f\u0438\u043d\u0433\u0430\u043c\u0438 \u0438\u0437 \u0444\u0430\u0439\u043b\u0430.",
                "THROW": "Exception - \u041f\u0440\u0438 \u043e\u0448\u0438\u0431\u043a\u0430\u0445 \u0447\u0442\u0435\u043d\u0438\u044f \u0444\u0430\u0439\u043b\u0430 \u0438\u043b\u0438 \u043f\u0430\u0440\u0441\u0438\u043d\u0433\u0430.",
                "PARAM": "file_path (str) - \u041f\u0443\u0442\u044c \u043a XLSX \u0444\u0430\u0439\u043b\u0443.",
                "RETURN": "Dict[str, str] - \u0421\u043b\u043e\u0432\u0430\u0440\u044c \u0441 \u043c\u0435\u043f\u043f\u0438\u043d\u0433\u0430\u043c\u0438."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            },
            {
              "name": "run_mapping",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 113,
              "end_line": 234,
              "tags": {
                "PURPOSE": "\u041e\u0441\u043d\u043e\u0432\u043d\u0430\u044f \u0444\u0443\u043d\u043a\u0446\u0438\u044f \u0434\u043b\u044f \u0432\u044b\u043f\u043e\u043b\u043d\u0435\u043d\u0438\u044f \u043c\u0435\u043f\u043f\u0438\u043d\u0433\u0430 \u0438 \u043e\u0431\u043d\u043e\u0432\u043b\u0435\u043d\u0438\u044f verbose_map \u0434\u0430\u0442\u0430\u0441\u0435\u0442\u0430 \u0432 Superset.",
                "PRE": "dataset_id \u0434\u043e\u043b\u0436\u0435\u043d \u0431\u044b\u0442\u044c \u0441\u0443\u0449\u0435\u0441\u0442\u0432\u0443\u044e\u0449\u0438\u043c ID \u0432 Superset.",
                "POST": "\u0415\u0441\u043b\u0438 \u043d\u0430\u0439\u0434\u0435\u043d\u044b \u0438\u0437\u043c\u0435\u043d\u0435\u043d\u0438\u044f, \u0434\u0430\u0442\u0430\u0441\u0435\u0442 \u0432 Superset \u043e\u0431\u043d\u043e\u0432\u043b\u0435\u043d \u0447\u0435\u0440\u0435\u0437 API.",
                "PARAM": "table_schema (Optional[str]) - \u0421\u0445\u0435\u043c\u0430 \u0442\u0430\u0431\u043b\u0438\u0446\u044b \u0432 PostgreSQL."
              },
              "relations": [
                {
                  "type": "CALLS",
                  "target": "self.get_postgres_comments"
                },
                {
                  "type": "CALLS",
                  "target": "self.load_excel_mappings"
                },
                {
                  "type": "CALLS",
                  "target": "superset_client.get_dataset"
                },
                {
                  "type": "CALLS",
                  "target": "superset_client.update_dataset"
                }
              ],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            }
          ],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 18
              },
              {
                "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 18
              }
            ],
            "score": 0.7000000000000001
          }
        }
      ],
      "compliance": {
        "valid": true,
        "issues": [
          {
            "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
            "severity": "WARNING",
            "line_number": 1
          }
        ],
        "score": 0.85
      }
    },
    {
      "name": "TaskPersistenceModule",
      "type": "Module",
      "tier": "STANDARD",
      "start_line": 1,
      "end_line": 158,
      "tags": {
        "SEMANTICS": "persistence, sqlite, sqlalchemy, task, storage",
        "PURPOSE": "Handles the persistence of tasks using SQLAlchemy and the tasks.db database.",
        "LAYER": "Core",
        "RELATION": "Used by TaskManager to save and load tasks.",
        "INVARIANT": "Database schema must match the TaskRecord model structure."
      },
      "relations": [],
      "children": [
        {
          "name": "TaskPersistenceService",
          "type": "Class",
          "tier": "STANDARD",
          "start_line": 20,
          "end_line": 157,
          "tags": {
            "SEMANTICS": "persistence, service, database, sqlalchemy",
            "PURPOSE": "Provides methods to save and load tasks from the tasks.db database using SQLAlchemy."
          },
          "relations": [],
          "children": [
            {
              "name": "__init__",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 24,
              "end_line": 32,
              "tags": {
                "PURPOSE": "Initializes the persistence service.",
                "PRE": "None.",
                "POST": "Service is ready."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            },
            {
              "name": "persist_task",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 34,
              "end_line": 77,
              "tags": {
                "PURPOSE": "Persists or updates a single task in the database.",
                "PRE": "isinstance(task, Task)",
                "POST": "Task record created or updated in database.",
                "PARAM": "task (Task) - The task object to persist."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            },
            {
              "name": "persist_tasks",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 79,
              "end_line": 88,
              "tags": {
                "PURPOSE": "Persists multiple tasks.",
                "PRE": "isinstance(tasks, list)",
                "POST": "All tasks in list are persisted.",
                "PARAM": "tasks (List[Task]) - The list of tasks to persist."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            },
            {
              "name": "load_tasks",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 90,
              "end_line": 135,
              "tags": {
                "PURPOSE": "Loads tasks from the database.",
                "PRE": "limit is an integer.",
                "POST": "Returns list of Task objects.",
                "PARAM": "status (Optional[TaskStatus]) - Filter by status.",
                "RETURN": "List[Task] - The loaded tasks."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            },
            {
              "name": "delete_tasks",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 137,
              "end_line": 155,
              "tags": {
                "PURPOSE": "Deletes specific tasks from the database.",
                "PRE": "task_ids is a list of strings.",
                "POST": "Specified task records deleted from database.",
                "PARAM": "task_ids (List[str]) - List of task IDs to delete."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            }
          ],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 20
              },
              {
                "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 20
              }
            ],
            "score": 0.7000000000000001
          }
        }
      ],
      "compliance": {
        "valid": true,
        "issues": [
          {
            "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
            "severity": "WARNING",
            "line_number": 1
          }
        ],
        "score": 0.85
      }
    },
    {
      "name": "TaskManagerModule",
      "type": "Module",
      "tier": "STANDARD",
      "start_line": 1,
      "end_line": 398,
      "tags": {
        "SEMANTICS": "task, manager, lifecycle, execution, state",
        "PURPOSE": "Manages the lifecycle of tasks, including their creation, execution, and state tracking. It uses a thread pool to run plugins asynchronously.",
        "LAYER": "Core",
        "RELATION": "Depends on PluginLoader to get plugin instances. It is used by the API layer to create and query tasks.",
        "INVARIANT": "Task IDs are unique.",
        "CONSTRAINT": "Must use belief_scope for logging."
      },
      "relations": [],
      "children": [
        {
          "name": "TaskManager",
          "type": "Class",
          "tier": "STANDARD",
          "start_line": 20,
          "end_line": 397,
          "tags": {
            "SEMANTICS": "task, manager, lifecycle, execution, state",
            "PURPOSE": "Manages the lifecycle of tasks, including their creation, execution, and state tracking."
          },
          "relations": [],
          "children": [
            {
              "name": "__init__",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 28,
              "end_line": 49,
              "tags": {
                "PURPOSE": "Initialize the TaskManager with dependencies.",
                "PRE": "plugin_loader is initialized.",
                "POST": "TaskManager is ready to accept tasks.",
                "PARAM": "plugin_loader - The plugin loader instance."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            },
            {
              "name": "create_task",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 51,
              "end_line": 78,
              "tags": {
                "PURPOSE": "Creates and queues a new task for execution.",
                "PRE": "Plugin with plugin_id exists. Params are valid.",
                "POST": "Task is created, added to registry, and scheduled for execution.",
                "PARAM": "user_id (Optional[str]) - ID of the user requesting the task.",
                "RETURN": "Task - The created task instance.",
                "THROWS": "ValueError if plugin not found or params invalid."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            },
            {
              "name": "_run_task",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 80,
              "end_line": 120,
              "tags": {
                "PURPOSE": "Internal method to execute a task.",
                "PRE": "Task exists in registry.",
                "POST": "Task is executed, status updated to SUCCESS or FAILED.",
                "PARAM": "task_id (str) - The ID of the task to run."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            },
            {
              "name": "resolve_task",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 122,
              "end_line": 144,
              "tags": {
                "PURPOSE": "Resumes a task that is awaiting mapping.",
                "PRE": "Task exists and is in AWAITING_MAPPING state.",
                "POST": "Task status updated to RUNNING, params updated, execution resumed.",
                "PARAM": "resolution_params (Dict[str, Any]) - Params to resolve the wait.",
                "THROWS": "ValueError if task not found or not awaiting mapping."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            },
            {
              "name": "wait_for_resolution",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 146,
              "end_line": 165,
              "tags": {
                "PURPOSE": "Pauses execution and waits for a resolution signal.",
                "PRE": "Task exists.",
                "POST": "Execution pauses until future is set.",
                "PARAM": "task_id (str) - The ID of the task."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            },
            {
              "name": "wait_for_input",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 167,
              "end_line": 185,
              "tags": {
                "PURPOSE": "Pauses execution and waits for user input.",
                "PRE": "Task exists.",
                "POST": "Execution pauses until future is set via resume_task_with_password.",
                "PARAM": "task_id (str) - The ID of the task."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            },
            {
              "name": "get_task",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 187,
              "end_line": 196,
              "tags": {
                "PURPOSE": "Retrieves a task by its ID.",
                "PRE": "task_id is a string.",
                "POST": "Returns Task object or None.",
                "PARAM": "task_id (str) - ID of the task.",
                "RETURN": "Optional[Task] - The task or None."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            },
            {
              "name": "get_all_tasks",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 198,
              "end_line": 206,
              "tags": {
                "PURPOSE": "Retrieves all registered tasks.",
                "PRE": "None.",
                "POST": "Returns list of all Task objects.",
                "RETURN": "List[Task] - All tasks."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            },
            {
              "name": "get_tasks",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 208,
              "end_line": 224,
              "tags": {
                "PURPOSE": "Retrieves tasks with pagination and optional status filter.",
                "PRE": "limit and offset are non-negative integers.",
                "POST": "Returns a list of tasks sorted by start_time descending.",
                "PARAM": "status (Optional[TaskStatus]) - Filter by task status.",
                "RETURN": "List[Task] - List of tasks matching criteria."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            },
            {
              "name": "get_task_logs",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 226,
              "end_line": 236,
              "tags": {
                "PURPOSE": "Retrieves logs for a specific task.",
                "PRE": "task_id is a string.",
                "POST": "Returns list of LogEntry objects.",
                "PARAM": "task_id (str) - ID of the task.",
                "RETURN": "List[LogEntry] - List of log entries."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            },
            {
              "name": "_add_log",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 238,
              "end_line": 260,
              "tags": {
                "PURPOSE": "Adds a log entry to a task and notifies subscribers.",
                "PRE": "Task exists.",
                "POST": "Log added to task and pushed to queues.",
                "PARAM": "context (Optional[Dict]) - Log context."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            },
            {
              "name": "subscribe_logs",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 262,
              "end_line": 275,
              "tags": {
                "PURPOSE": "Subscribes to real-time logs for a task.",
                "PRE": "task_id is a string.",
                "POST": "Returns an asyncio.Queue for log entries.",
                "PARAM": "task_id (str) - ID of the task.",
                "RETURN": "asyncio.Queue - Queue for log entries."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            },
            {
              "name": "unsubscribe_logs",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 277,
              "end_line": 290,
              "tags": {
                "PURPOSE": "Unsubscribes from real-time logs for a task.",
                "PRE": "task_id is a string, queue is asyncio.Queue.",
                "POST": "Queue removed from subscribers.",
                "PARAM": "queue (asyncio.Queue) - Queue to remove."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            },
            {
              "name": "load_persisted_tasks",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 292,
              "end_line": 302,
              "tags": {
                "PURPOSE": "Load persisted tasks using persistence service.",
                "PRE": "None.",
                "POST": "Persisted tasks loaded into self.tasks."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            },
            {
              "name": "await_input",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 304,
              "end_line": 324,
              "tags": {
                "PURPOSE": "Transition a task to AWAITING_INPUT state with input request.",
                "PRE": "Task exists and is in RUNNING state.",
                "POST": "Task status changed to AWAITING_INPUT, input_request set, persisted.",
                "PARAM": "input_request (Dict) - Details about required input.",
                "THROWS": "ValueError if task not found or not RUNNING."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            },
            {
              "name": "resume_task_with_password",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 326,
              "end_line": 353,
              "tags": {
                "PURPOSE": "Resume a task that is awaiting input with provided passwords.",
                "PRE": "Task exists and is in AWAITING_INPUT state.",
                "POST": "Task status changed to RUNNING, passwords injected, task resumed.",
                "PARAM": "passwords (Dict[str, str]) - Mapping of database name to password.",
                "THROWS": "ValueError if task not found, not awaiting input, or passwords invalid."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            },
            {
              "name": "clear_tasks",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 355,
              "end_line": 395,
              "tags": {
                "PURPOSE": "Clears tasks based on status filter.",
                "PRE": "status is Optional[TaskStatus].",
                "POST": "Tasks matching filter (or all non-active) cleared from registry and database.",
                "PARAM": "status (Optional[TaskStatus]) - Filter by task status.",
                "RETURN": "int - Number of tasks cleared."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            }
          ],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 20
              },
              {
                "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 20
              }
            ],
            "score": 0.7000000000000001
          }
        }
      ],
      "compliance": {
        "valid": true,
        "issues": [
          {
            "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
            "severity": "WARNING",
            "line_number": 1
          }
        ],
        "score": 0.85
      }
    },
    {
      "name": "TaskManagerModels",
      "type": "Module",
      "tier": "STANDARD",
      "start_line": 1,
      "end_line": 68,
      "tags": {
        "SEMANTICS": "task, models, pydantic, enum, state",
        "PURPOSE": "Defines the data models and enumerations used by the Task Manager.",
        "LAYER": "Core",
        "RELATION": "Used by TaskManager and API routes.",
        "INVARIANT": "Task IDs are immutable once created.",
        "CONSTRAINT": "Must use Pydantic for data validation."
      },
      "relations": [],
      "children": [
        {
          "name": "TaskStatus",
          "type": "Enum",
          "tier": "STANDARD",
          "start_line": 18,
          "end_line": 28,
          "tags": {
            "SEMANTICS": "task, status, state, enum",
            "PURPOSE": "Defines the possible states a task can be in during its lifecycle."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "LogEntry",
          "type": "Class",
          "tier": "STANDARD",
          "start_line": 30,
          "end_line": 38,
          "tags": {
            "SEMANTICS": "log, entry, record, pydantic",
            "PURPOSE": "A Pydantic model representing a single, structured log entry associated with a task."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 30
              },
              {
                "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 30
              }
            ],
            "score": 0.7000000000000001
          }
        },
        {
          "name": "Task",
          "type": "Class",
          "tier": "STANDARD",
          "start_line": 40,
          "end_line": 66,
          "tags": {
            "SEMANTICS": "task, job, execution, state, pydantic",
            "PURPOSE": "A Pydantic model representing a single execution instance of a plugin, including its status, parameters, and logs."
          },
          "relations": [],
          "children": [
            {
              "name": "__init__",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 56,
              "end_line": 65,
              "tags": {
                "PURPOSE": "Initializes the Task model and validates input_request for AWAITING_INPUT status.",
                "PRE": "If status is AWAITING_INPUT, input_request must be provided.",
                "POST": "Task instance is created or ValueError is raised.",
                "PARAM": "**data - Keyword arguments for model initialization."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            }
          ],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 40
              },
              {
                "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 40
              }
            ],
            "score": 0.7000000000000001
          }
        }
      ],
      "compliance": {
        "valid": true,
        "issues": [
          {
            "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
            "severity": "WARNING",
            "line_number": 1
          }
        ],
        "score": 0.85
      }
    },
    {
      "name": "TaskCleanupModule",
      "type": "Module",
      "tier": "STANDARD",
      "start_line": 1,
      "end_line": 47,
      "tags": {
        "SEMANTICS": "task, cleanup, retention",
        "PURPOSE": "Implements task cleanup and retention policies.",
        "LAYER": "Core",
        "RELATION": "Uses TaskPersistenceService to delete old tasks."
      },
      "relations": [],
      "children": [
        {
          "name": "TaskCleanupService",
          "type": "Class",
          "tier": "STANDARD",
          "start_line": 12,
          "end_line": 46,
          "tags": {
            "PURPOSE": "Provides methods to clean up old task records."
          },
          "relations": [],
          "children": [
            {
              "name": "__init__",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 15,
              "end_line": 22,
              "tags": {
                "PURPOSE": "Initializes the cleanup service with dependencies.",
                "PRE": "persistence_service and config_manager are valid.",
                "POST": "Cleanup service is ready."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            },
            {
              "name": "run_cleanup",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 24,
              "end_line": 44,
              "tags": {
                "PURPOSE": "Deletes tasks older than the configured retention period.",
                "PRE": "Config manager has valid settings.",
                "POST": "Old tasks are deleted from persistence."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            }
          ],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 12
              },
              {
                "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 12
              }
            ],
            "score": 0.7000000000000001
          }
        }
      ],
      "compliance": {
        "valid": true,
        "issues": [
          {
            "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
            "severity": "WARNING",
            "line_number": 1
          }
        ],
        "score": 0.85
      }
    },
    {
      "name": "TaskManagerPackage",
      "type": "Module",
      "tier": "STANDARD",
      "start_line": 1,
      "end_line": 12,
      "tags": {
        "SEMANTICS": "task, manager, package, exports",
        "PURPOSE": "Exports the public API of the task manager package.",
        "LAYER": "Core",
        "RELATION": "Aggregates models and manager."
      },
      "relations": [],
      "children": [],
      "compliance": {
        "valid": true,
        "issues": [
          {
            "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
            "severity": "WARNING",
            "line_number": 1
          }
        ],
        "score": 0.85
      }
    },
    {
      "name": "backend.src.api.auth",
      "type": "Module",
      "tier": "STANDARD",
      "start_line": 1,
      "end_line": 118,
      "tags": {
        "SEMANTICS": "api, auth, routes, login, logout",
        "PURPOSE": "Authentication API endpoints.",
        "LAYER": "API",
        "INVARIANT": "All auth endpoints must return consistent error codes."
      },
      "relations": [
        {
          "type": "USES",
          "target": "backend.src.services.auth_service.AuthService"
        },
        {
          "type": "USES",
          "target": "backend.src.core.database.get_auth_db"
        }
      ],
      "children": [
        {
          "name": "router",
          "type": "Variable",
          "tier": "STANDARD",
          "start_line": 25,
          "end_line": 28,
          "tags": {
            "PURPOSE": "APIRouter instance for authentication routes."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "login_for_access_token",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 30,
          "end_line": 55,
          "tags": {
            "PURPOSE": "Authenticates a user and returns a JWT access token.",
            "PRE": "form_data contains username and password.",
            "POST": "Returns a Token object on success.",
            "THROW": "HTTPException 401 if authentication fails.",
            "PARAM": "db (Session) - Auth database session.",
            "RETURN": "Token - The generated JWT token."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "read_users_me",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 57,
          "end_line": 67,
          "tags": {
            "PURPOSE": "Retrieves the profile of the currently authenticated user.",
            "PRE": "Valid JWT token provided.",
            "POST": "Returns the current user's data.",
            "PARAM": "current_user (UserSchema) - The user extracted from the token.",
            "RETURN": "UserSchema - The current user profile."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "logout",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 69,
          "end_line": 80,
          "tags": {
            "PURPOSE": "Logs out the current user (placeholder for session revocation).",
            "PRE": "Valid JWT token provided.",
            "POST": "Returns success message."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "login_adfs",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 82,
          "end_line": 95,
          "tags": {
            "PURPOSE": "Initiates the ADFS OIDC login flow.",
            "POST": "Redirects the user to ADFS."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Mandatory Tag: @PRE (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 82
              },
              {
                "message": "Missing Mandatory Tag: @PRE (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 82
              }
            ],
            "score": 0.7333333333333334
          }
        },
        {
          "name": "auth_callback_adfs",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 97,
          "end_line": 116,
          "tags": {
            "PURPOSE": "Handles the callback from ADFS after successful authentication.",
            "POST": "Provisions user JIT and returns session token."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Mandatory Tag: @PRE (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 97
              },
              {
                "message": "Missing Mandatory Tag: @PRE (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 97
              }
            ],
            "score": 0.7333333333333334
          }
        }
      ],
      "compliance": {
        "valid": true,
        "issues": [
          {
            "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
            "severity": "WARNING",
            "line_number": 1
          }
        ],
        "score": 0.85
      }
    },
    {
      "name": "router",
      "type": "Global",
      "tier": "STANDARD",
      "start_line": 17,
      "end_line": 20,
      "tags": {
        "PURPOSE": "APIRouter instance for LLM routes."
      },
      "relations": [],
      "children": [],
      "compliance": {
        "valid": true,
        "issues": [],
        "score": 1.0
      }
    },
    {
      "name": "get_providers",
      "type": "Function",
      "tier": "STANDARD",
      "start_line": 22,
      "end_line": 48,
      "tags": {
        "PURPOSE": "Retrieve all LLM provider configurations.",
        "PRE": "User is authenticated.",
        "POST": "Returns list of LLMProviderConfig."
      },
      "relations": [],
      "children": [],
      "compliance": {
        "valid": true,
        "issues": [
          {
            "message": "Missing Belief State Logging: Function should use belief_scope (required for STANDARD tier)",
            "severity": "WARNING",
            "line_number": 22
          }
        ],
        "score": 0.9
      }
    },
    {
      "name": "create_provider",
      "type": "Function",
      "tier": "STANDARD",
      "start_line": 50,
      "end_line": 74,
      "tags": {
        "PURPOSE": "Create a new LLM provider configuration.",
        "PRE": "User is authenticated and has admin permissions.",
        "POST": "Returns the created LLMProviderConfig."
      },
      "relations": [],
      "children": [],
      "compliance": {
        "valid": true,
        "issues": [
          {
            "message": "Missing Belief State Logging: Function should use belief_scope (required for STANDARD tier)",
            "severity": "WARNING",
            "line_number": 50
          }
        ],
        "score": 0.9
      }
    },
    {
      "name": "update_provider",
      "type": "Function",
      "tier": "STANDARD",
      "start_line": 76,
      "end_line": 104,
      "tags": {
        "PURPOSE": "Update an existing LLM provider configuration.",
        "PRE": "User is authenticated and has admin permissions.",
        "POST": "Returns the updated LLMProviderConfig."
      },
      "relations": [],
      "children": [],
      "compliance": {
        "valid": true,
        "issues": [
          {
            "message": "Missing Belief State Logging: Function should use belief_scope (required for STANDARD tier)",
            "severity": "WARNING",
            "line_number": 76
          }
        ],
        "score": 0.9
      }
    },
    {
      "name": "delete_provider",
      "type": "Function",
      "tier": "STANDARD",
      "start_line": 106,
      "end_line": 123,
      "tags": {
        "PURPOSE": "Delete an LLM provider configuration.",
        "PRE": "User is authenticated and has admin permissions.",
        "POST": "Returns success status."
      },
      "relations": [],
      "children": [],
      "compliance": {
        "valid": true,
        "issues": [
          {
            "message": "Missing Belief State Logging: Function should use belief_scope (required for STANDARD tier)",
            "severity": "WARNING",
            "line_number": 106
          }
        ],
        "score": 0.9
      }
    },
    {
      "name": "test_connection",
      "type": "Function",
      "tier": "STANDARD",
      "start_line": 125,
      "end_line": 159,
      "tags": {
        "PURPOSE": "Test connection to an LLM provider.",
        "PRE": "User is authenticated.",
        "POST": "Returns success status and message."
      },
      "relations": [],
      "children": [],
      "compliance": {
        "valid": true,
        "issues": [
          {
            "message": "Missing Belief State Logging: Function should use belief_scope (required for STANDARD tier)",
            "severity": "WARNING",
            "line_number": 125
          }
        ],
        "score": 0.9
      }
    },
    {
      "name": "test_provider_config",
      "type": "Function",
      "tier": "STANDARD",
      "start_line": 161,
      "end_line": 189,
      "tags": {
        "PURPOSE": "Test connection with a provided configuration (not yet saved).",
        "PRE": "User is authenticated.",
        "POST": "Returns success status and message."
      },
      "relations": [],
      "children": [],
      "compliance": {
        "valid": true,
        "issues": [
          {
            "message": "Missing Belief State Logging: Function should use belief_scope (required for STANDARD tier)",
            "severity": "WARNING",
            "line_number": 161
          }
        ],
        "score": 0.9
      }
    },
    {
      "name": "backend.src.api.routes.git",
      "type": "Module",
      "tier": "STANDARD",
      "start_line": 1,
      "end_line": 455,
      "tags": {
        "SEMANTICS": "git, routes, api, fastapi, repository, deployment",
        "PURPOSE": "Provides FastAPI endpoints for Git integration operations.",
        "LAYER": "API",
        "INVARIANT": "All Git operations must be routed through GitService."
      },
      "relations": [
        {
          "type": "USES",
          "target": "src.services.git_service.GitService"
        },
        {
          "type": "USES",
          "target": "src.api.routes.git_schemas"
        },
        {
          "type": "USES",
          "target": "src.models.git"
        }
      ],
      "children": [
        {
          "name": "get_git_configs",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 31,
          "end_line": 43,
          "tags": {
            "PURPOSE": "List all configured Git servers.",
            "PRE": "Database session `db` is available.",
            "POST": "Returns a list of all GitServerConfig objects from the database.",
            "RETURN": "List[GitServerConfigSchema]"
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "create_git_config",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 45,
          "end_line": 63,
          "tags": {
            "PURPOSE": "Register a new Git server configuration.",
            "PRE": "`config` contains valid GitServerConfigCreate data.",
            "POST": "A new GitServerConfig record is created in the database.",
            "PARAM": "config (GitServerConfigCreate)",
            "RETURN": "GitServerConfigSchema"
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "delete_git_config",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 65,
          "end_line": 84,
          "tags": {
            "PURPOSE": "Remove a Git server configuration.",
            "PRE": "`config_id` corresponds to an existing configuration.",
            "POST": "The configuration record is removed from the database.",
            "PARAM": "config_id (str)"
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "test_git_config",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 86,
          "end_line": 102,
          "tags": {
            "PURPOSE": "Validate connection to a Git server using provided credentials.",
            "PRE": "`config` contains provider, url, and pat.",
            "POST": "Returns success if the connection is validated via GitService.",
            "PARAM": "config (GitServerConfigCreate)"
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "init_repository",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 104,
          "end_line": 151,
          "tags": {
            "PURPOSE": "Link a dashboard to a Git repository and perform initial clone/init.",
            "PRE": "`dashboard_id` exists and `init_data` contains valid config_id and remote_url.",
            "POST": "Repository is initialized on disk and a GitRepository record is saved in DB.",
            "PARAM": "init_data (RepoInitRequest)"
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "get_branches",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 153,
          "end_line": 169,
          "tags": {
            "PURPOSE": "List all branches for a dashboard's repository.",
            "PRE": "Repository for `dashboard_id` is initialized.",
            "POST": "Returns a list of branches from the local repository.",
            "PARAM": "dashboard_id (int)",
            "RETURN": "List[BranchSchema]"
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "create_branch",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 171,
          "end_line": 189,
          "tags": {
            "PURPOSE": "Create a new branch in the dashboard's repository.",
            "PRE": "`dashboard_id` repository exists and `branch_data` has name and from_branch.",
            "POST": "A new branch is created in the local repository.",
            "PARAM": "branch_data (BranchCreate)"
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "checkout_branch",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 191,
          "end_line": 209,
          "tags": {
            "PURPOSE": "Switch the dashboard's repository to a specific branch.",
            "PRE": "`dashboard_id` repository exists and branch `checkout_data.name` exists.",
            "POST": "The local repository HEAD is moved to the specified branch.",
            "PARAM": "checkout_data (BranchCheckout)"
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "commit_changes",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 211,
          "end_line": 229,
          "tags": {
            "PURPOSE": "Stage and commit changes in the dashboard's repository.",
            "PRE": "`dashboard_id` repository exists and `commit_data` has message and files.",
            "POST": "Specified files are staged and a new commit is created.",
            "PARAM": "commit_data (CommitCreate)"
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "push_changes",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 231,
          "end_line": 247,
          "tags": {
            "PURPOSE": "Push local commits to the remote repository.",
            "PRE": "`dashboard_id` repository exists and has a remote configured.",
            "POST": "Local commits are pushed to the remote repository.",
            "PARAM": "dashboard_id (int)"
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "pull_changes",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 249,
          "end_line": 265,
          "tags": {
            "PURPOSE": "Pull changes from the remote repository.",
            "PRE": "`dashboard_id` repository exists and has a remote configured.",
            "POST": "Remote changes are fetched and merged into the local branch.",
            "PARAM": "dashboard_id (int)"
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "sync_dashboard",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 267,
          "end_line": 290,
          "tags": {
            "PURPOSE": "Sync dashboard state from Superset to Git using the GitPlugin.",
            "PRE": "`dashboard_id` is valid; GitPlugin is available.",
            "POST": "Dashboard YAMLs are exported from Superset and committed to Git.",
            "PARAM": "source_env_id (Optional[str])"
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "get_environments",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 292,
          "end_line": 312,
          "tags": {
            "PURPOSE": "List all deployment environments.",
            "PRE": "Config manager is accessible.",
            "POST": "Returns a list of DeploymentEnvironmentSchema objects.",
            "RETURN": "List[DeploymentEnvironmentSchema]"
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "deploy_dashboard",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 314,
          "end_line": 337,
          "tags": {
            "PURPOSE": "Deploy dashboard from Git to a target environment.",
            "PRE": "`dashboard_id` and `deploy_data.environment_id` are valid.",
            "POST": "Dashboard YAMLs are read from Git and imported into the target Superset.",
            "PARAM": "deploy_data (DeployRequest)"
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "get_history",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 339,
          "end_line": 357,
          "tags": {
            "PURPOSE": "View commit history for a dashboard's repository.",
            "PRE": "`dashboard_id` repository exists.",
            "POST": "Returns a list of recent commits from the repository.",
            "PARAM": "limit (int)",
            "RETURN": "List[CommitSchema]"
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "get_repository_status",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 359,
          "end_line": 375,
          "tags": {
            "PURPOSE": "Get current Git status for a dashboard repository.",
            "PRE": "`dashboard_id` repository exists.",
            "POST": "Returns the status of the working directory (staged, unstaged, untracked).",
            "PARAM": "dashboard_id (int)",
            "RETURN": "dict"
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "get_repository_diff",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 377,
          "end_line": 398,
          "tags": {
            "PURPOSE": "Get Git diff for a dashboard repository.",
            "PRE": "`dashboard_id` repository exists.",
            "POST": "Returns the diff text for the specified file or all changes.",
            "PARAM": "staged (bool)",
            "RETURN": "str"
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "generate_commit_message",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 400,
          "end_line": 453,
          "tags": {
            "PURPOSE": "Generate a suggested commit message using LLM.",
            "PRE": "Repository for `dashboard_id` is initialized.",
            "POST": "Returns a suggested commit message string."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        }
      ],
      "compliance": {
        "valid": true,
        "issues": [
          {
            "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
            "severity": "WARNING",
            "line_number": 1
          }
        ],
        "score": 0.85
      }
    },
    {
      "name": "ConnectionsRouter",
      "type": "Module",
      "tier": "STANDARD",
      "start_line": 1,
      "end_line": 100,
      "tags": {
        "SEMANTICS": "api, router, connections, database",
        "PURPOSE": "Defines the FastAPI router for managing external database connections.",
        "LAYER": "UI (API)",
        "RELATION": "Depends on SQLAlchemy session.",
        "CONSTRAINT": "Must use belief_scope for logging."
      },
      "relations": [],
      "children": [
        {
          "name": "ConnectionSchema",
          "type": "Class",
          "tier": "STANDARD",
          "start_line": 21,
          "end_line": 35,
          "tags": {
            "PURPOSE": "Pydantic model for connection response."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 21
              },
              {
                "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 21
              }
            ],
            "score": 0.7000000000000001
          }
        },
        {
          "name": "ConnectionCreate",
          "type": "Class",
          "tier": "STANDARD",
          "start_line": 37,
          "end_line": 47,
          "tags": {
            "PURPOSE": "Pydantic model for creating a connection."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 37
              },
              {
                "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 37
              }
            ],
            "score": 0.7000000000000001
          }
        },
        {
          "name": "list_connections",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 49,
          "end_line": 60,
          "tags": {
            "PURPOSE": "Lists all saved connections.",
            "PRE": "Database session is active.",
            "POST": "Returns list of connection configs.",
            "PARAM": "db (Session) - Database session.",
            "RETURN": "List[ConnectionSchema] - List of connections."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "create_connection",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 62,
          "end_line": 78,
          "tags": {
            "PURPOSE": "Creates a new connection configuration.",
            "PRE": "Connection name is unique.",
            "POST": "Connection is saved to DB.",
            "PARAM": "db (Session) - Database session.",
            "RETURN": "ConnectionSchema - Created connection."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "delete_connection",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 80,
          "end_line": 98,
          "tags": {
            "PURPOSE": "Deletes a connection configuration.",
            "PRE": "Connection ID exists.",
            "POST": "Connection is removed from DB.",
            "PARAM": "db (Session) - Database session.",
            "RETURN": "None."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        }
      ],
      "compliance": {
        "valid": true,
        "issues": [
          {
            "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
            "severity": "WARNING",
            "line_number": 1
          }
        ],
        "score": 0.85
      }
    },
    {
      "name": "backend.src.api.routes.environments",
      "type": "Module",
      "tier": "STANDARD",
      "start_line": 1,
      "end_line": 130,
      "tags": {
        "SEMANTICS": "api, environments, superset, databases",
        "PURPOSE": "API endpoints for listing environments and their databases.",
        "LAYER": "API",
        "INVARIANT": "Environment IDs must exist in the configuration."
      },
      "relations": [
        {
          "type": "DEPENDS_ON",
          "target": "backend.src.dependencies"
        },
        {
          "type": "DEPENDS_ON",
          "target": "backend.src.core.superset_client"
        }
      ],
      "children": [
        {
          "name": "ScheduleSchema",
          "type": "DataClass",
          "tier": "STANDARD",
          "start_line": 23,
          "end_line": 27,
          "tags": {},
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "EnvironmentResponse",
          "type": "DataClass",
          "tier": "STANDARD",
          "start_line": 29,
          "end_line": 35,
          "tags": {},
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "DatabaseResponse",
          "type": "DataClass",
          "tier": "STANDARD",
          "start_line": 37,
          "end_line": 42,
          "tags": {},
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "get_environments",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 44,
          "end_line": 70,
          "tags": {
            "PURPOSE": "List all configured environments.",
            "PRE": "config_manager is injected via Depends.",
            "POST": "Returns a list of EnvironmentResponse objects.",
            "RETURN": "List[EnvironmentResponse]"
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "update_environment_schedule",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 72,
          "end_line": 102,
          "tags": {
            "PURPOSE": "Update backup schedule for an environment.",
            "PRE": "Environment id exists, schedule is valid ScheduleSchema.",
            "POST": "Backup schedule updated and scheduler reloaded.",
            "PARAM": "schedule (ScheduleSchema) - The new schedule."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "get_environment_databases",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 104,
          "end_line": 128,
          "tags": {
            "PURPOSE": "Fetch the list of databases from a specific environment.",
            "PRE": "Environment id exists.",
            "POST": "Returns a list of database summaries from the environment.",
            "PARAM": "id (str) - The environment ID.",
            "RETURN": "List[Dict] - List of databases."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        }
      ],
      "compliance": {
        "valid": true,
        "issues": [
          {
            "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
            "severity": "WARNING",
            "line_number": 1
          }
        ],
        "score": 0.85
      }
    },
    {
      "name": "backend.src.api.routes.migration",
      "type": "Module",
      "tier": "STANDARD",
      "start_line": 1,
      "end_line": 80,
      "tags": {
        "SEMANTICS": "api, migration, dashboards",
        "PURPOSE": "API endpoints for migration operations.",
        "LAYER": "API"
      },
      "relations": [
        {
          "type": "DEPENDS_ON",
          "target": "backend.src.dependencies"
        },
        {
          "type": "DEPENDS_ON",
          "target": "backend.src.models.dashboard"
        }
      ],
      "children": [
        {
          "name": "get_dashboards",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 17,
          "end_line": 38,
          "tags": {
            "PURPOSE": "Fetch all dashboards from the specified environment for the grid.",
            "PRE": "Environment ID must be valid.",
            "POST": "Returns a list of dashboard metadata.",
            "PARAM": "env_id (str) - The ID of the environment to fetch from.",
            "RETURN": "List[DashboardMetadata]"
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "execute_migration",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 40,
          "end_line": 78,
          "tags": {
            "PURPOSE": "Execute the migration of selected dashboards.",
            "PRE": "Selection must be valid and environments must exist.",
            "POST": "Starts the migration task and returns the task ID.",
            "PARAM": "selection (DashboardSelection) - The dashboards to migrate.",
            "RETURN": "Dict - {\"task_id\": str, \"message\": str}"
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        }
      ],
      "compliance": {
        "valid": true,
        "issues": [
          {
            "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
            "severity": "WARNING",
            "line_number": 1
          }
        ],
        "score": 0.85
      }
    },
    {
      "name": "PluginsRouter",
      "type": "Module",
      "tier": "STANDARD",
      "start_line": 1,
      "end_line": 31,
      "tags": {
        "SEMANTICS": "api, router, plugins, list",
        "PURPOSE": "Defines the FastAPI router for plugin-related endpoints, allowing clients to list available plugins.",
        "LAYER": "UI (API)",
        "RELATION": "Depends on the PluginLoader and PluginConfig. It is included by the main app."
      },
      "relations": [],
      "children": [
        {
          "name": "list_plugins",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 15,
          "end_line": 30,
          "tags": {
            "PURPOSE": "Retrieve a list of all available plugins.",
            "PRE": "plugin_loader is injected via Depends.",
            "POST": "Returns a list of PluginConfig objects.",
            "RETURN": "List[PluginConfig] - List of registered plugins."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        }
      ],
      "compliance": {
        "valid": true,
        "issues": [
          {
            "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
            "severity": "WARNING",
            "line_number": 1
          }
        ],
        "score": 0.85
      }
    },
    {
      "name": "backend.src.api.routes.mappings",
      "type": "Module",
      "tier": "STANDARD",
      "start_line": 1,
      "end_line": 126,
      "tags": {
        "SEMANTICS": "api, mappings, database, fuzzy-matching",
        "PURPOSE": "API endpoints for managing database mappings and getting suggestions.",
        "LAYER": "API",
        "INVARIANT": "Mappings are persisted in the SQLite database."
      },
      "relations": [
        {
          "type": "DEPENDS_ON",
          "target": "backend.src.dependencies"
        },
        {
          "type": "DEPENDS_ON",
          "target": "backend.src.core.database"
        },
        {
          "type": "DEPENDS_ON",
          "target": "backend.src.services.mapping_service"
        }
      ],
      "children": [
        {
          "name": "MappingCreate",
          "type": "DataClass",
          "tier": "STANDARD",
          "start_line": 25,
          "end_line": 33,
          "tags": {},
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "MappingResponse",
          "type": "DataClass",
          "tier": "STANDARD",
          "start_line": 35,
          "end_line": 47,
          "tags": {},
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "SuggestRequest",
          "type": "DataClass",
          "tier": "STANDARD",
          "start_line": 49,
          "end_line": 53,
          "tags": {},
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "get_mappings",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 55,
          "end_line": 73,
          "tags": {
            "PURPOSE": "List all saved database mappings.",
            "PRE": "db session is injected.",
            "POST": "Returns filtered list of DatabaseMapping records."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "create_mapping",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 75,
          "end_line": 105,
          "tags": {
            "PURPOSE": "Create or update a database mapping.",
            "PRE": "mapping is valid MappingCreate, db session is injected.",
            "POST": "DatabaseMapping created or updated in database."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "suggest_mappings_api",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 107,
          "end_line": 124,
          "tags": {
            "PURPOSE": "Get suggested mappings based on fuzzy matching.",
            "PRE": "request is valid SuggestRequest, config_manager is injected.",
            "POST": "Returns mapping suggestions."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        }
      ],
      "compliance": {
        "valid": true,
        "issues": [
          {
            "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
            "severity": "WARNING",
            "line_number": 1
          }
        ],
        "score": 0.85
      }
    },
    {
      "name": "SettingsRouter",
      "type": "Module",
      "tier": "STANDARD",
      "start_line": 1,
      "end_line": 227,
      "tags": {
        "SEMANTICS": "settings, api, router, fastapi",
        "PURPOSE": "Provides API endpoints for managing application settings and Superset environments.",
        "LAYER": "UI (API)",
        "INVARIANT": "All settings changes must be persisted via ConfigManager.",
        "PUBLIC_API": "router"
      },
      "relations": [
        {
          "type": "DEPENDS_ON",
          "target": "ConfigManager"
        },
        {
          "type": "DEPENDS_ON",
          "target": "ConfigModels"
        }
      ],
      "children": [
        {
          "name": "get_settings",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 26,
          "end_line": 44,
          "tags": {
            "PURPOSE": "Retrieves all application settings.",
            "PRE": "Config manager is available.",
            "POST": "Returns masked AppConfig.",
            "RETURN": "AppConfig - The current configuration."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "update_global_settings",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 46,
          "end_line": 63,
          "tags": {
            "PURPOSE": "Updates global application settings.",
            "PRE": "New settings are provided.",
            "POST": "Global settings are updated.",
            "PARAM": "settings (GlobalSettings) - The new global settings.",
            "RETURN": "GlobalSettings - The updated settings."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "get_storage_settings",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 65,
          "end_line": 75,
          "tags": {
            "PURPOSE": "Retrieves storage-specific settings.",
            "RETURN": "StorageConfig - The storage configuration."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Mandatory Tag: @PRE (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 65
              },
              {
                "message": "Missing Mandatory Tag: @POST (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 65
              },
              {
                "message": "Missing Mandatory Tag: @PRE (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 65
              },
              {
                "message": "Missing Mandatory Tag: @POST (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 65
              }
            ],
            "score": 0.4666666666666666
          }
        },
        {
          "name": "update_storage_settings",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 77,
          "end_line": 97,
          "tags": {
            "PURPOSE": "Updates storage-specific settings.",
            "PARAM": "storage (StorageConfig) - The new storage settings.",
            "POST": "Storage settings are updated and saved.",
            "RETURN": "StorageConfig - The updated storage settings."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Mandatory Tag: @PRE (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 77
              },
              {
                "message": "Missing Mandatory Tag: @PRE (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 77
              }
            ],
            "score": 0.7333333333333334
          }
        },
        {
          "name": "get_environments",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 99,
          "end_line": 112,
          "tags": {
            "PURPOSE": "Lists all configured Superset environments.",
            "PRE": "Config manager is available.",
            "POST": "Returns list of environments.",
            "RETURN": "List[Environment] - List of environments."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "add_environment",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 114,
          "end_line": 139,
          "tags": {
            "PURPOSE": "Adds a new Superset environment.",
            "PRE": "Environment data is valid and reachable.",
            "POST": "Environment is added to config.",
            "PARAM": "env (Environment) - The environment to add.",
            "RETURN": "Environment - The added environment."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "update_environment",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 141,
          "end_line": 175,
          "tags": {
            "PURPOSE": "Updates an existing Superset environment.",
            "PRE": "ID and valid environment data are provided.",
            "POST": "Environment is updated in config.",
            "PARAM": "env (Environment) - The updated environment data.",
            "RETURN": "Environment - The updated environment."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "delete_environment",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 177,
          "end_line": 191,
          "tags": {
            "PURPOSE": "Deletes a Superset environment.",
            "PRE": "ID is provided.",
            "POST": "Environment is removed from config.",
            "PARAM": "id (str) - The ID of the environment to delete."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "test_environment_connection",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 193,
          "end_line": 224,
          "tags": {
            "PURPOSE": "Tests the connection to a Superset environment.",
            "PRE": "ID is provided.",
            "POST": "Returns success or error status.",
            "PARAM": "id (str) - The ID of the environment to test.",
            "RETURN": "dict - Success message or error."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        }
      ],
      "compliance": {
        "valid": true,
        "issues": [
          {
            "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
            "severity": "WARNING",
            "line_number": 1
          }
        ],
        "score": 0.85
      }
    },
    {
      "name": "backend.src.api.routes.admin",
      "type": "Module",
      "tier": "STANDARD",
      "start_line": 1,
      "end_line": 310,
      "tags": {
        "TIER": "STANDARD",
        "SEMANTICS": "api, admin, users, roles, permissions",
        "PURPOSE": "Admin API endpoints for user and role management.",
        "LAYER": "API",
        "INVARIANT": "All endpoints in this module require 'Admin' role or 'admin' scope."
      },
      "relations": [
        {
          "type": "USES",
          "target": "backend.src.core.auth.repository.AuthRepository"
        },
        {
          "type": "USES",
          "target": "backend.src.dependencies.has_permission"
        }
      ],
      "children": [
        {
          "name": "router",
          "type": "Variable",
          "tier": "STANDARD",
          "start_line": 29,
          "end_line": 32,
          "tags": {
            "PURPOSE": "APIRouter instance for admin routes."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "list_users",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 34,
          "end_line": 48,
          "tags": {
            "PURPOSE": "Lists all registered users.",
            "PRE": "Current user has 'Admin' role.",
            "POST": "Returns a list of UserSchema objects.",
            "PARAM": "db (Session) - Auth database session.",
            "RETURN": "List[UserSchema] - List of users."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "create_user",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 50,
          "end_line": 85,
          "tags": {
            "PURPOSE": "Creates a new local user.",
            "PRE": "Current user has 'Admin' role.",
            "POST": "New user is created in the database.",
            "PARAM": "db (Session) - Auth database session.",
            "RETURN": "UserSchema - The created user."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "update_user",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 87,
          "end_line": 119,
          "tags": {
            "PURPOSE": "Updates an existing user."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Mandatory Tag: @PRE (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 87
              },
              {
                "message": "Missing Mandatory Tag: @POST (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 87
              },
              {
                "message": "Missing Mandatory Tag: @PRE (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 87
              },
              {
                "message": "Missing Mandatory Tag: @POST (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 87
              }
            ],
            "score": 0.4666666666666666
          }
        },
        {
          "name": "delete_user",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 121,
          "end_line": 142,
          "tags": {
            "PURPOSE": "Deletes a user."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Mandatory Tag: @PRE (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 121
              },
              {
                "message": "Missing Mandatory Tag: @POST (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 121
              },
              {
                "message": "Missing Mandatory Tag: @PRE (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 121
              },
              {
                "message": "Missing Mandatory Tag: @POST (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 121
              }
            ],
            "score": 0.4666666666666666
          }
        },
        {
          "name": "list_roles",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 144,
          "end_line": 155,
          "tags": {
            "PURPOSE": "Lists all available roles.",
            "RETURN": "List[RoleSchema] - List of roles."
          },
          "relations": [
            {
              "type": "CALLS",
              "target": "backend.src.models.auth.Role"
            }
          ],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Mandatory Tag: @PRE (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 144
              },
              {
                "message": "Missing Mandatory Tag: @POST (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 144
              },
              {
                "message": "Missing Mandatory Tag: @PRE (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 144
              },
              {
                "message": "Missing Mandatory Tag: @POST (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 144
              }
            ],
            "score": 0.4666666666666666
          }
        },
        {
          "name": "create_role",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 157,
          "end_line": 192,
          "tags": {
            "PURPOSE": "Creates a new system role with associated permissions.",
            "PRE": "Role name must be unique.",
            "POST": "New Role record is created in auth.db.",
            "PARAM": "db (Session) - Auth database session.",
            "RETURN": "RoleSchema - The created role.",
            "SIDE_EFFECT": "Commits new role and associations to auth.db."
          },
          "relations": [
            {
              "type": "CALLS",
              "target": "backend.src.core.auth.repository.AuthRepository.get_permission_by_id"
            }
          ],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "update_role",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 194,
          "end_line": 236,
          "tags": {
            "PURPOSE": "Updates an existing role's metadata and permissions.",
            "PRE": "role_id must be a valid existing role UUID.",
            "POST": "Role record is updated in auth.db.",
            "PARAM": "db (Session) - Auth database session.",
            "RETURN": "RoleSchema - The updated role.",
            "SIDE_EFFECT": "Commits updates to auth.db."
          },
          "relations": [
            {
              "type": "CALLS",
              "target": "backend.src.core.auth.repository.AuthRepository.get_role_by_id"
            }
          ],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "delete_role",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 238,
          "end_line": 262,
          "tags": {
            "PURPOSE": "Removes a role from the system.",
            "PRE": "role_id must be a valid existing role UUID.",
            "POST": "Role record is removed from auth.db.",
            "PARAM": "db (Session) - Auth database session.",
            "RETURN": "None",
            "SIDE_EFFECT": "Deletes record from auth.db and commits."
          },
          "relations": [
            {
              "type": "CALLS",
              "target": "backend.src.core.auth.repository.AuthRepository.get_role_by_id"
            }
          ],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "list_permissions",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 264,
          "end_line": 278,
          "tags": {
            "PURPOSE": "Lists all available system permissions for assignment.",
            "POST": "Returns a list of all PermissionSchema objects.",
            "PARAM": "db (Session) - Auth database session.",
            "RETURN": "List[PermissionSchema] - List of permissions."
          },
          "relations": [
            {
              "type": "CALLS",
              "target": "backend.src.core.auth.repository.AuthRepository.list_permissions"
            }
          ],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Mandatory Tag: @PRE (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 264
              },
              {
                "message": "Missing Mandatory Tag: @PRE (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 264
              }
            ],
            "score": 0.7333333333333334
          }
        },
        {
          "name": "list_ad_mappings",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 280,
          "end_line": 289,
          "tags": {
            "PURPOSE": "Lists all AD Group to Role mappings."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Mandatory Tag: @PRE (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 280
              },
              {
                "message": "Missing Mandatory Tag: @POST (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 280
              },
              {
                "message": "Missing Mandatory Tag: @PRE (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 280
              },
              {
                "message": "Missing Mandatory Tag: @POST (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 280
              }
            ],
            "score": 0.4666666666666666
          }
        },
        {
          "name": "create_ad_mapping",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 291,
          "end_line": 308,
          "tags": {
            "PURPOSE": "Creates a new AD Group mapping."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Mandatory Tag: @PRE (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 291
              },
              {
                "message": "Missing Mandatory Tag: @POST (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 291
              },
              {
                "message": "Missing Mandatory Tag: @PRE (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 291
              },
              {
                "message": "Missing Mandatory Tag: @POST (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 291
              }
            ],
            "score": 0.4666666666666666
          }
        }
      ],
      "compliance": {
        "valid": true,
        "issues": [],
        "score": 1.0
      }
    },
    {
      "name": "backend.src.api.routes.git_schemas",
      "type": "Module",
      "tier": "STANDARD",
      "start_line": 1,
      "end_line": 145,
      "tags": {
        "TIER": "STANDARD",
        "SEMANTICS": "git, schemas, pydantic, api, contracts",
        "PURPOSE": "Defines Pydantic models for the Git integration API layer.",
        "LAYER": "API",
        "INVARIANT": "All schemas must be compatible with the FastAPI router."
      },
      "relations": [
        {
          "type": "DEPENDS_ON",
          "target": "backend.src.models.git"
        }
      ],
      "children": [
        {
          "name": "GitServerConfigBase",
          "type": "Class",
          "tier": "TRIVIAL",
          "start_line": 17,
          "end_line": 26,
          "tags": {
            "TIER": "TRIVIAL",
            "PURPOSE": "Base schema for Git server configuration attributes."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "GitServerConfigCreate",
          "type": "Class",
          "tier": "STANDARD",
          "start_line": 28,
          "end_line": 33,
          "tags": {
            "PURPOSE": "Schema for creating a new Git server configuration."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 28
              },
              {
                "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 28
              }
            ],
            "score": 0.7000000000000001
          }
        },
        {
          "name": "GitServerConfigSchema",
          "type": "Class",
          "tier": "STANDARD",
          "start_line": 35,
          "end_line": 45,
          "tags": {
            "PURPOSE": "Schema for representing a Git server configuration with metadata."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 35
              },
              {
                "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 35
              }
            ],
            "score": 0.7000000000000001
          }
        },
        {
          "name": "GitRepositorySchema",
          "type": "Class",
          "tier": "STANDARD",
          "start_line": 47,
          "end_line": 61,
          "tags": {
            "PURPOSE": "Schema for tracking a local Git repository linked to a dashboard."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 47
              },
              {
                "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 47
              }
            ],
            "score": 0.7000000000000001
          }
        },
        {
          "name": "BranchSchema",
          "type": "Class",
          "tier": "STANDARD",
          "start_line": 63,
          "end_line": 71,
          "tags": {
            "PURPOSE": "Schema for representing a Git branch metadata."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 63
              },
              {
                "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 63
              }
            ],
            "score": 0.7000000000000001
          }
        },
        {
          "name": "CommitSchema",
          "type": "Class",
          "tier": "STANDARD",
          "start_line": 73,
          "end_line": 83,
          "tags": {
            "PURPOSE": "Schema for representing Git commit details."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 73
              },
              {
                "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 73
              }
            ],
            "score": 0.7000000000000001
          }
        },
        {
          "name": "BranchCreate",
          "type": "Class",
          "tier": "STANDARD",
          "start_line": 85,
          "end_line": 91,
          "tags": {
            "PURPOSE": "Schema for branch creation requests."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 85
              },
              {
                "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 85
              }
            ],
            "score": 0.7000000000000001
          }
        },
        {
          "name": "BranchCheckout",
          "type": "Class",
          "tier": "STANDARD",
          "start_line": 93,
          "end_line": 98,
          "tags": {
            "PURPOSE": "Schema for branch checkout requests."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 93
              },
              {
                "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 93
              }
            ],
            "score": 0.7000000000000001
          }
        },
        {
          "name": "CommitCreate",
          "type": "Class",
          "tier": "STANDARD",
          "start_line": 100,
          "end_line": 106,
          "tags": {
            "PURPOSE": "Schema for staging and committing changes."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 100
              },
              {
                "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 100
              }
            ],
            "score": 0.7000000000000001
          }
        },
        {
          "name": "ConflictResolution",
          "type": "Class",
          "tier": "STANDARD",
          "start_line": 108,
          "end_line": 115,
          "tags": {
            "PURPOSE": "Schema for resolving merge conflicts."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 108
              },
              {
                "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 108
              }
            ],
            "score": 0.7000000000000001
          }
        },
        {
          "name": "DeploymentEnvironmentSchema",
          "type": "Class",
          "tier": "STANDARD",
          "start_line": 117,
          "end_line": 128,
          "tags": {
            "PURPOSE": "Schema for representing a target deployment environment."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 117
              },
              {
                "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 117
              }
            ],
            "score": 0.7000000000000001
          }
        },
        {
          "name": "DeployRequest",
          "type": "Class",
          "tier": "STANDARD",
          "start_line": 130,
          "end_line": 135,
          "tags": {
            "PURPOSE": "Schema for dashboard deployment requests."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 130
              },
              {
                "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 130
              }
            ],
            "score": 0.7000000000000001
          }
        },
        {
          "name": "RepoInitRequest",
          "type": "Class",
          "tier": "STANDARD",
          "start_line": 137,
          "end_line": 143,
          "tags": {
            "PURPOSE": "Schema for repository initialization requests."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 137
              },
              {
                "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 137
              }
            ],
            "score": 0.7000000000000001
          }
        }
      ],
      "compliance": {
        "valid": true,
        "issues": [],
        "score": 1.0
      }
    },
    {
      "name": "storage_routes",
      "type": "Module",
      "tier": "STANDARD",
      "start_line": 1,
      "end_line": 145,
      "tags": {
        "SEMANTICS": "storage, files, upload, download, backup, repository",
        "PURPOSE": "API endpoints for file storage management (backups and repositories).",
        "LAYER": "API",
        "INVARIANT": "All paths must be validated against path traversal."
      },
      "relations": [
        {
          "type": "DEPENDS_ON",
          "target": "backend.src.models.storage"
        }
      ],
      "children": [
        {
          "name": "list_files",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 23,
          "end_line": 46,
          "tags": {
            "PURPOSE": "List all files and directories in the storage system.",
            "PRE": "None.",
            "POST": "Returns a list of StoredFile objects.",
            "PARAM": "path (Optional[str]) - Subpath within the category.",
            "RETURN": "List[StoredFile] - List of files/directories."
          },
          "relations": [
            {
              "type": "CALLS",
              "target": "StoragePlugin.list_files"
            }
          ],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "upload_file",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 48,
          "end_line": 79,
          "tags": {
            "PURPOSE": "Upload a file to the storage system.",
            "PRE": "file must be a valid UploadFile.",
            "POST": "Returns the StoredFile object of the uploaded file.",
            "PARAM": "file (UploadFile) - The file content.",
            "RETURN": "StoredFile - Metadata of the uploaded file.",
            "SIDE_EFFECT": "Writes file to the filesystem."
          },
          "relations": [
            {
              "type": "CALLS",
              "target": "StoragePlugin.save_file"
            }
          ],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "delete_file",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 81,
          "end_line": 111,
          "tags": {
            "PURPOSE": "Delete a specific file or directory.",
            "PRE": "category must be a valid FileCategory.",
            "POST": "Item is removed from storage.",
            "PARAM": "path (str) - Relative path of the item.",
            "RETURN": "None",
            "SIDE_EFFECT": "Deletes item from the filesystem."
          },
          "relations": [
            {
              "type": "CALLS",
              "target": "StoragePlugin.delete_file"
            }
          ],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "download_file",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 113,
          "end_line": 143,
          "tags": {
            "PURPOSE": "Retrieve a file for download.",
            "PRE": "category must be a valid FileCategory.",
            "POST": "Returns a FileResponse.",
            "PARAM": "path (str) - Relative path of the file.",
            "RETURN": "FileResponse - The file content."
          },
          "relations": [
            {
              "type": "CALLS",
              "target": "StoragePlugin.get_file_path"
            }
          ],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        }
      ],
      "compliance": {
        "valid": true,
        "issues": [
          {
            "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
            "severity": "WARNING",
            "line_number": 1
          }
        ],
        "score": 0.85
      }
    },
    {
      "name": "TasksRouter",
      "type": "Module",
      "tier": "STANDARD",
      "start_line": 1,
      "end_line": 211,
      "tags": {
        "SEMANTICS": "api, router, tasks, create, list, get",
        "PURPOSE": "Defines the FastAPI router for task-related endpoints, allowing clients to create, list, and get the status of tasks.",
        "LAYER": "UI (API)",
        "RELATION": "Depends on the TaskManager. It is included by the main app."
      },
      "relations": [],
      "children": [
        {
          "name": "create_task",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 27,
          "end_line": 68,
          "tags": {
            "PURPOSE": "Create and start a new task for a given plugin.",
            "PARAM": "task_manager (TaskManager) - The task manager instance.",
            "PRE": "plugin_id must exist and params must be valid for that plugin.",
            "POST": "A new task is created and started.",
            "RETURN": "Task - The created task instance."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "list_tasks",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 71,
          "end_line": 92,
          "tags": {
            "PURPOSE": "Retrieve a list of tasks with pagination and optional status filter.",
            "PARAM": "task_manager (TaskManager) - The task manager instance.",
            "PRE": "task_manager must be available.",
            "POST": "Returns a list of tasks.",
            "RETURN": "List[Task] - List of tasks."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "get_task",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 95,
          "end_line": 115,
          "tags": {
            "PURPOSE": "Retrieve the details of a specific task.",
            "PARAM": "task_manager (TaskManager) - The task manager instance.",
            "PRE": "task_id must exist.",
            "POST": "Returns task details or raises 404.",
            "RETURN": "Task - The task details."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "get_task_logs",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 118,
          "end_line": 138,
          "tags": {
            "PURPOSE": "Retrieve logs for a specific task.",
            "PARAM": "task_manager (TaskManager) - The task manager instance.",
            "PRE": "task_id must exist.",
            "POST": "Returns a list of log entries or raises 404.",
            "RETURN": "List[LogEntry] - List of log entries."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "resolve_task",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 141,
          "end_line": 164,
          "tags": {
            "PURPOSE": "Resolve a task that is awaiting mapping.",
            "PARAM": "task_manager (TaskManager) - The task manager instance.",
            "PRE": "task must be in AWAITING_MAPPING status.",
            "POST": "Task is resolved and resumes execution.",
            "RETURN": "Task - The updated task object."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "resume_task",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 167,
          "end_line": 190,
          "tags": {
            "PURPOSE": "Resume a task that is awaiting input (e.g., passwords).",
            "PARAM": "task_manager (TaskManager) - The task manager instance.",
            "PRE": "task must be in AWAITING_INPUT status.",
            "POST": "Task resumes execution with provided input.",
            "RETURN": "Task - The updated task object."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "clear_tasks",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 193,
          "end_line": 210,
          "tags": {
            "PURPOSE": "Clear tasks matching the status filter.",
            "PARAM": "task_manager (TaskManager) - The task manager instance.",
            "PRE": "task_manager is available.",
            "POST": "Tasks are removed from memory/persistence."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        }
      ],
      "compliance": {
        "valid": true,
        "issues": [
          {
            "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
            "severity": "WARNING",
            "line_number": 1
          }
        ],
        "score": 0.85
      }
    },
    {
      "name": "backend.src.models.llm",
      "type": "Module",
      "tier": "STANDARD",
      "start_line": 1,
      "end_line": 46,
      "tags": {
        "TIER": "STANDARD",
        "SEMANTICS": "llm, models, sqlalchemy, persistence",
        "PURPOSE": "SQLAlchemy models for LLM provider configuration and validation results.",
        "LAYER": "Domain"
      },
      "relations": [
        {
          "type": "INHERITS_FROM",
          "target": "backend.src.models.mapping.Base"
        }
      ],
      "children": [
        {
          "name": "LLMProvider",
          "type": "Class",
          "tier": "STANDARD",
          "start_line": 16,
          "end_line": 29,
          "tags": {
            "PURPOSE": "SQLAlchemy model for LLM provider configuration."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 16
              },
              {
                "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 16
              }
            ],
            "score": 0.7000000000000001
          }
        },
        {
          "name": "ValidationRecord",
          "type": "Class",
          "tier": "STANDARD",
          "start_line": 31,
          "end_line": 44,
          "tags": {
            "PURPOSE": "SQLAlchemy model for dashboard validation history."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 31
              },
              {
                "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 31
              }
            ],
            "score": 0.7000000000000001
          }
        },
        {
          "name": "generate_uuid",
          "type": "Function",
          "tier": "TRIVIAL",
          "start_line": 13,
          "end_line": 13,
          "tags": {
            "PURPOSE": "Auto-detected function (orphan)",
            "TIER": "TRIVIAL"
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        }
      ],
      "compliance": {
        "valid": true,
        "issues": [],
        "score": 1.0
      }
    },
    {
      "name": "GitModels",
      "type": "Module",
      "tier": "STANDARD",
      "start_line": 1,
      "end_line": 73,
      "tags": {
        "SEMANTICS": "git, models, sqlalchemy, database, schema",
        "PURPOSE": "Git-specific SQLAlchemy models for configuration and repository tracking.",
        "LAYER": "Model",
        "RELATION": "specs/011-git-integration-dashboard/data-model.md"
      },
      "relations": [],
      "children": [],
      "compliance": {
        "valid": true,
        "issues": [
          {
            "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
            "severity": "WARNING",
            "line_number": 1
          }
        ],
        "score": 0.85
      }
    },
    {
      "name": "backend.src.models.task",
      "type": "Module",
      "tier": "STANDARD",
      "start_line": 1,
      "end_line": 35,
      "tags": {
        "SEMANTICS": "database, task, record, sqlalchemy, sqlite",
        "PURPOSE": "Defines the database schema for task execution records.",
        "LAYER": "Domain",
        "INVARIANT": "All primary keys are UUID strings."
      },
      "relations": [
        {
          "type": "DEPENDS_ON",
          "target": "sqlalchemy"
        }
      ],
      "children": [
        {
          "name": "TaskRecord",
          "type": "Class",
          "tier": "STANDARD",
          "start_line": 17,
          "end_line": 33,
          "tags": {
            "PURPOSE": "Represents a persistent record of a task execution."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 17
              },
              {
                "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 17
              }
            ],
            "score": 0.7000000000000001
          }
        }
      ],
      "compliance": {
        "valid": true,
        "issues": [
          {
            "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
            "severity": "WARNING",
            "line_number": 1
          }
        ],
        "score": 0.85
      }
    },
    {
      "name": "backend.src.models.connection",
      "type": "Module",
      "tier": "STANDARD",
      "start_line": 1,
      "end_line": 34,
      "tags": {
        "SEMANTICS": "database, connection, configuration, sqlalchemy, sqlite",
        "PURPOSE": "Defines the database schema for external database connection configurations.",
        "LAYER": "Domain",
        "INVARIANT": "All primary keys are UUID strings."
      },
      "relations": [
        {
          "type": "DEPENDS_ON",
          "target": "sqlalchemy"
        }
      ],
      "children": [
        {
          "name": "ConnectionConfig",
          "type": "Class",
          "tier": "STANDARD",
          "start_line": 17,
          "end_line": 32,
          "tags": {
            "PURPOSE": "Stores credentials for external databases used for column mapping."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 17
              },
              {
                "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 17
              }
            ],
            "score": 0.7000000000000001
          }
        }
      ],
      "compliance": {
        "valid": true,
        "issues": [
          {
            "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
            "severity": "WARNING",
            "line_number": 1
          }
        ],
        "score": 0.85
      }
    },
    {
      "name": "backend.src.models.mapping",
      "type": "Module",
      "tier": "STANDARD",
      "start_line": 1,
      "end_line": 74,
      "tags": {
        "TIER": "STANDARD",
        "SEMANTICS": "database, mapping, environment, migration, sqlalchemy, sqlite",
        "PURPOSE": "Defines the database schema for environment metadata and database mappings using SQLAlchemy.",
        "LAYER": "Domain",
        "INVARIANT": "All primary keys are UUID strings.",
        "CONSTRAINT": "source_env_id and target_env_id must be valid environment IDs."
      },
      "relations": [
        {
          "type": "DEPENDS_ON",
          "target": "sqlalchemy"
        }
      ],
      "children": [
        {
          "name": "MigrationStatus",
          "type": "Class",
          "tier": "TRIVIAL",
          "start_line": 22,
          "end_line": 31,
          "tags": {
            "TIER": "TRIVIAL",
            "PURPOSE": "Enumeration of possible migration job statuses."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "Environment",
          "type": "Class",
          "tier": "STANDARD",
          "start_line": 33,
          "end_line": 43,
          "tags": {
            "TIER": "STANDARD",
            "PURPOSE": "Represents a Superset instance environment."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "DatabaseMapping",
          "type": "Class",
          "tier": "STANDARD",
          "start_line": 45,
          "end_line": 59,
          "tags": {
            "TIER": "STANDARD",
            "PURPOSE": "Represents a mapping between source and target databases."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "MigrationJob",
          "type": "Class",
          "tier": "STANDARD",
          "start_line": 61,
          "end_line": 72,
          "tags": {
            "PURPOSE": "Represents a single migration execution job."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 61
              },
              {
                "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 61
              }
            ],
            "score": 0.7000000000000001
          }
        }
      ],
      "compliance": {
        "valid": true,
        "issues": [],
        "score": 1.0
      }
    },
    {
      "name": "FileCategory",
      "type": "Class",
      "tier": "STANDARD",
      "start_line": 6,
      "end_line": 11,
      "tags": {
        "PURPOSE": "Enumeration of supported file categories in the storage system."
      },
      "relations": [],
      "children": [],
      "compliance": {
        "valid": true,
        "issues": [
          {
            "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
            "severity": "WARNING",
            "line_number": 6
          }
        ],
        "score": 0.8
      }
    },
    {
      "name": "StorageConfig",
      "type": "Class",
      "tier": "STANDARD",
      "start_line": 13,
      "end_line": 20,
      "tags": {
        "PURPOSE": "Configuration model for the storage system, defining paths and naming patterns."
      },
      "relations": [],
      "children": [],
      "compliance": {
        "valid": true,
        "issues": [
          {
            "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
            "severity": "WARNING",
            "line_number": 13
          }
        ],
        "score": 0.8
      }
    },
    {
      "name": "StoredFile",
      "type": "Class",
      "tier": "STANDARD",
      "start_line": 22,
      "end_line": 31,
      "tags": {
        "PURPOSE": "Data model representing metadata for a file stored in the system."
      },
      "relations": [],
      "children": [],
      "compliance": {
        "valid": true,
        "issues": [
          {
            "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
            "severity": "WARNING",
            "line_number": 22
          }
        ],
        "score": 0.8
      }
    },
    {
      "name": "backend.src.models.dashboard",
      "type": "Module",
      "tier": "STANDARD",
      "start_line": 1,
      "end_line": 31,
      "tags": {
        "TIER": "STANDARD",
        "SEMANTICS": "dashboard, model, metadata, migration",
        "PURPOSE": "Defines data models for dashboard metadata and selection.",
        "LAYER": "Model"
      },
      "relations": [
        {
          "type": "USED_BY",
          "target": "backend.src.api.routes.migration"
        }
      ],
      "children": [
        {
          "name": "DashboardMetadata",
          "type": "Class",
          "tier": "TRIVIAL",
          "start_line": 11,
          "end_line": 19,
          "tags": {
            "TIER": "TRIVIAL",
            "PURPOSE": "Represents a dashboard available for migration."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "DashboardSelection",
          "type": "Class",
          "tier": "TRIVIAL",
          "start_line": 21,
          "end_line": 29,
          "tags": {
            "TIER": "TRIVIAL",
            "PURPOSE": "Represents the user's selection of dashboards to migrate."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        }
      ],
      "compliance": {
        "valid": true,
        "issues": [],
        "score": 1.0
      }
    },
    {
      "name": "backend.src.models.auth",
      "type": "Module",
      "tier": "STANDARD",
      "start_line": 1,
      "end_line": 105,
      "tags": {
        "TIER": "STANDARD",
        "SEMANTICS": "auth, models, user, role, permission, sqlalchemy",
        "PURPOSE": "SQLAlchemy models for multi-user authentication and authorization.",
        "LAYER": "Domain",
        "INVARIANT": "Usernames and emails must be unique."
      },
      "relations": [
        {
          "type": "INHERITS_FROM",
          "target": "backend.src.models.mapping.Base"
        }
      ],
      "children": [
        {
          "name": "generate_uuid",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 19,
          "end_line": 24,
          "tags": {
            "PURPOSE": "Generates a unique UUID string.",
            "POST": "Returns a string representation of a new UUID."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Mandatory Tag: @PRE (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 19
              },
              {
                "message": "Missing Belief State Logging: Function should use belief_scope (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 19
              },
              {
                "message": "Missing Mandatory Tag: @PRE (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 19
              },
              {
                "message": "Missing Belief State Logging: Function should use belief_scope (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 19
              }
            ],
            "score": 0.5333333333333333
          }
        },
        {
          "name": "user_roles",
          "type": "Table",
          "tier": "STANDARD",
          "start_line": 26,
          "end_line": 34,
          "tags": {
            "PURPOSE": "Association table for many-to-many relationship between Users and Roles."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "role_permissions",
          "type": "Table",
          "tier": "STANDARD",
          "start_line": 36,
          "end_line": 44,
          "tags": {
            "PURPOSE": "Association table for many-to-many relationship between Roles and Permissions."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "User",
          "type": "Class",
          "tier": "STANDARD",
          "start_line": 46,
          "end_line": 62,
          "tags": {
            "PURPOSE": "Represents an identity that can authenticate to the system."
          },
          "relations": [
            {
              "type": "HAS_MANY",
              "target": "Role (via user_roles)"
            }
          ],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 46
              },
              {
                "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 46
              }
            ],
            "score": 0.7000000000000001
          }
        },
        {
          "name": "Role",
          "type": "Class",
          "tier": "STANDARD",
          "start_line": 64,
          "end_line": 77,
          "tags": {
            "PURPOSE": "Represents a collection of permissions."
          },
          "relations": [
            {
              "type": "HAS_MANY",
              "target": "User (via user_roles)"
            },
            {
              "type": "HAS_MANY",
              "target": "Permission (via role_permissions)"
            }
          ],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 64
              },
              {
                "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 64
              }
            ],
            "score": 0.7000000000000001
          }
        },
        {
          "name": "Permission",
          "type": "Class",
          "tier": "STANDARD",
          "start_line": 79,
          "end_line": 90,
          "tags": {
            "PURPOSE": "Represents a specific capability within the system."
          },
          "relations": [
            {
              "type": "HAS_MANY",
              "target": "Role (via role_permissions)"
            }
          ],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 79
              },
              {
                "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 79
              }
            ],
            "score": 0.7000000000000001
          }
        },
        {
          "name": "ADGroupMapping",
          "type": "Class",
          "tier": "STANDARD",
          "start_line": 92,
          "end_line": 103,
          "tags": {
            "PURPOSE": "Maps an Active Directory group to a local System Role."
          },
          "relations": [
            {
              "type": "DEPENDS_ON",
              "target": "Role"
            }
          ],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 92
              },
              {
                "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 92
              }
            ],
            "score": 0.7000000000000001
          }
        }
      ],
      "compliance": {
        "valid": true,
        "issues": [],
        "score": 1.0
      }
    },
    {
      "name": "backend.src.services.llm_provider",
      "type": "Module",
      "tier": "STANDARD",
      "start_line": 1,
      "end_line": 117,
      "tags": {
        "TIER": "STANDARD",
        "SEMANTICS": "service, llm, provider, encryption",
        "PURPOSE": "Service for managing LLM provider configurations with encrypted API keys.",
        "LAYER": "Domain"
      },
      "relations": [
        {
          "type": "DEPENDS_ON",
          "target": "backend.src.core.database"
        },
        {
          "type": "DEPENDS_ON",
          "target": "backend.src.models.llm"
        }
      ],
      "children": [
        {
          "name": "EncryptionManager",
          "type": "Class",
          "tier": "STANDARD",
          "start_line": 17,
          "end_line": 30,
          "tags": {
            "PURPOSE": "Handles encryption and decryption of sensitive data like API keys.",
            "INVARIANT": "Uses a secret key from environment or a default one (fallback only for dev)."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 17
              },
              {
                "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 17
              }
            ],
            "score": 0.7000000000000001
          }
        },
        {
          "name": "LLMProviderService",
          "type": "Class",
          "tier": "STANDARD",
          "start_line": 32,
          "end_line": 115,
          "tags": {
            "PURPOSE": "Service to manage LLM provider lifecycle."
          },
          "relations": [],
          "children": [
            {
              "name": "get_all_providers",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 39,
              "end_line": 44,
              "tags": {
                "PURPOSE": "Returns all configured LLM providers."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [
                  {
                    "message": "Missing Mandatory Tag: @PRE (required for STANDARD tier)",
                    "severity": "WARNING",
                    "line_number": 39
                  },
                  {
                    "message": "Missing Mandatory Tag: @POST (required for STANDARD tier)",
                    "severity": "WARNING",
                    "line_number": 39
                  },
                  {
                    "message": "Missing Mandatory Tag: @PRE (required for STANDARD tier)",
                    "severity": "WARNING",
                    "line_number": 39
                  },
                  {
                    "message": "Missing Mandatory Tag: @POST (required for STANDARD tier)",
                    "severity": "WARNING",
                    "line_number": 39
                  },
                  {
                    "message": "Missing Mandatory Tag: @PRE (required for STANDARD tier)",
                    "severity": "WARNING",
                    "line_number": 39
                  },
                  {
                    "message": "Missing Mandatory Tag: @POST (required for STANDARD tier)",
                    "severity": "WARNING",
                    "line_number": 39
                  }
                ],
                "score": 0.26666666666666655
              }
            },
            {
              "name": "get_provider",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 46,
              "end_line": 51,
              "tags": {
                "PURPOSE": "Returns a single LLM provider by ID."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [
                  {
                    "message": "Missing Mandatory Tag: @PRE (required for STANDARD tier)",
                    "severity": "WARNING",
                    "line_number": 46
                  },
                  {
                    "message": "Missing Mandatory Tag: @POST (required for STANDARD tier)",
                    "severity": "WARNING",
                    "line_number": 46
                  },
                  {
                    "message": "Missing Mandatory Tag: @PRE (required for STANDARD tier)",
                    "severity": "WARNING",
                    "line_number": 46
                  },
                  {
                    "message": "Missing Mandatory Tag: @POST (required for STANDARD tier)",
                    "severity": "WARNING",
                    "line_number": 46
                  },
                  {
                    "message": "Missing Mandatory Tag: @PRE (required for STANDARD tier)",
                    "severity": "WARNING",
                    "line_number": 46
                  },
                  {
                    "message": "Missing Mandatory Tag: @POST (required for STANDARD tier)",
                    "severity": "WARNING",
                    "line_number": 46
                  }
                ],
                "score": 0.26666666666666655
              }
            },
            {
              "name": "create_provider",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 53,
              "end_line": 70,
              "tags": {
                "PURPOSE": "Creates a new LLM provider with encrypted API key."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [
                  {
                    "message": "Missing Mandatory Tag: @PRE (required for STANDARD tier)",
                    "severity": "WARNING",
                    "line_number": 53
                  },
                  {
                    "message": "Missing Mandatory Tag: @POST (required for STANDARD tier)",
                    "severity": "WARNING",
                    "line_number": 53
                  },
                  {
                    "message": "Missing Mandatory Tag: @PRE (required for STANDARD tier)",
                    "severity": "WARNING",
                    "line_number": 53
                  },
                  {
                    "message": "Missing Mandatory Tag: @POST (required for STANDARD tier)",
                    "severity": "WARNING",
                    "line_number": 53
                  },
                  {
                    "message": "Missing Mandatory Tag: @PRE (required for STANDARD tier)",
                    "severity": "WARNING",
                    "line_number": 53
                  },
                  {
                    "message": "Missing Mandatory Tag: @POST (required for STANDARD tier)",
                    "severity": "WARNING",
                    "line_number": 53
                  }
                ],
                "score": 0.26666666666666655
              }
            },
            {
              "name": "update_provider",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 72,
              "end_line": 91,
              "tags": {
                "PURPOSE": "Updates an existing LLM provider."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [
                  {
                    "message": "Missing Mandatory Tag: @PRE (required for STANDARD tier)",
                    "severity": "WARNING",
                    "line_number": 72
                  },
                  {
                    "message": "Missing Mandatory Tag: @POST (required for STANDARD tier)",
                    "severity": "WARNING",
                    "line_number": 72
                  },
                  {
                    "message": "Missing Mandatory Tag: @PRE (required for STANDARD tier)",
                    "severity": "WARNING",
                    "line_number": 72
                  },
                  {
                    "message": "Missing Mandatory Tag: @POST (required for STANDARD tier)",
                    "severity": "WARNING",
                    "line_number": 72
                  },
                  {
                    "message": "Missing Mandatory Tag: @PRE (required for STANDARD tier)",
                    "severity": "WARNING",
                    "line_number": 72
                  },
                  {
                    "message": "Missing Mandatory Tag: @POST (required for STANDARD tier)",
                    "severity": "WARNING",
                    "line_number": 72
                  }
                ],
                "score": 0.26666666666666655
              }
            },
            {
              "name": "delete_provider",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 93,
              "end_line": 103,
              "tags": {
                "PURPOSE": "Deletes an LLM provider."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [
                  {
                    "message": "Missing Mandatory Tag: @PRE (required for STANDARD tier)",
                    "severity": "WARNING",
                    "line_number": 93
                  },
                  {
                    "message": "Missing Mandatory Tag: @POST (required for STANDARD tier)",
                    "severity": "WARNING",
                    "line_number": 93
                  },
                  {
                    "message": "Missing Mandatory Tag: @PRE (required for STANDARD tier)",
                    "severity": "WARNING",
                    "line_number": 93
                  },
                  {
                    "message": "Missing Mandatory Tag: @POST (required for STANDARD tier)",
                    "severity": "WARNING",
                    "line_number": 93
                  },
                  {
                    "message": "Missing Mandatory Tag: @PRE (required for STANDARD tier)",
                    "severity": "WARNING",
                    "line_number": 93
                  },
                  {
                    "message": "Missing Mandatory Tag: @POST (required for STANDARD tier)",
                    "severity": "WARNING",
                    "line_number": 93
                  }
                ],
                "score": 0.26666666666666655
              }
            },
            {
              "name": "get_decrypted_api_key",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 105,
              "end_line": 113,
              "tags": {
                "PURPOSE": "Returns the decrypted API key for a provider."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [
                  {
                    "message": "Missing Mandatory Tag: @PRE (required for STANDARD tier)",
                    "severity": "WARNING",
                    "line_number": 105
                  },
                  {
                    "message": "Missing Mandatory Tag: @POST (required for STANDARD tier)",
                    "severity": "WARNING",
                    "line_number": 105
                  },
                  {
                    "message": "Missing Mandatory Tag: @PRE (required for STANDARD tier)",
                    "severity": "WARNING",
                    "line_number": 105
                  },
                  {
                    "message": "Missing Mandatory Tag: @POST (required for STANDARD tier)",
                    "severity": "WARNING",
                    "line_number": 105
                  },
                  {
                    "message": "Missing Mandatory Tag: @PRE (required for STANDARD tier)",
                    "severity": "WARNING",
                    "line_number": 105
                  },
                  {
                    "message": "Missing Mandatory Tag: @POST (required for STANDARD tier)",
                    "severity": "WARNING",
                    "line_number": 105
                  }
                ],
                "score": 0.26666666666666655
              }
            }
          ],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 32
              },
              {
                "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 32
              }
            ],
            "score": 0.7000000000000001
          }
        },
        {
          "name": "__init__",
          "type": "Function",
          "tier": "TRIVIAL",
          "start_line": 21,
          "end_line": 21,
          "tags": {
            "PURPOSE": "Auto-detected function (orphan)",
            "TIER": "TRIVIAL"
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "encrypt",
          "type": "Function",
          "tier": "TRIVIAL",
          "start_line": 25,
          "end_line": 25,
          "tags": {
            "PURPOSE": "Auto-detected function (orphan)",
            "TIER": "TRIVIAL"
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "decrypt",
          "type": "Function",
          "tier": "TRIVIAL",
          "start_line": 28,
          "end_line": 28,
          "tags": {
            "PURPOSE": "Auto-detected function (orphan)",
            "TIER": "TRIVIAL"
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "__init__",
          "type": "Function",
          "tier": "TRIVIAL",
          "start_line": 35,
          "end_line": 35,
          "tags": {
            "PURPOSE": "Auto-detected function (orphan)",
            "TIER": "TRIVIAL"
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        }
      ],
      "compliance": {
        "valid": true,
        "issues": [],
        "score": 1.0
      }
    },
    {
      "name": "backend.src.services.auth_service",
      "type": "Module",
      "tier": "STANDARD",
      "start_line": 1,
      "end_line": 115,
      "tags": {
        "SEMANTICS": "auth, service, business-logic, login, jwt",
        "PURPOSE": "Orchestrates authentication business logic.",
        "LAYER": "Service",
        "INVARIANT": "Authentication must verify both credentials and account status."
      },
      "relations": [
        {
          "type": "USES",
          "target": "backend.src.core.auth.repository.AuthRepository"
        },
        {
          "type": "USES",
          "target": "backend.src.core.auth.security"
        },
        {
          "type": "USES",
          "target": "backend.src.core.auth.jwt"
        }
      ],
      "children": [
        {
          "name": "AuthService",
          "type": "Class",
          "tier": "STANDARD",
          "start_line": 22,
          "end_line": 113,
          "tags": {
            "PURPOSE": "Provides high-level authentication services."
          },
          "relations": [],
          "children": [
            {
              "name": "__init__",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 25,
              "end_line": 30,
              "tags": {
                "PURPOSE": "Initializes the service with a database session.",
                "PARAM": "db (Session) - SQLAlchemy session."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [
                  {
                    "message": "Missing Mandatory Tag: @PRE (required for STANDARD tier)",
                    "severity": "WARNING",
                    "line_number": 25
                  },
                  {
                    "message": "Missing Mandatory Tag: @POST (required for STANDARD tier)",
                    "severity": "WARNING",
                    "line_number": 25
                  },
                  {
                    "message": "Missing Mandatory Tag: @PRE (required for STANDARD tier)",
                    "severity": "WARNING",
                    "line_number": 25
                  },
                  {
                    "message": "Missing Mandatory Tag: @POST (required for STANDARD tier)",
                    "severity": "WARNING",
                    "line_number": 25
                  },
                  {
                    "message": "Missing Mandatory Tag: @PRE (required for STANDARD tier)",
                    "severity": "WARNING",
                    "line_number": 25
                  },
                  {
                    "message": "Missing Mandatory Tag: @POST (required for STANDARD tier)",
                    "severity": "WARNING",
                    "line_number": 25
                  }
                ],
                "score": 0.26666666666666655
              }
            },
            {
              "name": "authenticate_user",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 32,
              "end_line": 54,
              "tags": {
                "PURPOSE": "Authenticates a user with username and password.",
                "PRE": "username and password are provided.",
                "POST": "Returns User object if authentication succeeds, else None.",
                "SIDE_EFFECT": "Updates last_login timestamp on success.",
                "PARAM": "password (str) - The plain password.",
                "RETURN": "Optional[User] - The authenticated user or None."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            },
            {
              "name": "create_session",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 56,
              "end_line": 77,
              "tags": {
                "PURPOSE": "Creates a JWT session for an authenticated user.",
                "PRE": "user is a valid User object.",
                "POST": "Returns a dictionary with access_token and token_type.",
                "PARAM": "user (User) - The authenticated user.",
                "RETURN": "Dict[str, str] - Session data."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            },
            {
              "name": "provision_adfs_user",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 79,
              "end_line": 111,
              "tags": {
                "PURPOSE": "Just-In-Time (JIT) provisioning for ADFS users based on group mappings.",
                "PRE": "user_info contains 'upn' (username), 'email', and 'groups'.",
                "POST": "User is created/updated and assigned roles based on groups.",
                "PARAM": "user_info (Dict[str, Any]) - Claims from ADFS token.",
                "RETURN": "User - The provisioned user."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            }
          ],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 22
              },
              {
                "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 22
              }
            ],
            "score": 0.7000000000000001
          }
        }
      ],
      "compliance": {
        "valid": true,
        "issues": [
          {
            "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
            "severity": "WARNING",
            "line_number": 1
          }
        ],
        "score": 0.85
      }
    },
    {
      "name": "backend.src.services.git_service",
      "type": "Module",
      "tier": "STANDARD",
      "start_line": 1,
      "end_line": 413,
      "tags": {
        "SEMANTICS": "git, service, gitpython, repository, version_control",
        "PURPOSE": "Core Git logic using GitPython to manage dashboard repositories.",
        "LAYER": "Service",
        "INVARIANT": "All Git operations must be performed on a valid local directory."
      },
      "relations": [
        {
          "type": "INHERITS_FROM",
          "target": "None"
        },
        {
          "type": "USED_BY",
          "target": "src.api.routes.git"
        },
        {
          "type": "USED_BY",
          "target": "src.plugins.git_plugin"
        }
      ],
      "children": [
        {
          "name": "GitService",
          "type": "Class",
          "tier": "STANDARD",
          "start_line": 22,
          "end_line": 412,
          "tags": {
            "PURPOSE": "Wrapper for GitPython operations with semantic logging and error handling."
          },
          "relations": [],
          "children": [
            {
              "name": "__init__",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 29,
              "end_line": 45,
              "tags": {
                "PURPOSE": "Initializes the GitService with a base path for repositories.",
                "PARAM": "base_path (str) - Root directory for all Git clones.",
                "PRE": "base_path is a valid string path.",
                "POST": "GitService is initialized; base_path directory exists."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            },
            {
              "name": "_get_repo_path",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 47,
              "end_line": 56,
              "tags": {
                "PURPOSE": "Resolves the local filesystem path for a dashboard's repository.",
                "PARAM": "dashboard_id (int)",
                "PRE": "dashboard_id is an integer.",
                "POST": "Returns the absolute or relative path to the dashboard's repo.",
                "RETURN": "str"
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            },
            {
              "name": "init_repo",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 58,
              "end_line": 83,
              "tags": {
                "PURPOSE": "Initialize or clone a repository for a dashboard.",
                "PARAM": "pat (str) - Personal Access Token for authentication.",
                "PRE": "dashboard_id is int, remote_url is valid Git URL, pat is provided.",
                "POST": "Repository is cloned or opened at the local path.",
                "RETURN": "Repo - GitPython Repo object."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            },
            {
              "name": "get_repo",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 85,
              "end_line": 101,
              "tags": {
                "PURPOSE": "Get Repo object for a dashboard.",
                "PRE": "Repository must exist on disk for the given dashboard_id.",
                "POST": "Returns a GitPython Repo instance for the dashboard.",
                "RETURN": "Repo"
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            },
            {
              "name": "list_branches",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 103,
              "end_line": 155,
              "tags": {
                "PURPOSE": "List all branches for a dashboard's repository.",
                "PRE": "Repository for dashboard_id exists.",
                "POST": "Returns a list of branch metadata dictionaries.",
                "RETURN": "List[dict]"
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            },
            {
              "name": "create_branch",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 157,
              "end_line": 191,
              "tags": {
                "PURPOSE": "Create a new branch from an existing one.",
                "PARAM": "from_branch (str) - Source branch.",
                "PRE": "Repository exists; name is valid; from_branch exists or repo is empty.",
                "POST": "A new branch is created in the repository."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            },
            {
              "name": "checkout_branch",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 193,
              "end_line": 202,
              "tags": {
                "PURPOSE": "Switch to a specific branch.",
                "PRE": "Repository exists and the specified branch name exists.",
                "POST": "The repository working directory is updated to the specified branch."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            },
            {
              "name": "commit_changes",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 204,
              "end_line": 228,
              "tags": {
                "PURPOSE": "Stage and commit changes.",
                "PARAM": "files (List[str]) - Optional list of specific files to stage.",
                "PRE": "Repository exists and has changes (dirty) or files are specified.",
                "POST": "Changes are staged and a new commit is created."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            },
            {
              "name": "push_changes",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 230,
              "end_line": 262,
              "tags": {
                "PURPOSE": "Push local commits to remote.",
                "PRE": "Repository exists and has an 'origin' remote.",
                "POST": "Local branch commits are pushed to origin."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            },
            {
              "name": "pull_changes",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 264,
              "end_line": 285,
              "tags": {
                "PURPOSE": "Pull changes from remote.",
                "PRE": "Repository exists and has an 'origin' remote.",
                "POST": "Changes from origin are pulled and merged into the active branch."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            },
            {
              "name": "get_status",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 287,
              "end_line": 311,
              "tags": {
                "PURPOSE": "Get current repository status (dirty files, untracked, etc.)",
                "PRE": "Repository for dashboard_id exists.",
                "POST": "Returns a dictionary representing the Git status.",
                "RETURN": "dict"
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            },
            {
              "name": "get_diff",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 313,
              "end_line": 330,
              "tags": {
                "PURPOSE": "Generate diff for a file or the whole repository.",
                "PARAM": "staged (bool) - Whether to show staged changes.",
                "PRE": "Repository for dashboard_id exists.",
                "POST": "Returns the diff text as a string.",
                "RETURN": "str"
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            },
            {
              "name": "get_commit_history",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 332,
              "end_line": 360,
              "tags": {
                "PURPOSE": "Retrieve commit history for a repository.",
                "PARAM": "limit (int) - Max number of commits to return.",
                "PRE": "Repository for dashboard_id exists.",
                "POST": "Returns a list of dictionaries for each commit in history.",
                "RETURN": "List[dict]"
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            },
            {
              "name": "test_connection",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 362,
              "end_line": 410,
              "tags": {
                "PURPOSE": "Test connection to Git provider using PAT.",
                "PARAM": "pat (str)",
                "PRE": "provider is valid; url is a valid HTTP(S) URL; pat is provided.",
                "POST": "Returns True if connection to the provider's API succeeds.",
                "RETURN": "bool"
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            }
          ],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 22
              },
              {
                "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 22
              }
            ],
            "score": 0.7000000000000001
          }
        }
      ],
      "compliance": {
        "valid": true,
        "issues": [
          {
            "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
            "severity": "WARNING",
            "line_number": 1
          }
        ],
        "score": 0.85
      }
    },
    {
      "name": "backend.src.services.mapping_service",
      "type": "Module",
      "tier": "STANDARD",
      "start_line": 1,
      "end_line": 71,
      "tags": {
        "SEMANTICS": "service, mapping, fuzzy-matching, superset",
        "PURPOSE": "Orchestrates database fetching and fuzzy matching suggestions.",
        "LAYER": "Service",
        "INVARIANT": "Suggestions are based on database names."
      },
      "relations": [
        {
          "type": "DEPENDS_ON",
          "target": "backend.src.core.superset_client"
        },
        {
          "type": "DEPENDS_ON",
          "target": "backend.src.core.utils.matching"
        }
      ],
      "children": [
        {
          "name": "MappingService",
          "type": "Class",
          "tier": "STANDARD",
          "start_line": 18,
          "end_line": 69,
          "tags": {
            "PURPOSE": "Service for handling database mapping logic."
          },
          "relations": [],
          "children": [
            {
              "name": "__init__",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 22,
              "end_line": 30,
              "tags": {
                "PURPOSE": "Initializes the mapping service with a config manager.",
                "PRE": "config_manager is provided.",
                "PARAM": "config_manager (ConfigManager) - The configuration manager.",
                "POST": "Service is initialized."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            },
            {
              "name": "_get_client",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 32,
              "end_line": 46,
              "tags": {
                "PURPOSE": "Helper to get an initialized SupersetClient for an environment.",
                "PARAM": "env_id (str) - The ID of the environment.",
                "PRE": "environment must exist in config.",
                "POST": "Returns an initialized SupersetClient.",
                "RETURN": "SupersetClient - Initialized client."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            },
            {
              "name": "get_suggestions",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 48,
              "end_line": 67,
              "tags": {
                "PURPOSE": "Fetches databases from both environments and returns fuzzy matching suggestions.",
                "PARAM": "target_env_id (str) - Target environment ID.",
                "PRE": "Both environments must be accessible.",
                "POST": "Returns fuzzy-matched database suggestions.",
                "RETURN": "List[Dict] - Suggested mappings."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            }
          ],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 18
              },
              {
                "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 18
              }
            ],
            "score": 0.7000000000000001
          }
        }
      ],
      "compliance": {
        "valid": true,
        "issues": [
          {
            "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
            "severity": "WARNING",
            "line_number": 1
          }
        ],
        "score": 0.85
      }
    },
    {
      "name": "BackupPlugin",
      "type": "Module",
      "tier": "STANDARD",
      "start_line": 1,
      "end_line": 193,
      "tags": {
        "SEMANTICS": "backup, superset, automation, dashboard, plugin",
        "PURPOSE": "A plugin that provides functionality to back up Superset dashboards.",
        "LAYER": "App"
      },
      "relations": [
        {
          "type": "IMPLEMENTS",
          "target": "PluginBase"
        },
        {
          "type": "DEPENDS_ON",
          "target": "superset_tool.client"
        },
        {
          "type": "DEPENDS_ON",
          "target": "superset_tool.utils"
        }
      ],
      "children": [
        {
          "name": "BackupPlugin",
          "type": "Class",
          "tier": "STANDARD",
          "start_line": 27,
          "end_line": 192,
          "tags": {
            "PURPOSE": "Implementation of the backup plugin logic."
          },
          "relations": [],
          "children": [
            {
              "name": "id",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 35,
              "end_line": 43,
              "tags": {
                "PURPOSE": "Returns the unique identifier for the backup plugin.",
                "PRE": "Plugin instance exists.",
                "POST": "Returns string ID.",
                "RETURN": "str - \"superset-backup\""
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            },
            {
              "name": "name",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 46,
              "end_line": 54,
              "tags": {
                "PURPOSE": "Returns the human-readable name of the backup plugin.",
                "PRE": "Plugin instance exists.",
                "POST": "Returns string name.",
                "RETURN": "str - Plugin name."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            },
            {
              "name": "description",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 57,
              "end_line": 65,
              "tags": {
                "PURPOSE": "Returns a description of the backup plugin.",
                "PRE": "Plugin instance exists.",
                "POST": "Returns string description.",
                "RETURN": "str - Plugin description."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            },
            {
              "name": "version",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 68,
              "end_line": 76,
              "tags": {
                "PURPOSE": "Returns the version of the backup plugin.",
                "PRE": "Plugin instance exists.",
                "POST": "Returns string version.",
                "RETURN": "str - \"1.0.0\""
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            },
            {
              "name": "ui_route",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 79,
              "end_line": 85,
              "tags": {
                "PURPOSE": "Returns the frontend route for the backup plugin.",
                "RETURN": "str - \"/tools/backups\""
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [
                  {
                    "message": "Missing Mandatory Tag: @PRE (required for STANDARD tier)",
                    "severity": "WARNING",
                    "line_number": 79
                  },
                  {
                    "message": "Missing Mandatory Tag: @POST (required for STANDARD tier)",
                    "severity": "WARNING",
                    "line_number": 79
                  },
                  {
                    "message": "Missing Mandatory Tag: @PRE (required for STANDARD tier)",
                    "severity": "WARNING",
                    "line_number": 79
                  },
                  {
                    "message": "Missing Mandatory Tag: @POST (required for STANDARD tier)",
                    "severity": "WARNING",
                    "line_number": 79
                  },
                  {
                    "message": "Missing Mandatory Tag: @PRE (required for STANDARD tier)",
                    "severity": "WARNING",
                    "line_number": 79
                  },
                  {
                    "message": "Missing Mandatory Tag: @POST (required for STANDARD tier)",
                    "severity": "WARNING",
                    "line_number": 79
                  }
                ],
                "score": 0.26666666666666655
              }
            },
            {
              "name": "get_schema",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 87,
              "end_line": 110,
              "tags": {
                "PURPOSE": "Returns the JSON schema for backup plugin parameters.",
                "PRE": "Plugin instance exists.",
                "POST": "Returns dictionary schema.",
                "RETURN": "Dict[str, Any] - JSON schema."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            },
            {
              "name": "execute",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 112,
              "end_line": 191,
              "tags": {
                "PURPOSE": "Executes the dashboard backup logic.",
                "PARAM": "params (Dict[str, Any]) - Backup parameters (env, backup_path).",
                "PRE": "Target environment must be configured. params must be a dictionary.",
                "POST": "All dashboards are exported and archived."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            }
          ],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 27
              },
              {
                "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 27
              }
            ],
            "score": 0.7000000000000001
          }
        }
      ],
      "compliance": {
        "valid": true,
        "issues": [
          {
            "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
            "severity": "WARNING",
            "line_number": 1
          }
        ],
        "score": 0.85
      }
    },
    {
      "name": "DebugPluginModule",
      "type": "Module",
      "tier": "STANDARD",
      "start_line": 1,
      "end_line": 196,
      "tags": {
        "SEMANTICS": "plugin, debug, api, database, superset",
        "PURPOSE": "Implements a plugin for system diagnostics and debugging Superset API responses.",
        "LAYER": "Plugins",
        "RELATION": "Inherits from PluginBase. Uses SupersetClient from core.",
        "CONSTRAINT": "Must use belief_scope for logging."
      },
      "relations": [],
      "children": [
        {
          "name": "DebugPlugin",
          "type": "Class",
          "tier": "STANDARD",
          "start_line": 15,
          "end_line": 195,
          "tags": {
            "PURPOSE": "Plugin for system diagnostics and debugging."
          },
          "relations": [],
          "children": [
            {
              "name": "id",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 23,
              "end_line": 31,
              "tags": {
                "PURPOSE": "Returns the unique identifier for the debug plugin.",
                "PRE": "Plugin instance exists.",
                "POST": "Returns string ID.",
                "RETURN": "str - \"system-debug\""
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            },
            {
              "name": "name",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 34,
              "end_line": 42,
              "tags": {
                "PURPOSE": "Returns the human-readable name of the debug plugin.",
                "PRE": "Plugin instance exists.",
                "POST": "Returns string name.",
                "RETURN": "str - Plugin name."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            },
            {
              "name": "description",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 45,
              "end_line": 53,
              "tags": {
                "PURPOSE": "Returns a description of the debug plugin.",
                "PRE": "Plugin instance exists.",
                "POST": "Returns string description.",
                "RETURN": "str - Plugin description."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            },
            {
              "name": "version",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 56,
              "end_line": 64,
              "tags": {
                "PURPOSE": "Returns the version of the debug plugin.",
                "PRE": "Plugin instance exists.",
                "POST": "Returns string version.",
                "RETURN": "str - \"1.0.0\""
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            },
            {
              "name": "ui_route",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 67,
              "end_line": 73,
              "tags": {
                "PURPOSE": "Returns the frontend route for the debug plugin.",
                "RETURN": "str - \"/tools/debug\""
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [
                  {
                    "message": "Missing Mandatory Tag: @PRE (required for STANDARD tier)",
                    "severity": "WARNING",
                    "line_number": 67
                  },
                  {
                    "message": "Missing Mandatory Tag: @POST (required for STANDARD tier)",
                    "severity": "WARNING",
                    "line_number": 67
                  },
                  {
                    "message": "Missing Mandatory Tag: @PRE (required for STANDARD tier)",
                    "severity": "WARNING",
                    "line_number": 67
                  },
                  {
                    "message": "Missing Mandatory Tag: @POST (required for STANDARD tier)",
                    "severity": "WARNING",
                    "line_number": 67
                  },
                  {
                    "message": "Missing Mandatory Tag: @PRE (required for STANDARD tier)",
                    "severity": "WARNING",
                    "line_number": 67
                  },
                  {
                    "message": "Missing Mandatory Tag: @POST (required for STANDARD tier)",
                    "severity": "WARNING",
                    "line_number": 67
                  }
                ],
                "score": 0.26666666666666655
              }
            },
            {
              "name": "get_schema",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 75,
              "end_line": 114,
              "tags": {
                "PURPOSE": "Returns the JSON schema for the debug plugin parameters.",
                "PRE": "Plugin instance exists.",
                "POST": "Returns dictionary schema.",
                "RETURN": "Dict[str, Any] - JSON schema."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            },
            {
              "name": "execute",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 116,
              "end_line": 132,
              "tags": {
                "PURPOSE": "Executes the debug logic.",
                "PARAM": "params (Dict[str, Any]) - Debug parameters.",
                "PRE": "action must be provided in params.",
                "POST": "Debug action is executed and results returned.",
                "RETURN": "Dict[str, Any] - Execution results."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            },
            {
              "name": "_test_db_api",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 134,
              "end_line": 166,
              "tags": {
                "PURPOSE": "Tests database API connectivity for source and target environments.",
                "PRE": "source_env and target_env params exist in params.",
                "POST": "Returns DB counts for both envs.",
                "PARAM": "params (Dict) - Plugin parameters.",
                "RETURN": "Dict - Comparison results."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            },
            {
              "name": "_get_dataset_structure",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 168,
              "end_line": 193,
              "tags": {
                "PURPOSE": "Retrieves the structure of a dataset.",
                "PRE": "env and dataset_id params exist in params.",
                "POST": "Returns dataset JSON structure.",
                "PARAM": "params (Dict) - Plugin parameters.",
                "RETURN": "Dict - Dataset structure."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            }
          ],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 15
              },
              {
                "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 15
              }
            ],
            "score": 0.7000000000000001
          }
        }
      ],
      "compliance": {
        "valid": true,
        "issues": [
          {
            "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
            "severity": "WARNING",
            "line_number": 1
          }
        ],
        "score": 0.85
      }
    },
    {
      "name": "SearchPluginModule",
      "type": "Module",
      "tier": "STANDARD",
      "start_line": 1,
      "end_line": 211,
      "tags": {
        "SEMANTICS": "plugin, search, datasets, regex, superset",
        "PURPOSE": "Implements a plugin for searching text patterns across all datasets in a specific Superset environment.",
        "LAYER": "Plugins",
        "RELATION": "Inherits from PluginBase. Uses SupersetClient from core.",
        "CONSTRAINT": "Must use belief_scope for logging."
      },
      "relations": [],
      "children": [
        {
          "name": "SearchPlugin",
          "type": "Class",
          "tier": "STANDARD",
          "start_line": 16,
          "end_line": 210,
          "tags": {
            "PURPOSE": "Plugin for searching text patterns in Superset datasets."
          },
          "relations": [],
          "children": [
            {
              "name": "id",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 24,
              "end_line": 32,
              "tags": {
                "PURPOSE": "Returns the unique identifier for the search plugin.",
                "PRE": "Plugin instance exists.",
                "POST": "Returns string ID.",
                "RETURN": "str - \"search-datasets\""
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            },
            {
              "name": "name",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 35,
              "end_line": 43,
              "tags": {
                "PURPOSE": "Returns the human-readable name of the search plugin.",
                "PRE": "Plugin instance exists.",
                "POST": "Returns string name.",
                "RETURN": "str - Plugin name."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            },
            {
              "name": "description",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 46,
              "end_line": 54,
              "tags": {
                "PURPOSE": "Returns a description of the search plugin.",
                "PRE": "Plugin instance exists.",
                "POST": "Returns string description.",
                "RETURN": "str - Plugin description."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            },
            {
              "name": "version",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 57,
              "end_line": 65,
              "tags": {
                "PURPOSE": "Returns the version of the search plugin.",
                "PRE": "Plugin instance exists.",
                "POST": "Returns string version.",
                "RETURN": "str - \"1.0.0\""
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            },
            {
              "name": "ui_route",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 68,
              "end_line": 74,
              "tags": {
                "PURPOSE": "Returns the frontend route for the search plugin.",
                "RETURN": "str - \"/tools/search\""
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [
                  {
                    "message": "Missing Mandatory Tag: @PRE (required for STANDARD tier)",
                    "severity": "WARNING",
                    "line_number": 68
                  },
                  {
                    "message": "Missing Mandatory Tag: @POST (required for STANDARD tier)",
                    "severity": "WARNING",
                    "line_number": 68
                  },
                  {
                    "message": "Missing Mandatory Tag: @PRE (required for STANDARD tier)",
                    "severity": "WARNING",
                    "line_number": 68
                  },
                  {
                    "message": "Missing Mandatory Tag: @POST (required for STANDARD tier)",
                    "severity": "WARNING",
                    "line_number": 68
                  },
                  {
                    "message": "Missing Mandatory Tag: @PRE (required for STANDARD tier)",
                    "severity": "WARNING",
                    "line_number": 68
                  },
                  {
                    "message": "Missing Mandatory Tag: @POST (required for STANDARD tier)",
                    "severity": "WARNING",
                    "line_number": 68
                  }
                ],
                "score": 0.26666666666666655
              }
            },
            {
              "name": "get_schema",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 76,
              "end_line": 99,
              "tags": {
                "PURPOSE": "Returns the JSON schema for the search plugin parameters.",
                "PRE": "Plugin instance exists.",
                "POST": "Returns dictionary schema.",
                "RETURN": "Dict[str, Any] - JSON schema."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            },
            {
              "name": "execute",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 101,
              "end_line": 170,
              "tags": {
                "PURPOSE": "Executes the dataset search logic.",
                "PARAM": "params (Dict[str, Any]) - Search parameters.",
                "PRE": "Params contain valid 'env' and 'query'.",
                "POST": "Returns a dictionary with count and results list.",
                "RETURN": "Dict[str, Any] - Search results."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            },
            {
              "name": "_get_context",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 172,
              "end_line": 208,
              "tags": {
                "PURPOSE": "Extracts a small context around the match for display.",
                "PARAM": "context_lines (int) - Number of lines of context to include.",
                "PRE": "text and match_text must be strings.",
                "POST": "Returns context string.",
                "RETURN": "str - Extracted context."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            }
          ],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 16
              },
              {
                "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 16
              }
            ],
            "score": 0.7000000000000001
          }
        }
      ],
      "compliance": {
        "valid": true,
        "issues": [
          {
            "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
            "severity": "WARNING",
            "line_number": 1
          }
        ],
        "score": 0.85
      }
    },
    {
      "name": "MapperPluginModule",
      "type": "Module",
      "tier": "STANDARD",
      "start_line": 1,
      "end_line": 204,
      "tags": {
        "SEMANTICS": "plugin, mapper, datasets, postgresql, excel",
        "PURPOSE": "Implements a plugin for mapping dataset columns using external database connections or Excel files.",
        "LAYER": "Plugins",
        "RELATION": "Inherits from PluginBase. Uses DatasetMapper from superset_tool.",
        "CONSTRAINT": "Must use belief_scope for logging."
      },
      "relations": [],
      "children": [
        {
          "name": "MapperPlugin",
          "type": "Class",
          "tier": "STANDARD",
          "start_line": 18,
          "end_line": 203,
          "tags": {
            "PURPOSE": "Plugin for mapping dataset columns verbose names."
          },
          "relations": [],
          "children": [
            {
              "name": "id",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 26,
              "end_line": 34,
              "tags": {
                "PURPOSE": "Returns the unique identifier for the mapper plugin.",
                "PRE": "Plugin instance exists.",
                "POST": "Returns string ID.",
                "RETURN": "str - \"dataset-mapper\""
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            },
            {
              "name": "name",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 37,
              "end_line": 45,
              "tags": {
                "PURPOSE": "Returns the human-readable name of the mapper plugin.",
                "PRE": "Plugin instance exists.",
                "POST": "Returns string name.",
                "RETURN": "str - Plugin name."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            },
            {
              "name": "description",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 48,
              "end_line": 56,
              "tags": {
                "PURPOSE": "Returns a description of the mapper plugin.",
                "PRE": "Plugin instance exists.",
                "POST": "Returns string description.",
                "RETURN": "str - Plugin description."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            },
            {
              "name": "version",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 59,
              "end_line": 67,
              "tags": {
                "PURPOSE": "Returns the version of the mapper plugin.",
                "PRE": "Plugin instance exists.",
                "POST": "Returns string version.",
                "RETURN": "str - \"1.0.0\""
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            },
            {
              "name": "ui_route",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 70,
              "end_line": 76,
              "tags": {
                "PURPOSE": "Returns the frontend route for the mapper plugin.",
                "RETURN": "str - \"/tools/mapper\""
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [
                  {
                    "message": "Missing Mandatory Tag: @PRE (required for STANDARD tier)",
                    "severity": "WARNING",
                    "line_number": 70
                  },
                  {
                    "message": "Missing Mandatory Tag: @POST (required for STANDARD tier)",
                    "severity": "WARNING",
                    "line_number": 70
                  },
                  {
                    "message": "Missing Mandatory Tag: @PRE (required for STANDARD tier)",
                    "severity": "WARNING",
                    "line_number": 70
                  },
                  {
                    "message": "Missing Mandatory Tag: @POST (required for STANDARD tier)",
                    "severity": "WARNING",
                    "line_number": 70
                  },
                  {
                    "message": "Missing Mandatory Tag: @PRE (required for STANDARD tier)",
                    "severity": "WARNING",
                    "line_number": 70
                  },
                  {
                    "message": "Missing Mandatory Tag: @POST (required for STANDARD tier)",
                    "severity": "WARNING",
                    "line_number": 70
                  }
                ],
                "score": 0.26666666666666655
              }
            },
            {
              "name": "get_schema",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 78,
              "end_line": 128,
              "tags": {
                "PURPOSE": "Returns the JSON schema for the mapper plugin parameters.",
                "PRE": "Plugin instance exists.",
                "POST": "Returns dictionary schema.",
                "RETURN": "Dict[str, Any] - JSON schema."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            },
            {
              "name": "execute",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 130,
              "end_line": 201,
              "tags": {
                "PURPOSE": "Executes the dataset mapping logic.",
                "PARAM": "params (Dict[str, Any]) - Mapping parameters.",
                "PRE": "Params contain valid 'env', 'dataset_id', and 'source'. params must be a dictionary.",
                "POST": "Updates the dataset in Superset.",
                "RETURN": "Dict[str, Any] - Execution status."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            }
          ],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 18
              },
              {
                "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 18
              }
            ],
            "score": 0.7000000000000001
          }
        }
      ],
      "compliance": {
        "valid": true,
        "issues": [
          {
            "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
            "severity": "WARNING",
            "line_number": 1
          }
        ],
        "score": 0.85
      }
    },
    {
      "name": "backend.src.plugins.git_plugin",
      "type": "Module",
      "tier": "STANDARD",
      "start_line": 1,
      "end_line": 385,
      "tags": {
        "SEMANTICS": "git, plugin, dashboard, version_control, sync, deploy",
        "PURPOSE": "\u041f\u0440\u0435\u0434\u043e\u0441\u0442\u0430\u0432\u043b\u044f\u0435\u0442 \u043f\u043b\u0430\u0433\u0438\u043d \u0434\u043b\u044f \u0432\u0435\u0440\u0441\u0438\u043e\u043d\u0438\u0440\u043e\u0432\u0430\u043d\u0438\u044f \u0438 \u0440\u0430\u0437\u0432\u0435\u0440\u0442\u044b\u0432\u0430\u043d\u0438\u044f \u0434\u0430\u0448\u0431\u043e\u0440\u0434\u043e\u0432 Superset.",
        "LAYER": "Plugin",
        "INVARIANT": "\u0412\u0441\u0435 \u043e\u043f\u0435\u0440\u0430\u0446\u0438\u0438 \u0441 Git \u0434\u043e\u043b\u0436\u043d\u044b \u0432\u044b\u043f\u043e\u043b\u043d\u044f\u0442\u044c\u0441\u044f \u0447\u0435\u0440\u0435\u0437 GitService.",
        "CONSTRAINT": "\u041f\u043b\u0430\u0433\u0438\u043d \u0440\u0430\u0431\u043e\u0442\u0430\u0435\u0442 \u0442\u043e\u043b\u044c\u043a\u043e \u0441 \u0440\u0430\u0441\u043f\u0430\u043a\u043e\u0432\u0430\u043d\u043d\u044b\u043c\u0438 YAML-\u044d\u043a\u0441\u043f\u043e\u0440\u0442\u0430\u043c\u0438 Superset."
      },
      "relations": [
        {
          "type": "INHERITS_FROM",
          "target": "src.core.plugin_base.PluginBase"
        },
        {
          "type": "USES",
          "target": "src.services.git_service.GitService"
        },
        {
          "type": "USES",
          "target": "src.core.superset_client.SupersetClient"
        },
        {
          "type": "USES",
          "target": "src.core.config_manager.ConfigManager"
        }
      ],
      "children": [
        {
          "name": "GitPlugin",
          "type": "Class",
          "tier": "STANDARD",
          "start_line": 28,
          "end_line": 384,
          "tags": {
            "PURPOSE": "\u0420\u0435\u0430\u043b\u0438\u0437\u0430\u0446\u0438\u044f \u043f\u043b\u0430\u0433\u0438\u043d\u0430 Git Integration \u0434\u043b\u044f \u0443\u043f\u0440\u0430\u0432\u043b\u0435\u043d\u0438\u044f \u0432\u0435\u0440\u0441\u0438\u044f\u043c\u0438 \u0434\u0430\u0448\u0431\u043e\u0440\u0434\u043e\u0432."
          },
          "relations": [],
          "children": [
            {
              "name": "__init__",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 32,
              "end_line": 60,
              "tags": {
                "PURPOSE": "\u0418\u043d\u0438\u0446\u0438\u0430\u043b\u0438\u0437\u0438\u0440\u0443\u0435\u0442 \u043f\u043b\u0430\u0433\u0438\u043d \u0438 \u0435\u0433\u043e \u0437\u0430\u0432\u0438\u0441\u0438\u043c\u043e\u0441\u0442\u0438.",
                "PRE": "config.json exists or shared config_manager is available.",
                "POST": "\u0418\u043d\u0438\u0446\u0438\u0430\u043b\u0438\u0437\u0438\u0440\u043e\u0432\u0430\u043d\u044b git_service \u0438 config_manager."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            },
            {
              "name": "id",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 63,
              "end_line": 70,
              "tags": {
                "PURPOSE": "Returns the plugin identifier.",
                "PRE": "GitPlugin is initialized.",
                "POST": "Returns 'git-integration'."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            },
            {
              "name": "name",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 73,
              "end_line": 80,
              "tags": {
                "PURPOSE": "Returns the plugin name.",
                "PRE": "GitPlugin is initialized.",
                "POST": "Returns the human-readable name."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            },
            {
              "name": "description",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 83,
              "end_line": 90,
              "tags": {
                "PURPOSE": "Returns the plugin description.",
                "PRE": "GitPlugin is initialized.",
                "POST": "Returns the plugin's purpose description."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            },
            {
              "name": "version",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 93,
              "end_line": 100,
              "tags": {
                "PURPOSE": "Returns the plugin version.",
                "PRE": "GitPlugin is initialized.",
                "POST": "Returns the version string."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            },
            {
              "name": "ui_route",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 103,
              "end_line": 109,
              "tags": {
                "PURPOSE": "Returns the frontend route for the git plugin.",
                "RETURN": "str - \"/git\""
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [
                  {
                    "message": "Missing Mandatory Tag: @PRE (required for STANDARD tier)",
                    "severity": "WARNING",
                    "line_number": 103
                  },
                  {
                    "message": "Missing Mandatory Tag: @POST (required for STANDARD tier)",
                    "severity": "WARNING",
                    "line_number": 103
                  },
                  {
                    "message": "Missing Mandatory Tag: @PRE (required for STANDARD tier)",
                    "severity": "WARNING",
                    "line_number": 103
                  },
                  {
                    "message": "Missing Mandatory Tag: @POST (required for STANDARD tier)",
                    "severity": "WARNING",
                    "line_number": 103
                  },
                  {
                    "message": "Missing Mandatory Tag: @PRE (required for STANDARD tier)",
                    "severity": "WARNING",
                    "line_number": 103
                  },
                  {
                    "message": "Missing Mandatory Tag: @POST (required for STANDARD tier)",
                    "severity": "WARNING",
                    "line_number": 103
                  }
                ],
                "score": 0.26666666666666655
              }
            },
            {
              "name": "get_schema",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 111,
              "end_line": 128,
              "tags": {
                "PURPOSE": "\u0412\u043e\u0437\u0432\u0440\u0430\u0449\u0430\u0435\u0442 JSON-\u0441\u0445\u0435\u043c\u0443 \u043f\u0430\u0440\u0430\u043c\u0435\u0442\u0440\u043e\u0432 \u0434\u043b\u044f \u0432\u044b\u043f\u043e\u043b\u043d\u0435\u043d\u0438\u044f \u0437\u0430\u0434\u0430\u0447 \u043f\u043b\u0430\u0433\u0438\u043d\u0430.",
                "PRE": "GitPlugin is initialized.",
                "POST": "Returns a JSON schema dictionary.",
                "RETURN": "Dict[str, Any] - \u0421\u0445\u0435\u043c\u0430 \u043f\u0430\u0440\u0430\u043c\u0435\u0442\u0440\u043e\u0432."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            },
            {
              "name": "initialize",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 130,
              "end_line": 383,
              "tags": {
                "PURPOSE": "\u0412\u044b\u043f\u043e\u043b\u043d\u044f\u0435\u0442 \u043d\u0430\u0447\u0430\u043b\u044c\u043d\u0443\u044e \u043d\u0430\u0441\u0442\u0440\u043e\u0439\u043a\u0443 \u043f\u043b\u0430\u0433\u0438\u043d\u0430.",
                "PRE": "GitPlugin is initialized.",
                "POST": "\u041f\u043b\u0430\u0433\u0438\u043d \u0433\u043e\u0442\u043e\u0432 \u043a \u0432\u044b\u043f\u043e\u043b\u043d\u0435\u043d\u0438\u044e \u0437\u0430\u0434\u0430\u0447."
              },
              "relations": [],
              "children": [
                {
                  "name": "execute",
                  "type": "Function",
                  "tier": "STANDARD",
                  "start_line": 138,
                  "end_line": 167,
                  "tags": {
                    "PURPOSE": "\u041e\u0441\u043d\u043e\u0432\u043d\u043e\u0439 \u043c\u0435\u0442\u043e\u0434 \u0432\u044b\u043f\u043e\u043b\u043d\u0435\u043d\u0438\u044f \u0437\u0430\u0434\u0430\u0447 \u043f\u043b\u0430\u0433\u0438\u043d\u0430.",
                    "PRE": "task_data \u0441\u043e\u0434\u0435\u0440\u0436\u0438\u0442 'operation' \u0438 'dashboard_id'.",
                    "POST": "\u0412\u043e\u0437\u0432\u0440\u0430\u0449\u0430\u0435\u0442 \u0440\u0435\u0437\u0443\u043b\u044c\u0442\u0430\u0442 \u0432\u044b\u043f\u043e\u043b\u043d\u0435\u043d\u0438\u044f \u043e\u043f\u0435\u0440\u0430\u0446\u0438\u0438.",
                    "PARAM": "task_data (Dict[str, Any]) - \u0414\u0430\u043d\u043d\u044b\u0435 \u0437\u0430\u0434\u0430\u0447\u0438.",
                    "RETURN": "Dict[str, Any] - \u0421\u0442\u0430\u0442\u0443\u0441 \u0438 \u0441\u043e\u043e\u0431\u0449\u0435\u043d\u0438\u0435."
                  },
                  "relations": [
                    {
                      "type": "CALLS",
                      "target": "self._handle_sync"
                    },
                    {
                      "type": "CALLS",
                      "target": "self._handle_deploy"
                    }
                  ],
                  "children": [],
                  "compliance": {
                    "valid": true,
                    "issues": [],
                    "score": 1.0
                  }
                },
                {
                  "name": "_handle_sync",
                  "type": "Function",
                  "tier": "STANDARD",
                  "start_line": 169,
                  "end_line": 249,
                  "tags": {
                    "PURPOSE": "\u042d\u043a\u0441\u043f\u043e\u0440\u0442\u0438\u0440\u0443\u0435\u0442 \u0434\u0430\u0448\u0431\u043e\u0440\u0434 \u0438\u0437 Superset \u0438 \u0440\u0430\u0441\u043f\u0430\u043a\u043e\u0432\u044b\u0432\u0430\u0435\u0442 \u0432 Git-\u0440\u0435\u043f\u043e\u0437\u0438\u0442\u043e\u0440\u0438\u0439.",
                    "PRE": "\u0420\u0435\u043f\u043e\u0437\u0438\u0442\u043e\u0440\u0438\u0439 \u0434\u043b\u044f \u0434\u0430\u0448\u0431\u043e\u0440\u0434\u0430 \u0434\u043e\u043b\u0436\u0435\u043d \u0441\u0443\u0449\u0435\u0441\u0442\u0432\u043e\u0432\u0430\u0442\u044c.",
                    "POST": "\u0424\u0430\u0439\u043b\u044b \u0432 \u0440\u0435\u043f\u043e\u0437\u0438\u0442\u043e\u0440\u0438\u0438 \u043e\u0431\u043d\u043e\u0432\u043b\u0435\u043d\u044b \u0434\u043e \u0442\u0435\u043a\u0443\u0449\u0435\u0433\u043e \u0441\u043e\u0441\u0442\u043e\u044f\u043d\u0438\u044f \u0432 Superset.",
                    "PARAM": "source_env_id (Optional[str]) - ID \u0438\u0441\u0445\u043e\u0434\u043d\u043e\u0433\u043e \u043e\u043a\u0440\u0443\u0436\u0435\u043d\u0438\u044f.",
                    "RETURN": "Dict[str, str] - \u0420\u0435\u0437\u0443\u043b\u044c\u0442\u0430\u0442 \u0441\u0438\u043d\u0445\u0440\u043e\u043d\u0438\u0437\u0430\u0446\u0438\u0438.",
                    "SIDE_EFFECT": "\u0418\u0437\u043c\u0435\u043d\u044f\u0435\u0442 \u0444\u0430\u0439\u043b\u044b \u0432 \u043b\u043e\u043a\u0430\u043b\u044c\u043d\u043e\u0439 \u0440\u0430\u0431\u043e\u0447\u0435\u0439 \u0434\u0438\u0440\u0435\u043a\u0442\u043e\u0440\u0438\u0438 \u0440\u0435\u043f\u043e\u0437\u0438\u0442\u043e\u0440\u0438\u044f."
                  },
                  "relations": [
                    {
                      "type": "CALLS",
                      "target": "src.services.git_service.GitService.get_repo"
                    },
                    {
                      "type": "CALLS",
                      "target": "src.core.superset_client.SupersetClient.export_dashboard"
                    }
                  ],
                  "children": [],
                  "compliance": {
                    "valid": true,
                    "issues": [],
                    "score": 1.0
                  }
                },
                {
                  "name": "_handle_deploy",
                  "type": "Function",
                  "tier": "STANDARD",
                  "start_line": 251,
                  "end_line": 316,
                  "tags": {
                    "PURPOSE": "\u0423\u043f\u0430\u043a\u043e\u0432\u044b\u0432\u0430\u0435\u0442 \u0440\u0435\u043f\u043e\u0437\u0438\u0442\u043e\u0440\u0438\u0439 \u0432 ZIP \u0438 \u0438\u043c\u043f\u043e\u0440\u0442\u0438\u0440\u0443\u0435\u0442 \u0432 \u0446\u0435\u043b\u0435\u0432\u043e\u0435 \u043e\u043a\u0440\u0443\u0436\u0435\u043d\u0438\u0435 Superset.",
                    "PRE": "environment_id \u0434\u043e\u043b\u0436\u0435\u043d \u0441\u043e\u043e\u0442\u0432\u0435\u0442\u0441\u0442\u0432\u043e\u0432\u0430\u0442\u044c \u043d\u0430\u0441\u0442\u0440\u043e\u0435\u043d\u043d\u043e\u043c\u0443 \u043e\u043a\u0440\u0443\u0436\u0435\u043d\u0438\u044e.",
                    "POST": "\u0414\u0430\u0448\u0431\u043e\u0440\u0434 \u0438\u043c\u043f\u043e\u0440\u0442\u0438\u0440\u043e\u0432\u0430\u043d \u0432 \u0446\u0435\u043b\u0435\u0432\u043e\u0439 Superset.",
                    "PARAM": "env_id (str) - ID \u0446\u0435\u043b\u0435\u0432\u043e\u0433\u043e \u043e\u043a\u0440\u0443\u0436\u0435\u043d\u0438\u044f.",
                    "RETURN": "Dict[str, Any] - \u0420\u0435\u0437\u0443\u043b\u044c\u0442\u0430\u0442 \u0434\u0435\u043f\u043b\u043e\u044f.",
                    "SIDE_EFFECT": "\u0421\u043e\u0437\u0434\u0430\u0435\u0442 \u0438 \u0443\u0434\u0430\u043b\u044f\u0435\u0442 \u0432\u0440\u0435\u043c\u0435\u043d\u043d\u044b\u0439 ZIP-\u0444\u0430\u0439\u043b."
                  },
                  "relations": [
                    {
                      "type": "CALLS",
                      "target": "src.core.superset_client.SupersetClient.import_dashboard"
                    }
                  ],
                  "children": [],
                  "compliance": {
                    "valid": true,
                    "issues": [],
                    "score": 1.0
                  }
                },
                {
                  "name": "_get_env",
                  "type": "Function",
                  "tier": "STANDARD",
                  "start_line": 318,
                  "end_line": 381,
                  "tags": {
                    "PURPOSE": "\u0412\u0441\u043f\u043e\u043c\u043e\u0433\u0430\u0442\u0435\u043b\u044c\u043d\u044b\u0439 \u043c\u0435\u0442\u043e\u0434 \u0434\u043b\u044f \u043f\u043e\u043b\u0443\u0447\u0435\u043d\u0438\u044f \u043a\u043e\u043d\u0444\u0438\u0433\u0443\u0440\u0430\u0446\u0438\u0438 \u043e\u043a\u0440\u0443\u0436\u0435\u043d\u0438\u044f.",
                    "PARAM": "env_id (Optional[str]) - ID \u043e\u043a\u0440\u0443\u0436\u0435\u043d\u0438\u044f.",
                    "PRE": "env_id is a string or None.",
                    "POST": "Returns an Environment object from config or DB.",
                    "RETURN": "Environment - \u041e\u0431\u044a\u0435\u043a\u0442 \u043a\u043e\u043d\u0444\u0438\u0433\u0443\u0440\u0430\u0446\u0438\u0438 \u043e\u043a\u0440\u0443\u0436\u0435\u043d\u0438\u044f."
                  },
                  "relations": [],
                  "children": [],
                  "compliance": {
                    "valid": true,
                    "issues": [],
                    "score": 1.0
                  }
                }
              ],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            }
          ],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 28
              },
              {
                "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 28
              }
            ],
            "score": 0.7000000000000001
          }
        }
      ],
      "compliance": {
        "valid": true,
        "issues": [
          {
            "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
            "severity": "WARNING",
            "line_number": 1
          }
        ],
        "score": 0.85
      }
    },
    {
      "name": "MigrationPlugin",
      "type": "Module",
      "tier": "STANDARD",
      "start_line": 1,
      "end_line": 396,
      "tags": {
        "SEMANTICS": "migration, superset, automation, dashboard, plugin",
        "PURPOSE": "A plugin that provides functionality to migrate Superset dashboards between environments.",
        "LAYER": "App"
      },
      "relations": [
        {
          "type": "IMPLEMENTS",
          "target": "PluginBase"
        },
        {
          "type": "DEPENDS_ON",
          "target": "superset_tool.client"
        },
        {
          "type": "DEPENDS_ON",
          "target": "superset_tool.utils"
        }
      ],
      "children": [
        {
          "name": "MigrationPlugin",
          "type": "Class",
          "tier": "STANDARD",
          "start_line": 23,
          "end_line": 395,
          "tags": {
            "PURPOSE": "Implementation of the migration plugin logic."
          },
          "relations": [],
          "children": [
            {
              "name": "id",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 31,
              "end_line": 39,
              "tags": {
                "PURPOSE": "Returns the unique identifier for the migration plugin.",
                "PRE": "None.",
                "POST": "Returns \"superset-migration\".",
                "RETURN": "str - \"superset-migration\""
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            },
            {
              "name": "name",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 42,
              "end_line": 50,
              "tags": {
                "PURPOSE": "Returns the human-readable name of the migration plugin.",
                "PRE": "None.",
                "POST": "Returns the plugin name.",
                "RETURN": "str - Plugin name."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            },
            {
              "name": "description",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 53,
              "end_line": 61,
              "tags": {
                "PURPOSE": "Returns a description of the migration plugin.",
                "PRE": "None.",
                "POST": "Returns the plugin description.",
                "RETURN": "str - Plugin description."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            },
            {
              "name": "version",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 64,
              "end_line": 72,
              "tags": {
                "PURPOSE": "Returns the version of the migration plugin.",
                "PRE": "None.",
                "POST": "Returns \"1.0.0\".",
                "RETURN": "str - \"1.0.0\""
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            },
            {
              "name": "ui_route",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 75,
              "end_line": 81,
              "tags": {
                "PURPOSE": "Returns the frontend route for the migration plugin.",
                "RETURN": "str - \"/migration\""
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [
                  {
                    "message": "Missing Mandatory Tag: @PRE (required for STANDARD tier)",
                    "severity": "WARNING",
                    "line_number": 75
                  },
                  {
                    "message": "Missing Mandatory Tag: @POST (required for STANDARD tier)",
                    "severity": "WARNING",
                    "line_number": 75
                  },
                  {
                    "message": "Missing Mandatory Tag: @PRE (required for STANDARD tier)",
                    "severity": "WARNING",
                    "line_number": 75
                  },
                  {
                    "message": "Missing Mandatory Tag: @POST (required for STANDARD tier)",
                    "severity": "WARNING",
                    "line_number": 75
                  },
                  {
                    "message": "Missing Mandatory Tag: @PRE (required for STANDARD tier)",
                    "severity": "WARNING",
                    "line_number": 75
                  },
                  {
                    "message": "Missing Mandatory Tag: @POST (required for STANDARD tier)",
                    "severity": "WARNING",
                    "line_number": 75
                  }
                ],
                "score": 0.26666666666666655
              }
            },
            {
              "name": "get_schema",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 83,
              "end_line": 132,
              "tags": {
                "PURPOSE": "Returns the JSON schema for migration plugin parameters.",
                "PRE": "Config manager is available.",
                "POST": "Returns a valid JSON schema dictionary.",
                "RETURN": "Dict[str, Any] - JSON schema."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            },
            {
              "name": "execute",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 134,
              "end_line": 394,
              "tags": {
                "PURPOSE": "Executes the dashboard migration logic.",
                "PARAM": "params (Dict[str, Any]) - Migration parameters.",
                "PRE": "Source and target environments must be configured.",
                "POST": "Selected dashboards are migrated."
              },
              "relations": [],
              "children": [
                {
                  "name": "MigrationPlugin.execute",
                  "type": "Action",
                  "tier": "STANDARD",
                  "start_line": 154,
                  "end_line": 393,
                  "tags": {
                    "PURPOSE": "Execute the migration logic with proper task logging."
                  },
                  "relations": [],
                  "children": [
                    {
                      "name": "__init__",
                      "type": "Function",
                      "tier": "STANDARD",
                      "start_line": 161,
                      "end_line": 169,
                      "tags": {
                        "PURPOSE": "Initializes the proxy logger.",
                        "PRE": "None.",
                        "POST": "Instance is initialized."
                      },
                      "relations": [],
                      "children": [],
                      "compliance": {
                        "valid": true,
                        "issues": [],
                        "score": 1.0
                      }
                    },
                    {
                      "name": "debug",
                      "type": "Function",
                      "tier": "STANDARD",
                      "start_line": 171,
                      "end_line": 178,
                      "tags": {
                        "PURPOSE": "Logs a debug message to the task manager.",
                        "PRE": "msg is a string.",
                        "POST": "Log is added to task manager if task_id exists."
                      },
                      "relations": [],
                      "children": [],
                      "compliance": {
                        "valid": true,
                        "issues": [],
                        "score": 1.0
                      }
                    },
                    {
                      "name": "info",
                      "type": "Function",
                      "tier": "STANDARD",
                      "start_line": 180,
                      "end_line": 187,
                      "tags": {
                        "PURPOSE": "Logs an info message to the task manager.",
                        "PRE": "msg is a string.",
                        "POST": "Log is added to task manager if task_id exists."
                      },
                      "relations": [],
                      "children": [],
                      "compliance": {
                        "valid": true,
                        "issues": [],
                        "score": 1.0
                      }
                    },
                    {
                      "name": "warning",
                      "type": "Function",
                      "tier": "STANDARD",
                      "start_line": 189,
                      "end_line": 196,
                      "tags": {
                        "PURPOSE": "Logs a warning message to the task manager.",
                        "PRE": "msg is a string.",
                        "POST": "Log is added to task manager if task_id exists."
                      },
                      "relations": [],
                      "children": [],
                      "compliance": {
                        "valid": true,
                        "issues": [],
                        "score": 1.0
                      }
                    },
                    {
                      "name": "error",
                      "type": "Function",
                      "tier": "STANDARD",
                      "start_line": 198,
                      "end_line": 205,
                      "tags": {
                        "PURPOSE": "Logs an error message to the task manager.",
                        "PRE": "msg is a string.",
                        "POST": "Log is added to task manager if task_id exists."
                      },
                      "relations": [],
                      "children": [],
                      "compliance": {
                        "valid": true,
                        "issues": [],
                        "score": 1.0
                      }
                    },
                    {
                      "name": "critical",
                      "type": "Function",
                      "tier": "STANDARD",
                      "start_line": 207,
                      "end_line": 214,
                      "tags": {
                        "PURPOSE": "Logs a critical message to the task manager.",
                        "PRE": "msg is a string.",
                        "POST": "Log is added to task manager if task_id exists."
                      },
                      "relations": [],
                      "children": [],
                      "compliance": {
                        "valid": true,
                        "issues": [],
                        "score": 1.0
                      }
                    },
                    {
                      "name": "exception",
                      "type": "Function",
                      "tier": "STANDARD",
                      "start_line": 216,
                      "end_line": 223,
                      "tags": {
                        "PURPOSE": "Logs an exception message to the task manager.",
                        "PRE": "msg is a string.",
                        "POST": "Log is added to task manager if task_id exists."
                      },
                      "relations": [],
                      "children": [],
                      "compliance": {
                        "valid": true,
                        "issues": [],
                        "score": 1.0
                      }
                    }
                  ],
                  "compliance": {
                    "valid": true,
                    "issues": [],
                    "score": 1.0
                  }
                }
              ],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            }
          ],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 23
              },
              {
                "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 23
              }
            ],
            "score": 0.7000000000000001
          }
        }
      ],
      "compliance": {
        "valid": true,
        "issues": [
          {
            "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
            "severity": "WARNING",
            "line_number": 1
          }
        ],
        "score": 0.85
      }
    },
    {
      "name": "schedule_dashboard_validation",
      "type": "Function",
      "tier": "STANDARD",
      "start_line": 12,
      "end_line": 54,
      "tags": {
        "PURPOSE": "Schedules a recurring dashboard validation task.",
        "PARAM": "params (Dict[str, Any]) - Task parameters (environment_id, provider_id)."
      },
      "relations": [],
      "children": [],
      "compliance": {
        "valid": true,
        "issues": [
          {
            "message": "Missing Mandatory Tag: @PRE (required for STANDARD tier)",
            "severity": "WARNING",
            "line_number": 12
          },
          {
            "message": "Missing Mandatory Tag: @POST (required for STANDARD tier)",
            "severity": "WARNING",
            "line_number": 12
          }
        ],
        "score": 0.6666666666666667
      }
    },
    {
      "name": "scheduler",
      "type": "Module",
      "tier": "TRIVIAL",
      "start_line": 1,
      "end_line": 56,
      "tags": {
        "PURPOSE": "Auto-generated module for backend/src/plugins/llm_analysis/scheduler.py",
        "TIER": "TRIVIAL",
        "LAYER": "Unknown"
      },
      "relations": [],
      "children": [
        {
          "name": "job_func",
          "type": "Function",
          "tier": "TRIVIAL",
          "start_line": 24,
          "end_line": 24,
          "tags": {
            "PURPOSE": "Auto-detected function (orphan)",
            "TIER": "TRIVIAL"
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "_parse_cron",
          "type": "Function",
          "tier": "TRIVIAL",
          "start_line": 42,
          "end_line": 42,
          "tags": {
            "PURPOSE": "Auto-detected function (orphan)",
            "TIER": "TRIVIAL"
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        }
      ],
      "compliance": {
        "valid": true,
        "issues": [],
        "score": 1.0
      }
    },
    {
      "name": "LLMProviderType",
      "type": "Class",
      "tier": "STANDARD",
      "start_line": 12,
      "end_line": 18,
      "tags": {
        "PURPOSE": "Enum for supported LLM providers."
      },
      "relations": [],
      "children": [],
      "compliance": {
        "valid": true,
        "issues": [
          {
            "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
            "severity": "WARNING",
            "line_number": 12
          }
        ],
        "score": 0.8
      }
    },
    {
      "name": "LLMProviderConfig",
      "type": "Class",
      "tier": "STANDARD",
      "start_line": 20,
      "end_line": 30,
      "tags": {
        "PURPOSE": "Configuration for an LLM provider."
      },
      "relations": [],
      "children": [],
      "compliance": {
        "valid": true,
        "issues": [
          {
            "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
            "severity": "WARNING",
            "line_number": 20
          }
        ],
        "score": 0.8
      }
    },
    {
      "name": "ValidationStatus",
      "type": "Class",
      "tier": "STANDARD",
      "start_line": 32,
      "end_line": 38,
      "tags": {
        "PURPOSE": "Enum for dashboard validation status."
      },
      "relations": [],
      "children": [],
      "compliance": {
        "valid": true,
        "issues": [
          {
            "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
            "severity": "WARNING",
            "line_number": 32
          }
        ],
        "score": 0.8
      }
    },
    {
      "name": "DetectedIssue",
      "type": "Class",
      "tier": "STANDARD",
      "start_line": 40,
      "end_line": 46,
      "tags": {
        "PURPOSE": "Model for a single issue detected during validation."
      },
      "relations": [],
      "children": [],
      "compliance": {
        "valid": true,
        "issues": [
          {
            "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
            "severity": "WARNING",
            "line_number": 40
          }
        ],
        "score": 0.8
      }
    },
    {
      "name": "ValidationResult",
      "type": "Class",
      "tier": "STANDARD",
      "start_line": 48,
      "end_line": 59,
      "tags": {
        "PURPOSE": "Model for dashboard validation result."
      },
      "relations": [],
      "children": [],
      "compliance": {
        "valid": true,
        "issues": [
          {
            "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
            "severity": "WARNING",
            "line_number": 48
          }
        ],
        "score": 0.8
      }
    },
    {
      "name": "backend.src.plugins.llm_analysis.plugin",
      "type": "Module",
      "tier": "STANDARD",
      "start_line": 1,
      "end_line": 266,
      "tags": {
        "TIER": "STANDARD",
        "SEMANTICS": "plugin, llm, analysis, documentation",
        "PURPOSE": "Implements DashboardValidationPlugin and DocumentationPlugin.",
        "LAYER": "Domain"
      },
      "relations": [
        {
          "type": "INHERITS_FROM",
          "target": "backend.src.core.plugin_base.PluginBase"
        }
      ],
      "children": [
        {
          "name": "DashboardValidationPlugin",
          "type": "Class",
          "tier": "STANDARD",
          "start_line": 20,
          "end_line": 137,
          "tags": {
            "PURPOSE": "Plugin for automated dashboard health analysis using LLMs."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 20
              },
              {
                "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 20
              }
            ],
            "score": 0.7000000000000001
          }
        },
        {
          "name": "DocumentationPlugin",
          "type": "Class",
          "tier": "STANDARD",
          "start_line": 139,
          "end_line": 264,
          "tags": {
            "PURPOSE": "Plugin for automated dataset documentation using LLMs."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 139
              },
              {
                "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 139
              }
            ],
            "score": 0.7000000000000001
          }
        },
        {
          "name": "id",
          "type": "Function",
          "tier": "TRIVIAL",
          "start_line": 24,
          "end_line": 24,
          "tags": {
            "PURPOSE": "Auto-detected function (orphan)",
            "TIER": "TRIVIAL"
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "name",
          "type": "Function",
          "tier": "TRIVIAL",
          "start_line": 28,
          "end_line": 28,
          "tags": {
            "PURPOSE": "Auto-detected function (orphan)",
            "TIER": "TRIVIAL"
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "description",
          "type": "Function",
          "tier": "TRIVIAL",
          "start_line": 32,
          "end_line": 32,
          "tags": {
            "PURPOSE": "Auto-detected function (orphan)",
            "TIER": "TRIVIAL"
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "version",
          "type": "Function",
          "tier": "TRIVIAL",
          "start_line": 36,
          "end_line": 36,
          "tags": {
            "PURPOSE": "Auto-detected function (orphan)",
            "TIER": "TRIVIAL"
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "get_schema",
          "type": "Function",
          "tier": "TRIVIAL",
          "start_line": 39,
          "end_line": 39,
          "tags": {
            "PURPOSE": "Auto-detected function (orphan)",
            "TIER": "TRIVIAL"
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "execute",
          "type": "Function",
          "tier": "TRIVIAL",
          "start_line": 50,
          "end_line": 50,
          "tags": {
            "PURPOSE": "Auto-detected function (orphan)",
            "TIER": "TRIVIAL"
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "id",
          "type": "Function",
          "tier": "TRIVIAL",
          "start_line": 143,
          "end_line": 143,
          "tags": {
            "PURPOSE": "Auto-detected function (orphan)",
            "TIER": "TRIVIAL"
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "name",
          "type": "Function",
          "tier": "TRIVIAL",
          "start_line": 147,
          "end_line": 147,
          "tags": {
            "PURPOSE": "Auto-detected function (orphan)",
            "TIER": "TRIVIAL"
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "description",
          "type": "Function",
          "tier": "TRIVIAL",
          "start_line": 151,
          "end_line": 151,
          "tags": {
            "PURPOSE": "Auto-detected function (orphan)",
            "TIER": "TRIVIAL"
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "version",
          "type": "Function",
          "tier": "TRIVIAL",
          "start_line": 155,
          "end_line": 155,
          "tags": {
            "PURPOSE": "Auto-detected function (orphan)",
            "TIER": "TRIVIAL"
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "get_schema",
          "type": "Function",
          "tier": "TRIVIAL",
          "start_line": 158,
          "end_line": 158,
          "tags": {
            "PURPOSE": "Auto-detected function (orphan)",
            "TIER": "TRIVIAL"
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "execute",
          "type": "Function",
          "tier": "TRIVIAL",
          "start_line": 169,
          "end_line": 169,
          "tags": {
            "PURPOSE": "Auto-detected function (orphan)",
            "TIER": "TRIVIAL"
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        }
      ],
      "compliance": {
        "valid": true,
        "issues": [],
        "score": 1.0
      }
    },
    {
      "name": "backend.src.plugins.llm_analysis.service",
      "type": "Module",
      "tier": "STANDARD",
      "start_line": 1,
      "end_line": null,
      "tags": {
        "TIER": "STANDARD",
        "SEMANTICS": "service, llm, screenshot, playwright, openai",
        "PURPOSE": "Services for LLM interaction and dashboard screenshots.",
        "LAYER": "Domain"
      },
      "relations": [
        {
          "type": "DEPENDS_ON",
          "target": "playwright"
        },
        {
          "type": "DEPENDS_ON",
          "target": "openai"
        },
        {
          "type": "DEPENDS_ON",
          "target": "tenacity"
        }
      ],
      "children": [
        {
          "name": "ScreenshotService",
          "type": "Class",
          "tier": "STANDARD",
          "start_line": 19,
          "end_line": null,
          "tags": {
            "PURPOSE": "Handles capturing screenshots of Superset dashboards.",
            "PRE": "env is a valid Environment object."
          },
          "relations": [],
          "children": [
            {
              "name": "capture_dashboard",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 26,
              "end_line": null,
              "tags": {
                "PURPOSE": "Captures a screenshot of a dashboard using Playwright.",
                "PARAM": "output_path (str) - Path to save the screenshot.",
                "RETURN": "bool - True if successful."
              },
              "relations": [],
              "children": [
                {
                  "name": "LLMClient",
                  "type": "Class",
                  "tier": "STANDARD",
                  "start_line": 136,
                  "end_line": null,
                  "tags": {
                    "PURPOSE": "Wrapper for LLM provider APIs."
                  },
                  "relations": [],
                  "children": [
                    {
                      "name": "get_json_completion",
                      "type": "Function",
                      "tier": "STANDARD",
                      "start_line": 146,
                      "end_line": null,
                      "tags": {
                        "PURPOSE": "Helper to handle LLM calls with JSON mode and fallback parsing.",
                        "PARAM": "messages (List[Dict]) - List of messages for the completion.",
                        "RETURN": "Dict[str, Any] - Parsed JSON response."
                      },
                      "relations": [],
                      "children": [
                        {
                          "name": "analyze_dashboard",
                          "type": "Function",
                          "tier": "STANDARD",
                          "start_line": 205,
                          "end_line": 258,
                          "tags": {
                            "PURPOSE": "Sends dashboard data to LLM for analysis."
                          },
                          "relations": [],
                          "children": [],
                          "compliance": {
                            "valid": true,
                            "issues": [
                              {
                                "message": "Missing Mandatory Tag: @PRE (required for STANDARD tier)",
                                "severity": "WARNING",
                                "line_number": 205
                              },
                              {
                                "message": "Missing Mandatory Tag: @POST (required for STANDARD tier)",
                                "severity": "WARNING",
                                "line_number": 205
                              },
                              {
                                "message": "Missing Mandatory Tag: @PRE (required for STANDARD tier)",
                                "severity": "WARNING",
                                "line_number": 205
                              },
                              {
                                "message": "Missing Mandatory Tag: @POST (required for STANDARD tier)",
                                "severity": "WARNING",
                                "line_number": 205
                              },
                              {
                                "message": "Missing Mandatory Tag: @PRE (required for STANDARD tier)",
                                "severity": "WARNING",
                                "line_number": 205
                              },
                              {
                                "message": "Missing Mandatory Tag: @POST (required for STANDARD tier)",
                                "severity": "WARNING",
                                "line_number": 205
                              },
                              {
                                "message": "Missing Mandatory Tag: @PRE (required for STANDARD tier)",
                                "severity": "WARNING",
                                "line_number": 205
                              },
                              {
                                "message": "Missing Mandatory Tag: @POST (required for STANDARD tier)",
                                "severity": "WARNING",
                                "line_number": 205
                              },
                              {
                                "message": "Missing Mandatory Tag: @PRE (required for STANDARD tier)",
                                "severity": "WARNING",
                                "line_number": 205
                              },
                              {
                                "message": "Missing Mandatory Tag: @POST (required for STANDARD tier)",
                                "severity": "WARNING",
                                "line_number": 205
                              },
                              {
                                "message": "Missing Mandatory Tag: @PRE (required for STANDARD tier)",
                                "severity": "WARNING",
                                "line_number": 205
                              },
                              {
                                "message": "Missing Mandatory Tag: @POST (required for STANDARD tier)",
                                "severity": "WARNING",
                                "line_number": 205
                              }
                            ],
                            "score": 0.0
                          }
                        }
                      ],
                      "compliance": {
                        "valid": false,
                        "issues": [
                          {
                            "message": "Unclosed Anchor: [DEF:get_json_completion:Function] started at line 146",
                            "severity": "ERROR",
                            "line_number": 146
                          },
                          {
                            "message": "Missing Mandatory Tag: @PRE (required for STANDARD tier)",
                            "severity": "WARNING",
                            "line_number": 146
                          },
                          {
                            "message": "Missing Mandatory Tag: @POST (required for STANDARD tier)",
                            "severity": "WARNING",
                            "line_number": 146
                          },
                          {
                            "message": "Unclosed Anchor: [DEF:get_json_completion:Function] started at line 146",
                            "severity": "ERROR",
                            "line_number": 146
                          },
                          {
                            "message": "Missing Mandatory Tag: @PRE (required for STANDARD tier)",
                            "severity": "WARNING",
                            "line_number": 146
                          },
                          {
                            "message": "Missing Mandatory Tag: @POST (required for STANDARD tier)",
                            "severity": "WARNING",
                            "line_number": 146
                          },
                          {
                            "message": "Unclosed Anchor: [DEF:get_json_completion:Function] started at line 146",
                            "severity": "ERROR",
                            "line_number": 146
                          },
                          {
                            "message": "Missing Mandatory Tag: @PRE (required for STANDARD tier)",
                            "severity": "WARNING",
                            "line_number": 146
                          },
                          {
                            "message": "Missing Mandatory Tag: @POST (required for STANDARD tier)",
                            "severity": "WARNING",
                            "line_number": 146
                          },
                          {
                            "message": "Unclosed Anchor: [DEF:get_json_completion:Function] started at line 146",
                            "severity": "ERROR",
                            "line_number": 146
                          },
                          {
                            "message": "Missing Mandatory Tag: @PRE (required for STANDARD tier)",
                            "severity": "WARNING",
                            "line_number": 146
                          },
                          {
                            "message": "Missing Mandatory Tag: @POST (required for STANDARD tier)",
                            "severity": "WARNING",
                            "line_number": 146
                          },
                          {
                            "message": "Unclosed Anchor: [DEF:get_json_completion:Function] started at line 146",
                            "severity": "ERROR",
                            "line_number": 146
                          },
                          {
                            "message": "Missing Mandatory Tag: @PRE (required for STANDARD tier)",
                            "severity": "WARNING",
                            "line_number": 146
                          },
                          {
                            "message": "Missing Mandatory Tag: @POST (required for STANDARD tier)",
                            "severity": "WARNING",
                            "line_number": 146
                          }
                        ],
                        "score": 0.0
                      }
                    }
                  ],
                  "compliance": {
                    "valid": false,
                    "issues": [
                      {
                        "message": "Unclosed Anchor: [DEF:LLMClient:Class] started at line 136",
                        "severity": "ERROR",
                        "line_number": 136
                      },
                      {
                        "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
                        "severity": "WARNING",
                        "line_number": 136
                      },
                      {
                        "message": "Unclosed Anchor: [DEF:LLMClient:Class] started at line 136",
                        "severity": "ERROR",
                        "line_number": 136
                      },
                      {
                        "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
                        "severity": "WARNING",
                        "line_number": 136
                      },
                      {
                        "message": "Unclosed Anchor: [DEF:LLMClient:Class] started at line 136",
                        "severity": "ERROR",
                        "line_number": 136
                      },
                      {
                        "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
                        "severity": "WARNING",
                        "line_number": 136
                      },
                      {
                        "message": "Unclosed Anchor: [DEF:LLMClient:Class] started at line 136",
                        "severity": "ERROR",
                        "line_number": 136
                      },
                      {
                        "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
                        "severity": "WARNING",
                        "line_number": 136
                      }
                    ],
                    "score": 0.0
                  }
                }
              ],
              "compliance": {
                "valid": false,
                "issues": [
                  {
                    "message": "Unclosed Anchor: [DEF:capture_dashboard:Function] started at line 26",
                    "severity": "ERROR",
                    "line_number": 26
                  },
                  {
                    "message": "Missing Mandatory Tag: @PRE (required for STANDARD tier)",
                    "severity": "WARNING",
                    "line_number": 26
                  },
                  {
                    "message": "Missing Mandatory Tag: @POST (required for STANDARD tier)",
                    "severity": "WARNING",
                    "line_number": 26
                  },
                  {
                    "message": "Unclosed Anchor: [DEF:capture_dashboard:Function] started at line 26",
                    "severity": "ERROR",
                    "line_number": 26
                  },
                  {
                    "message": "Missing Mandatory Tag: @PRE (required for STANDARD tier)",
                    "severity": "WARNING",
                    "line_number": 26
                  },
                  {
                    "message": "Missing Mandatory Tag: @POST (required for STANDARD tier)",
                    "severity": "WARNING",
                    "line_number": 26
                  },
                  {
                    "message": "Unclosed Anchor: [DEF:capture_dashboard:Function] started at line 26",
                    "severity": "ERROR",
                    "line_number": 26
                  },
                  {
                    "message": "Missing Mandatory Tag: @PRE (required for STANDARD tier)",
                    "severity": "WARNING",
                    "line_number": 26
                  },
                  {
                    "message": "Missing Mandatory Tag: @POST (required for STANDARD tier)",
                    "severity": "WARNING",
                    "line_number": 26
                  }
                ],
                "score": 0.0
              }
            }
          ],
          "compliance": {
            "valid": false,
            "issues": [
              {
                "message": "Unclosed Anchor: [DEF:ScreenshotService:Class] started at line 19",
                "severity": "ERROR",
                "line_number": 19
              },
              {
                "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 19
              },
              {
                "message": "Unclosed Anchor: [DEF:ScreenshotService:Class] started at line 19",
                "severity": "ERROR",
                "line_number": 19
              },
              {
                "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 19
              }
            ],
            "score": 0.0
          }
        },
        {
          "name": "__init__",
          "type": "Function",
          "tier": "TRIVIAL",
          "start_line": 23,
          "end_line": 23,
          "tags": {
            "PURPOSE": "Auto-detected function (orphan)",
            "TIER": "TRIVIAL"
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "__init__",
          "type": "Function",
          "tier": "TRIVIAL",
          "start_line": 139,
          "end_line": 139,
          "tags": {
            "PURPOSE": "Auto-detected function (orphan)",
            "TIER": "TRIVIAL"
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        }
      ],
      "compliance": {
        "valid": false,
        "issues": [
          {
            "message": "Unclosed Anchor: [DEF:backend.src.plugins.llm_analysis.service:Module] started at line 1",
            "severity": "ERROR",
            "line_number": 1
          }
        ],
        "score": 0.0
      }
    },
    {
      "name": "StoragePlugin",
      "type": "Module",
      "tier": "STANDARD",
      "start_line": 1,
      "end_line": 333,
      "tags": {
        "SEMANTICS": "storage, files, filesystem, plugin",
        "PURPOSE": "Provides core filesystem operations for managing backups and repositories.",
        "LAYER": "App",
        "INVARIANT": "All file operations must be restricted to the configured storage root."
      },
      "relations": [
        {
          "type": "IMPLEMENTS",
          "target": "PluginBase"
        },
        {
          "type": "DEPENDS_ON",
          "target": "backend.src.models.storage"
        }
      ],
      "children": [
        {
          "name": "StoragePlugin",
          "type": "Class",
          "tier": "STANDARD",
          "start_line": 25,
          "end_line": 332,
          "tags": {
            "PURPOSE": "Implementation of the storage management plugin."
          },
          "relations": [],
          "children": [
            {
              "name": "__init__",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 32,
              "end_line": 39,
              "tags": {
                "PURPOSE": "Initializes the StoragePlugin and ensures required directories exist.",
                "PRE": "Configuration manager must be accessible.",
                "POST": "Storage root and category directories are created on disk."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            },
            {
              "name": "id",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 42,
              "end_line": 50,
              "tags": {
                "PURPOSE": "Returns the unique identifier for the storage plugin.",
                "PRE": "None.",
                "POST": "Returns the plugin ID string.",
                "RETURN": "str - \"storage-manager\""
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            },
            {
              "name": "name",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 53,
              "end_line": 61,
              "tags": {
                "PURPOSE": "Returns the human-readable name of the storage plugin.",
                "PRE": "None.",
                "POST": "Returns the plugin name string.",
                "RETURN": "str - \"Storage Manager\""
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            },
            {
              "name": "description",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 64,
              "end_line": 72,
              "tags": {
                "PURPOSE": "Returns a description of the storage plugin.",
                "PRE": "None.",
                "POST": "Returns the plugin description string.",
                "RETURN": "str - Plugin description."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            },
            {
              "name": "version",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 75,
              "end_line": 83,
              "tags": {
                "PURPOSE": "Returns the version of the storage plugin.",
                "PRE": "None.",
                "POST": "Returns the version string.",
                "RETURN": "str - \"1.0.0\""
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            },
            {
              "name": "ui_route",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 86,
              "end_line": 92,
              "tags": {
                "PURPOSE": "Returns the frontend route for the storage plugin.",
                "RETURN": "str - \"/tools/storage\""
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [
                  {
                    "message": "Missing Mandatory Tag: @PRE (required for STANDARD tier)",
                    "severity": "WARNING",
                    "line_number": 86
                  },
                  {
                    "message": "Missing Mandatory Tag: @POST (required for STANDARD tier)",
                    "severity": "WARNING",
                    "line_number": 86
                  },
                  {
                    "message": "Missing Mandatory Tag: @PRE (required for STANDARD tier)",
                    "severity": "WARNING",
                    "line_number": 86
                  },
                  {
                    "message": "Missing Mandatory Tag: @POST (required for STANDARD tier)",
                    "severity": "WARNING",
                    "line_number": 86
                  },
                  {
                    "message": "Missing Mandatory Tag: @PRE (required for STANDARD tier)",
                    "severity": "WARNING",
                    "line_number": 86
                  },
                  {
                    "message": "Missing Mandatory Tag: @POST (required for STANDARD tier)",
                    "severity": "WARNING",
                    "line_number": 86
                  }
                ],
                "score": 0.26666666666666655
              }
            },
            {
              "name": "get_schema",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 94,
              "end_line": 112,
              "tags": {
                "PURPOSE": "Returns the JSON schema for storage plugin parameters.",
                "PRE": "None.",
                "POST": "Returns a dictionary representing the JSON schema.",
                "RETURN": "Dict[str, Any] - JSON schema."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            },
            {
              "name": "execute",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 114,
              "end_line": 121,
              "tags": {
                "PURPOSE": "Executes storage-related tasks (placeholder for PluginBase compliance).",
                "PRE": "params must match the plugin schema.",
                "POST": "Task is executed and logged."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            },
            {
              "name": "get_storage_root",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 123,
              "end_line": 143,
              "tags": {
                "PURPOSE": "Resolves the absolute path to the storage root.",
                "PRE": "Settings must define a storage root path.",
                "POST": "Returns a Path object representing the storage root."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            },
            {
              "name": "resolve_path",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 145,
              "end_line": 167,
              "tags": {
                "PURPOSE": "Resolves a dynamic path pattern using provided variables.",
                "PARAM": "variables (Dict[str, str]) - Variables to substitute in the pattern.",
                "PRE": "pattern must be a valid format string.",
                "POST": "Returns the resolved path string.",
                "RETURN": "str - The resolved path."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            },
            {
              "name": "ensure_directories",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 169,
              "end_line": 182,
              "tags": {
                "PURPOSE": "Creates the storage root and category subdirectories if they don't exist.",
                "PRE": "Storage root must be resolvable.",
                "POST": "Directories are created on the filesystem.",
                "SIDE_EFFECT": "Creates directories on the filesystem."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            },
            {
              "name": "validate_path",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 184,
              "end_line": 198,
              "tags": {
                "PURPOSE": "Prevents path traversal attacks by ensuring the path is within the storage root.",
                "PRE": "path must be a Path object.",
                "POST": "Returns the resolved absolute path if valid, otherwise raises ValueError."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            },
            {
              "name": "list_files",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 200,
              "end_line": 249,
              "tags": {
                "PURPOSE": "Lists all files and directories in a specific category and subpath.",
                "PARAM": "subpath (Optional[str]) - Nested path within the category.",
                "PRE": "Storage root must exist.",
                "POST": "Returns a list of StoredFile objects.",
                "RETURN": "List[StoredFile] - List of file and directory metadata objects."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            },
            {
              "name": "save_file",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 251,
              "end_line": 283,
              "tags": {
                "PURPOSE": "Saves an uploaded file to the specified category and optional subpath.",
                "PARAM": "subpath (Optional[str]) - The target subpath.",
                "PRE": "file must be a valid UploadFile; category must be valid.",
                "POST": "File is written to disk and metadata is returned.",
                "RETURN": "StoredFile - Metadata of the saved file.",
                "SIDE_EFFECT": "Writes file to disk."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            },
            {
              "name": "delete_file",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 285,
              "end_line": 309,
              "tags": {
                "PURPOSE": "Deletes a file or directory from the specified category and path.",
                "PARAM": "path (str) - The relative path of the file or directory.",
                "PRE": "path must belong to the specified category and exist on disk.",
                "POST": "The file or directory is removed from disk.",
                "SIDE_EFFECT": "Removes item from disk."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            },
            {
              "name": "get_file_path",
              "type": "Function",
              "tier": "STANDARD",
              "start_line": 311,
              "end_line": 330,
              "tags": {
                "PURPOSE": "Returns the absolute path of a file for download.",
                "PARAM": "path (str) - The relative path of the file.",
                "PRE": "path must belong to the specified category and be a file.",
                "POST": "Returns the absolute Path to the file.",
                "RETURN": "Path - Absolute path to the file."
              },
              "relations": [],
              "children": [],
              "compliance": {
                "valid": true,
                "issues": [],
                "score": 1.0
              }
            }
          ],
          "compliance": {
            "valid": true,
            "issues": [
              {
                "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 25
              },
              {
                "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 25
              }
            ],
            "score": 0.7000000000000001
          }
        }
      ],
      "compliance": {
        "valid": true,
        "issues": [
          {
            "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
            "severity": "WARNING",
            "line_number": 1
          }
        ],
        "score": 0.85
      }
    },
    {
      "name": "GitLLMExtension",
      "type": "Class",
      "tier": "STANDARD",
      "start_line": 14,
      "end_line": null,
      "tags": {
        "PURPOSE": "Provides LLM capabilities to the Git plugin."
      },
      "relations": [],
      "children": [
        {
          "name": "suggest_commit_message",
          "type": "Function",
          "tier": "STANDARD",
          "start_line": 20,
          "end_line": null,
          "tags": {
            "PURPOSE": "Generates a suggested commit message based on a diff and history.",
            "PARAM": "history (List[str]) - Recent commit messages for context.",
            "RETURN": "str - The suggested commit message."
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": false,
            "issues": [
              {
                "message": "Unclosed Anchor: [DEF:suggest_commit_message:Function] started at line 20",
                "severity": "ERROR",
                "line_number": 20
              },
              {
                "message": "Missing Mandatory Tag: @PRE (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 20
              },
              {
                "message": "Missing Mandatory Tag: @POST (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 20
              },
              {
                "message": "Unclosed Anchor: [DEF:suggest_commit_message:Function] started at line 20",
                "severity": "ERROR",
                "line_number": 20
              },
              {
                "message": "Missing Mandatory Tag: @PRE (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 20
              },
              {
                "message": "Missing Mandatory Tag: @POST (required for STANDARD tier)",
                "severity": "WARNING",
                "line_number": 20
              }
            ],
            "score": 0.0
          }
        }
      ],
      "compliance": {
        "valid": false,
        "issues": [
          {
            "message": "Unclosed Anchor: [DEF:GitLLMExtension:Class] started at line 14",
            "severity": "ERROR",
            "line_number": 14
          },
          {
            "message": "Missing Mandatory Tag: @TIER (required for STANDARD tier)",
            "severity": "WARNING",
            "line_number": 14
          }
        ],
        "score": 0.0
      }
    },
    {
      "name": "llm_extension",
      "type": "Module",
      "tier": "TRIVIAL",
      "start_line": 1,
      "end_line": 66,
      "tags": {
        "PURPOSE": "Auto-generated module for backend/src/plugins/git/llm_extension.py",
        "TIER": "TRIVIAL",
        "LAYER": "Unknown"
      },
      "relations": [],
      "children": [
        {
          "name": "__init__",
          "type": "Function",
          "tier": "TRIVIAL",
          "start_line": 17,
          "end_line": 17,
          "tags": {
            "PURPOSE": "Auto-detected function (orphan)",
            "TIER": "TRIVIAL"
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        }
      ],
      "compliance": {
        "valid": true,
        "issues": [],
        "score": 1.0
      }
    },
    {
      "name": "test_environment_model",
      "type": "Function",
      "tier": "STANDARD",
      "start_line": 5,
      "end_line": 21,
      "tags": {
        "PURPOSE": "Tests that Environment model correctly stores values.",
        "PRE": "Environment class is available.",
        "POST": "Values are verified."
      },
      "relations": [],
      "children": [],
      "compliance": {
        "valid": true,
        "issues": [],
        "score": 1.0
      }
    },
    {
      "name": "test_belief_scope_logs_entry_action_exit",
      "type": "Function",
      "tier": "STANDARD",
      "start_line": 5,
      "end_line": 22,
      "tags": {
        "PURPOSE": "Test that belief_scope generates [ID][Entry], [ID][Action], and [ID][Exit] logs.",
        "PRE": "belief_scope is available. caplog fixture is used.",
        "POST": "Logs are verified to contain Entry, Action, and Exit tags."
      },
      "relations": [],
      "children": [],
      "compliance": {
        "valid": true,
        "issues": [],
        "score": 1.0
      }
    },
    {
      "name": "test_belief_scope_error_handling",
      "type": "Function",
      "tier": "STANDARD",
      "start_line": 25,
      "end_line": 42,
      "tags": {
        "PURPOSE": "Test that belief_scope logs Coherence:Failed on exception.",
        "PRE": "belief_scope is available. caplog fixture is used.",
        "POST": "Logs are verified to contain Coherence:Failed tag."
      },
      "relations": [],
      "children": [],
      "compliance": {
        "valid": true,
        "issues": [],
        "score": 1.0
      }
    },
    {
      "name": "test_belief_scope_success_coherence",
      "type": "Function",
      "tier": "STANDARD",
      "start_line": 45,
      "end_line": 59,
      "tags": {
        "PURPOSE": "Test that belief_scope logs Coherence:OK on success.",
        "PRE": "belief_scope is available. caplog fixture is used.",
        "POST": "Logs are verified to contain Coherence:OK tag."
      },
      "relations": [],
      "children": [],
      "compliance": {
        "valid": true,
        "issues": [],
        "score": 1.0
      }
    },
    {
      "name": "test_auth",
      "type": "Module",
      "tier": "TRIVIAL",
      "start_line": 1,
      "end_line": 162,
      "tags": {
        "PURPOSE": "Auto-generated module for backend/tests/test_auth.py",
        "TIER": "TRIVIAL",
        "LAYER": "Unknown"
      },
      "relations": [],
      "children": [
        {
          "name": "db_session",
          "type": "Function",
          "tier": "TRIVIAL",
          "start_line": 27,
          "end_line": 27,
          "tags": {
            "PURPOSE": "Auto-detected function (orphan)",
            "TIER": "TRIVIAL"
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "auth_service",
          "type": "Function",
          "tier": "TRIVIAL",
          "start_line": 40,
          "end_line": 40,
          "tags": {
            "PURPOSE": "Auto-detected function (orphan)",
            "TIER": "TRIVIAL"
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "auth_repo",
          "type": "Function",
          "tier": "TRIVIAL",
          "start_line": 44,
          "end_line": 44,
          "tags": {
            "PURPOSE": "Auto-detected function (orphan)",
            "TIER": "TRIVIAL"
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "test_create_user",
          "type": "Function",
          "tier": "TRIVIAL",
          "start_line": 47,
          "end_line": 47,
          "tags": {
            "PURPOSE": "Auto-detected function (orphan)",
            "TIER": "TRIVIAL"
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "test_authenticate_user",
          "type": "Function",
          "tier": "TRIVIAL",
          "start_line": 65,
          "end_line": 65,
          "tags": {
            "PURPOSE": "Auto-detected function (orphan)",
            "TIER": "TRIVIAL"
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "test_create_session",
          "type": "Function",
          "tier": "TRIVIAL",
          "start_line": 90,
          "end_line": 90,
          "tags": {
            "PURPOSE": "Auto-detected function (orphan)",
            "TIER": "TRIVIAL"
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "test_role_permission_association",
          "type": "Function",
          "tier": "TRIVIAL",
          "start_line": 108,
          "end_line": 108,
          "tags": {
            "PURPOSE": "Auto-detected function (orphan)",
            "TIER": "TRIVIAL"
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "test_user_role_association",
          "type": "Function",
          "tier": "TRIVIAL",
          "start_line": 127,
          "end_line": 127,
          "tags": {
            "PURPOSE": "Auto-detected function (orphan)",
            "TIER": "TRIVIAL"
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        },
        {
          "name": "test_ad_group_mapping",
          "type": "Function",
          "tier": "TRIVIAL",
          "start_line": 148,
          "end_line": 148,
          "tags": {
            "PURPOSE": "Auto-detected function (orphan)",
            "TIER": "TRIVIAL"
          },
          "relations": [],
          "children": [],
          "compliance": {
            "valid": true,
            "issues": [],
            "score": 1.0
          }
        }
      ],
      "compliance": {
        "valid": true,
        "issues": [],
        "score": 1.0
      }
    }
  ]
}