Dev

.github/workflows/ci.yml

@@ -0,0 +1,114 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+  workflow_dispatch:
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  test:
+    name: test (py${{ matrix.python-version }}, pydantic${{ matrix.pydantic-version }})
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ["3.11", "3.12", "3.13"]
+        pydantic-version: ["~=2.0.0", "~=2.10.0"]
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v4
+        with:
+          enable-cache: true
+
+      - name: Set up Python ${{ matrix.python-version }}
+        run: uv python install ${{ matrix.python-version }}
+
+      - name: Install deps
+        run: uv sync --all-extras --python ${{ matrix.python-version }}
+
+      - name: Pin pydantic version
+        run: uv pip install "pydantic${{ matrix.pydantic-version }}"
+
+      - name: Lint
+        run: uv run ruff check .
+
+      - name: Type-check
+        run: uv run pyright
+
+      - name: Unit tests
+        run: uv run pytest tests/unit tests/contract -q -m unit
+
+      - name: Coverage
+        if: matrix.python-version == '3.13' && matrix.pydantic-version == '~=2.10.0'
+        run: |
+          uv run coverage run -m pytest tests/unit tests/contract -q -m unit
+          uv run coverage report -m --fail-under=95
+
+  integration:
+    name: integration tests
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v4
+        with:
+          enable-cache: true
+
+      - name: Set up Python
+        run: uv python install 3.13
+
+      - name: Install deps
+        run: uv sync --all-extras --python 3.13
+
+      - name: Start Snipe-IT stack
+        run: |
+          rm -rf docker/api_key.txt
+          touch docker/api_key.txt
+          cd docker && docker compose up -d
+
+      - name: Wait for API key
+        run: |
+          echo "Waiting for docker/api_key.txt (up to ~120s)..."
+          for i in $(seq 1 120); do
+            if [ -s docker/api_key.txt ]; then break; fi
+            sleep 1
+          done
+          if [ ! -s docker/api_key.txt ]; then
+            echo "Timed out waiting for docker/api_key.txt"
+            cd docker && docker compose logs seeder
+            exit 1
+          fi
+
+      - name: Wait for API readiness
+        run: |
+          TOKEN=$(cat docker/api_key.txt)
+          echo "Waiting for Snipe-IT API (up to ~120s)..."
+          for i in $(seq 1 120); do
+            code=$(curl -s -o /dev/null -w "%{http_code}" -m 5 \
+              -H "Authorization: Bearer $TOKEN" \
+              -H "Accept: application/json" \
+              http://localhost:8000/api/v1/users/me 2>/dev/null || echo "000")
+            if [ "$code" = "200" ]; then
+              echo "API is ready"
+              break
+            fi
+            sleep 1
+          done
+          if [ "$code" != "200" ]; then
+            echo "Timed out. Last status: $code"
+            cd docker && docker compose logs app
+            exit 1
+          fi
+
+      - name: Integration tests
+        run: uv run pytest tests/integration -q -m integration

.github/workflows/mutation.yml

@@ -0,0 +1,44 @@
+name: Mutation (advisory)
+
+on:
+  pull_request:
+    branches: [main, dev]
+  workflow_dispatch:
+
+# Advisory job — never blocks merges.
+# Results are uploaded as an artifact for review.
+
+jobs:
+  mutation:
+    name: mutmut (advisory)
+    runs-on: ubuntu-latest
+    continue-on-error: true
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v4
+        with:
+          enable-cache: true
+
+      - name: Set up Python
+        run: uv python install 3.13
+
+      - name: Install deps
+        run: uv sync --all-extras --python 3.13
+
+      - name: Run mut-quick
+        run: uv run make mut-quick
+        continue-on-error: true
+
+      - name: Print mutation summary
+        run: uv run mutmut results || true
+
+      - name: Upload mutation cache
+        uses: actions/upload-artifact@v4
+        if: always()
+        with:
+          name: mutmut-results
+          path: .mutmut-cache
+          retention-days: 7

.gitignore

@@ -61,10 +61,16 @@ env/
 
 # Local
 GEMINI.md
+.kiro/
 .mutmut-cache
 .mutmut-cache/
 mutants/
 *.bak
-*.lock
 *.html
-*.tmp
+*.tmp
+
+# Tool caches
+.ruff_cache/
+
+# Docker dev secrets (generated at runtime)
+docker/api_key.txt

.kiro/settings/lsp.json

@@ -0,0 +1,205 @@
+{
+  "languages": {
+    "typescript": {
+      "name": "typescript-language-server",
+      "command": "typescript-language-server",
+      "args": [
+        "--stdio"
+      ],
+      "file_extensions": [
+        "ts",
+        "js",
+        "tsx",
+        "jsx"
+      ],
+      "file_patterns": [],
+      "project_patterns": [
+        "package.json",
+        "tsconfig.json"
+      ],
+      "exclude_patterns": [
+        "**/node_modules/**",
+        "**/dist/**"
+      ],
+      "multi_workspace": false,
+      "initialization_options": {
+        "preferences": {
+          "disableSuggestions": false
+        }
+      },
+      "request_timeout_secs": 60
+    },
+    "rust": {
+      "name": "rust-analyzer",
+      "command": "rust-analyzer",
+      "args": [],
+      "file_extensions": [
+        "rs"
+      ],
+      "file_patterns": [],
+      "project_patterns": [
+        "Cargo.toml"
+      ],
+      "exclude_patterns": [
+        "**/target/**"
+      ],
+      "multi_workspace": false,
+      "initialization_options": {
+        "cargo": {
+          "buildScripts": {
+            "enable": true
+          }
+        },
+        "diagnostics": {
+          "enable": true,
+          "enableExperimental": true
+        },
+        "workspace": {
+          "symbol": {
+            "search": {
+              "scope": "workspace"
+            }
+          }
+        }
+      },
+      "request_timeout_secs": 60
+    },
+    "python": {
+      "name": "pyright",
+      "command": "pyright-langserver",
+      "args": [
+        "--stdio"
+      ],
+      "file_extensions": [
+        "py"
+      ],
+      "file_patterns": [],
+      "project_patterns": [
+        "pyproject.toml",
+        "setup.py",
+        "requirements.txt",
+        "pyrightconfig.json"
+      ],
+      "exclude_patterns": [
+        "**/__pycache__/**",
+        "**/venv/**",
+        "**/.venv/**",
+        "**/.pytest_cache/**"
+      ],
+      "multi_workspace": false,
+      "initialization_options": {},
+      "request_timeout_secs": 60
+    },
+    "java": {
+      "name": "jdtls",
+      "command": "jdtls",
+      "args": [],
+      "file_extensions": [
+        "java"
+      ],
+      "file_patterns": [],
+      "project_patterns": [
+        "pom.xml",
+        "build.gradle",
+        "build.gradle.kts",
+        ".project"
+      ],
+      "exclude_patterns": [
+        "**/target/**",
+        "**/build/**",
+        "**/.gradle/**"
+      ],
+      "multi_workspace": false,
+      "initialization_options": {
+        "settings": {
+          "java": {
+            "compile": {
+              "nullAnalysis": {
+                "mode": "automatic"
+              }
+            },
+            "configuration": {
+              "annotationProcessing": {
+                "enabled": true
+              }
+            }
+          }
+        }
+      },
+      "request_timeout_secs": 60
+    },
+    "go": {
+      "name": "gopls",
+      "command": "gopls",
+      "args": [],
+      "file_extensions": [
+        "go"
+      ],
+      "file_patterns": [],
+      "project_patterns": [
+        "go.mod",
+        "go.sum"
+      ],
+      "exclude_patterns": [
+        "**/vendor/**"
+      ],
+      "multi_workspace": false,
+      "initialization_options": {
+        "usePlaceholders": true,
+        "completeUnimported": true
+      },
+      "request_timeout_secs": 60
+    },
+    "ruby": {
+      "name": "solargraph",
+      "command": "solargraph",
+      "args": [
+        "stdio"
+      ],
+      "file_extensions": [
+        "rb"
+      ],
+      "file_patterns": [],
+      "project_patterns": [
+        "Gemfile",
+        "Rakefile"
+      ],
+      "exclude_patterns": [
+        "**/vendor/**",
+        "**/tmp/**"
+      ],
+      "multi_workspace": false,
+      "initialization_options": {},
+      "request_timeout_secs": 60
+    },
+    "cpp": {
+      "name": "clangd",
+      "command": "clangd",
+      "args": [
+        "--background-index"
+      ],
+      "file_extensions": [
+        "cpp",
+        "cc",
+        "cxx",
+        "c",
+        "h",
+        "hpp",
+        "hxx"
+      ],
+      "file_patterns": [],
+      "project_patterns": [
+        "CMakeLists.txt",
+        "compile_commands.json",
+        "Makefile"
+      ],
+      "exclude_patterns": [
+        "**/build/**",
+        "**/cmake-build-**/**"
+      ],
+      "multi_workspace": false,
+      "initialization_options": {},
+      "request_timeout_secs": 60
+    }
+  }
+}