Update isort config

Signed-off-by: Mihai Criveti <[email protected]>

Author: crivetimihai

.isort.cfg

@@ -220,10 +220,59 @@ line-length = 200
 target-version = ["py310", "py311", "py312"]
 include = "\\.pyi?$"
 
-# Configured in .isort.cfg instead
-# [tool.isort]
-# profile = "black"
-# multi_line_output = 3
+# isort configuration
+[tool.isort]
+###############################################################################
+# Core behaviour
+###############################################################################
+profile                    = "black"      # inherit Black's own import-sorting profile
+line_length                = 200          # match Black's custom line length
+multi_line_output          = 3            # vertical-hanging-indent style
+include_trailing_comma     = true         # keep trailing commas for Black
+from_first                 = true         # place all "from ... import ..." before plain "import ..."
+
+###############################################################################
+# Section ordering & headings
+###############################################################################
+sections                   = ["FUTURE", "STDLIB", "FIRSTPARTY", "THIRDPARTY", "LOCALFOLDER"]
+import_heading_future      = "Future"       # header above FUTURE imports (if headings enabled)
+import_heading_stdlib      = "Standard"     # header for built-in Stdlib imports
+import_heading_thirdparty  = "Third-Party"  # header for pip-installed packages
+import_heading_firstparty  = "First-Party"  # header for internal 'mcpgateway' code
+import_heading_localfolder = "Local"        # header for ad-hoc scripts / tests
+
+###############################################################################
+# What belongs where
+###############################################################################
+known_first_party          = ["mcpgateway"]    # treat "mcpgateway.*" as FIRSTPARTY
+known_local_folder         = ["tests", "scripts"]  # treat these folders as LOCALFOLDER
+# src_paths                = ["src/mcpgateway"]    # uncomment only if package moves under src/
+
+###############################################################################
+# Style niceties
+###############################################################################
+force_sort_within_sections = true         # always alphabetise names inside each block
+order_by_type              = false        # don't group imports by "type vs. straight name"
+balanced_wrapping          = true         # spread wrapped imports evenly between lines
+lines_between_sections     = 1            # exactly one blank line between the five groups
+lines_between_types        = 1            # one blank line between 'import X' and 'from X import ...'
+no_lines_before            = ["LOCALFOLDER"]  # suppress blank line *before* the LOCALFOLDER block
+ensure_newline_before_comments = true     # newline before any inline # comment after an import
+
+###############################################################################
+# Ignore junk we never want to touch
+###############################################################################
+extend_skip                = [
+  ".md", ".json", ".yaml", ".yml",
+  "dist", "build", ".venv", ".tox",
+  "*.tmp", "*.bak",
+]
+skip_glob                  = ["**/__init__.py"]  # leave namespace init files alone
+
+# ---- Optional CI toggles ----------------------------------------------------
+# check_only             = true    # dry-run mode: non-zero exit if files would change
+# verbose                = true    # print every file name processed
+# case_sensitive         = true    # treat upper/lowercase differences as significant
 
 [tool.mypy]
 # Target Python version