chore: Migrate from Poetry to uv (#63)

* Migrate from Poetry to uv for dependency management

- Convert pyproject.toml from Poetry format to PEP 621 standard
- Replace poetry.lock with uv.lock
- Update CI workflow to use astral-sh/setup-uv@v4 instead of snok/install-poetry
- Update all dependencies to latest versions:
  - infrahub-sdk: v1.12.2 -> v1.17.0
  - ruff: 0.9.1 -> 0.14.10
  - mypy: 1.14.1 -> 1.19.1
  - pylint: 3.3.4 -> 4.0.4
  - yamllint: 1.35.1 -> 1.37.1
  - vale: 3.9.4.0 -> 3.13.0.0
  - invoke: 2.1.2 -> 2.2.1
  - types-pyyaml: 6.0.12.20250516 -> 6.0.12.20250915

* pin uv version

* test ci fix

* Add linting tasks and fix generated markdown documentation

- Add markdownlint task to tasks/linter.py matching CI pipeline
- Add pylint, ruff format check tasks to match CI
- Create .markdownlintignore for node_modules and .venv
- Fix Jinja templates to generate valid markdown:
  - Add blank lines around lists (MD032)
  - Use 4-space indentation for nested lists (MD007)
  - Trim descriptions to prevent double blank lines (MD012)
  - Fix table separator formatting
- Disable MD060 (table column style) for dynamic tables
- Fix MLAG description markdown formatting in .metadata.yml
- Regenerate all reference documentation

* Add markdownlint job to CI pipeline

Add markdown-lint job that runs markdownlint on all .md and .mdx files
when markdown files change, matching the local linter.markdown task.

Author: petercrocker

.github/workflows/ci.yml

@@ -22,6 +22,7 @@ jobs:
     timeout-minutes: 5
     outputs:
       documentation: ${{ steps.changes.outputs.documentation_all }}
+      markdown: ${{ steps.changes.outputs.markdown_all }}
       python: ${{ steps.changes.outputs.python_all }}
       yaml: ${{ steps.changes.outputs.yaml_all }}
     steps:
@@ -38,41 +39,28 @@ jobs:
     if: needs.files-changed.outputs.python == 'true'
     needs: ["files-changed"]
     runs-on: "ubuntu-latest"
-    strategy:
-      matrix:
-        python-version:
-          - "3.12"
-        poetry-version:
-          - "1.8.5"
     timeout-minutes: 5
     steps:
       - name: "Check out repository code"
         uses: "actions/checkout@v4"
-      - name: "Set up Python ${{ matrix.python-version }}"
+      - name: "Set up Python"
         uses: "actions/setup-python@v5"
         with:
-          python-version: ${{ matrix.python-version }}
-      - name: "Install Poetry ${{ matrix.poetry-version }}"
-        uses: "snok/install-poetry@v1"
+          python-version: "3.12"
+      - name: "Install uv"
+        uses: "astral-sh/setup-uv@v5"
         with:
-          version: ${{ matrix.poetry-version }}
-          virtualenvs-create: true
-          virtualenvs-in-project: true
-          installer-parallel: true
-      - name: "Setup Python environment"
-        run: |
-          poetry config virtualenvs.create true --local
-          poetry env use ${{ matrix.python-version }}
+          version: "0.9.18"
       - name: "Install dependencies"
-        run: "poetry install --no-interaction --no-ansi --with dev"
+        run: "uv sync --group dev"
       - name: "Linting: ruff check"
-        run: "poetry run ruff check ."
+        run: "uv run ruff check ."
       - name: "Linting: ruff format"
-        run: "poetry run ruff format --check --diff ."
+        run: "uv run ruff format --check --diff ."
       - name: "Mypy Tests"
-        run: "poetry run mypy --show-error-codes ."
+        run: "uv run mypy --show-error-codes ."
       - name: "Pylint Tests"
-        run: "poetry run pylint --ignore .venv ."
+        run: "uv run pylint --ignore .venv ."
 
   yaml-lint:
     name: Run yaml lint
@@ -88,6 +76,24 @@ jobs:
       - name: "Linting: yamllint"
         run: "yamllint -s ."
 
+  markdown-lint:
+    name: Run markdown lint
+    if: needs.files-changed.outputs.markdown == 'true'
+    needs: ["files-changed"]
+    runs-on: "ubuntu-latest"
+    timeout-minutes: 5
+    steps:
+      - name: "Check out repository code"
+        uses: "actions/checkout@v4"
+      - name: "Setup Node.js"
+        uses: "actions/setup-node@v4"
+        with:
+          node-version: "20"
+      - name: "Install markdownlint-cli"
+        run: "npm install -g markdownlint-cli"
+      - name: "Linting: markdownlint"
+        run: "markdownlint '**/*.md' '**/*.mdx'"
+
   schema-test:
     name: Test all schema files
     needs:
@@ -111,25 +117,29 @@ jobs:
         uses: actions/setup-python@v5
         with:
           python-version: "3.12"
-      - name: Install Invoke
-        run: poetry install --no-interaction --no-ansi --with dev
+      - name: "Install uv"
+        uses: "astral-sh/setup-uv@v5"
+        with:
+          version: "0.9.18"
+      - name: Install dependencies
+        run: uv sync --group dev
       - name: Set job name
         run: echo JOB_NAME="$GITHUB_JOB" >> $GITHUB_ENV
       - name: "Set environment variable INFRAHUB_BUILD_NAME"
         run: echo INFRAHUB_BUILD_NAME=infrahub-${{ runner.name }} >> $GITHUB_ENV
       - name: Initialize Infrahub
-        run: poetry run invoke start
+        run: uv run invoke start
       - name: Set infrahub address
         run: |
           PORT=$(docker compose -p $INFRAHUB_BUILD_NAME port infrahub-server 8000 | cut -d: -f2)
           echo "INFRAHUB_ADDRESS=http://localhost:${PORT}" >> $GITHUB_ENV
       - name: "Store start time"
         run: echo TEST_START_TIME=$(date +%s)000 >> $GITHUB_ENV
       - name: Load all schemas files
-        run: poetry run invoke schemas.load-all-schemas
+        run: uv run invoke schemas.load-all-schemas
       - name: "Clear docker environment and force vmagent to stop"
         if: always()
-        run: poetry run invoke destroy
+        run: uv run invoke destroy
 
   documentation:
     defaults:
@@ -154,15 +164,22 @@ jobs:
           node-version: 20
           cache: 'npm'
           cache-dependency-path: docs/package-lock.json
-      - name: "Setup Python environment"
-        run: "pip install invoke toml"
+      - name: "Install uv"
+        uses: "astral-sh/setup-uv@v5"
+        with:
+          version: "0.9.18"
+      - name: "Install Python dependencies"
+        run: "uv sync"
+        working-directory: ./
       - name: "Install dependencies"
-        run: "invoke docs.install"
+        run: "uv run invoke docs.install"
+        working-directory: ./
       - name: "Generate reference documentation"
-        run: "invoke docs.generate"
+        run: "uv run invoke docs.generate"
         working-directory: ./
       - name: "Build docs website"
-        run: "invoke docs.build"
+        run: "uv run invoke docs.build"
+        working-directory: ./
 
   validate-documentation-style:
     if: |

.markdownlint.yaml

@@ -14,3 +14,4 @@ MD034: false    # no-bare-urls
 MD045: false    # no alt text around images
 MD047: false    # single trailing newline
 MD014: false    # dollar signs used before commands
+MD060: false    # table column style - disabled for generated tables

.markdownlintignore

@@ -0,0 +1,2 @@
+docs/node_modules/
+.venv/