Merge 'develop' into 'stable' to prepare for SDK 1.17.0

.github/workflows/ci.yml

@@ -127,6 +127,28 @@ jobs:
         env:
           SHELLCHECK_OPTS: --exclude=SC2086 --exclude=SC2046 --exclude=SC2004 --exclude=SC2129
 
+  uv-lock-check:
+    if: |
+      needs.files-changed.outputs.uv_files == 'true' ||
+      needs.files-changed.outputs.github_workflows == 'true'
+    needs:
+      - files-changed
+      - prepare-environment
+    runs-on: "ubuntu-latest"
+    timeout-minutes: 5
+    steps:
+      - name: "Check out repository code"
+        uses: "actions/checkout@v5"
+      - name: "Set up Python"
+        uses: "actions/setup-python@v6"
+        with:
+          python-version: "3.12"
+      - name: "Install uv"
+        uses: astral-sh/setup-uv@v7
+        with:
+          version: ${{ needs.prepare-environment.outputs.UV_VERSION }}
+      - name: "Validate pyproject.toml and consistency with uv.lock"
+        run: uv lock --locked --offline
 
   documentation:
     defaults:
@@ -229,6 +251,7 @@ jobs:
           - "3.11"
           - "3.12"
           - "3.13"
+          - "3.14"
     if: |
       always() && !cancelled() &&
       !contains(needs.*.result, 'failure') &&

.vale.ini

@@ -16,5 +16,10 @@ BlockIgnores = (?s) *((import.*?\n)|(```.*?```\n))
 # in files like pyproject.toml
 BasedOnStyles =
 
+[*.yml]
+# Ignore all rules for yaml files, to prevent false positives
+# in files for GitHub Actions or other CI/CD configurations
+BasedOnStyles =
+
 [*]
 BasedOnStyles = Infrahub

.vale/styles/spelling-exceptions.txt

@@ -20,9 +20,11 @@ Containerlab
 content_type
 convert_query_response
 coroutine
+callouts
 cypher
 Dagster
 datastore
+Diataxis
 default_branch
 default_filter
 deserialized
@@ -42,6 +44,7 @@ eslint
 excalidraw
 fanout
 file_path
+frontmatter
 generator_definition
 generator_definitions
 github
@@ -114,6 +117,7 @@ template_path
 toml
 Towncrier
 towncrier
+Typer
 uncheck
 uniqueness_constraints
 userinfo

AGENTS.md

@@ -0,0 +1,77 @@
+# AGENTS.md
+
+Infrahub Python SDK - async/sync client for Infrahub infrastructure management.
+
+## Commands
+
+```bash
+uv sync --all-groups --all-extras   # Install all deps
+uv run invoke format                # Format code
+uv run invoke lint                  # Lint (ruff + mypy + yamllint)
+uv run pytest tests/unit/           # Unit tests
+uv run pytest tests/integration/    # Integration tests
+```
+
+## Tech Stack
+
+Python 3.10-3.13, UV, pydantic >=2.0, httpx, graphql-core
+
+## Code Pattern
+
+```python
+# Always provide both async and sync versions
+client = InfrahubClient()           # async
+client = InfrahubClientSync()       # sync
+
+node = await client.get(kind="NetworkDevice")
+await node.save()
+```
+
+## Project Structure
+
+```text
+infrahub_sdk/
+├── client.py           # Main client implementations
+├── config.py           # Pydantic configuration
+├── node/               # Node system (core data model)
+├── ctl/                # CLI (infrahubctl)
+└── pytest_plugin/      # Custom pytest plugin
+```
+
+## Markdown Style
+
+When editing `.md` or `.mdx` files, run `uv run invoke lint-docs` before committing.
+
+Key rules:
+
+- Use `text` language for directory structure code blocks
+- Add blank lines before and after lists
+- Always specify language in fenced code blocks (`python`, `bash`, `text`)
+
+## Boundaries
+
+✅ **Always**
+
+- Run `uv run invoke format lint` before committing Python code
+- Run markdownlint before committing markdown changes
+- Follow async/sync dual pattern for new features
+- Use type hints on all function signatures
+
+⚠️ **Ask first**
+
+- Adding new dependencies
+- Changing public API signatures
+
+🚫 **Never**
+
+- Push to GitHub automatically (always wait for user approval)
+- Mix async/sync inappropriately
+- Modify generated code (protocols.py)
+- Bypass type checking without justification
+
+## Subdirectory Guides
+
+- [docs/AGENTS.md](docs/AGENTS.md) - Documentation (Docusaurus)
+- [infrahub_sdk/ctl/AGENTS.md](infrahub_sdk/ctl/AGENTS.md) - CLI development
+- [infrahub_sdk/pytest_plugin/AGENTS.md](infrahub_sdk/pytest_plugin/AGENTS.md) - Pytest plugin
+- [tests/AGENTS.md](tests/AGENTS.md) - Testing