frostwatch 0.1.0__tar.gz

frostwatch-0.1.0/.github/CODEOWNERS

@@ -0,0 +1,11 @@
+# Global owner — reviews required for all PRs
+* @arunrajiah
+
+# Backend
+frostwatch/ @arunrajiah
+
+# Frontend
+frontend/ @arunrajiah
+
+# CI / Release
+.github/ @arunrajiah

frostwatch-0.1.0/.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,84 @@
+name: Bug Report
+description: Report something that is broken or behaving unexpectedly
+labels: ["bug", "needs-triage"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for taking the time to report a bug. Please fill in as much detail as you can.
+
+  - type: input
+    id: version
+    attributes:
+      label: FrostWatch version
+      description: Run `frostwatch version` to get this
+      placeholder: "0.1.0"
+    validations:
+      required: true
+
+  - type: input
+    id: python
+    attributes:
+      label: Python version
+      placeholder: "3.11.9"
+    validations:
+      required: true
+
+  - type: input
+    id: os
+    attributes:
+      label: Operating system
+      placeholder: "macOS 14.5 / Ubuntu 22.04 / Docker"
+    validations:
+      required: true
+
+  - type: textarea
+    id: description
+    attributes:
+      label: Description
+      description: A clear and concise description of what the bug is
+    validations:
+      required: true
+
+  - type: textarea
+    id: reproduce
+    attributes:
+      label: Steps to reproduce
+      placeholder: |
+        1. Configure X as ...
+        2. Run `frostwatch serve`
+        3. Navigate to /warehouses
+        4. See error
+    validations:
+      required: true
+
+  - type: textarea
+    id: expected
+    attributes:
+      label: Expected behaviour
+    validations:
+      required: true
+
+  - type: textarea
+    id: actual
+    attributes:
+      label: Actual behaviour
+    validations:
+      required: true
+
+  - type: textarea
+    id: logs
+    attributes:
+      label: Relevant logs or stack traces
+      render: text
+
+  - type: dropdown
+    id: llm_provider
+    attributes:
+      label: LLM provider (if relevant)
+      options:
+        - anthropic
+        - openai
+        - gemini
+        - ollama
+        - N/A

frostwatch-0.1.0/.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,55 @@
+name: Feature Request
+description: Suggest a new feature or improvement
+labels: ["enhancement", "needs-triage"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Check [ROADMAP.md](https://github.com/arunrajiah/frostwatch/blob/main/ROADMAP.md) first — your idea may already be planned.
+
+  - type: textarea
+    id: problem
+    attributes:
+      label: What problem does this solve?
+      description: Describe the pain point or use case. "I'm trying to do X but I can't because..."
+    validations:
+      required: true
+
+  - type: textarea
+    id: solution
+    attributes:
+      label: Proposed solution
+      description: What would you like to see? How would it work?
+    validations:
+      required: true
+
+  - type: textarea
+    id: alternatives
+    attributes:
+      label: Alternatives considered
+      description: What have you tried or considered instead?
+
+  - type: dropdown
+    id: area
+    attributes:
+      label: Area
+      options:
+        - Cost analysis
+        - Anomaly detection
+        - LLM / AI features
+        - Alerts (Slack / email)
+        - Web UI
+        - CLI
+        - Snowflake integration
+        - Deployment / Docker
+        - Documentation
+        - Other
+    validations:
+      required: true
+
+  - type: checkboxes
+    id: contribution
+    attributes:
+      label: Contribution
+      options:
+        - label: I am willing to submit a PR for this feature

frostwatch-0.1.0/.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,41 @@
+## Summary
+
+<!-- One or two sentences describing what this PR does and why. -->
+
+Fixes # <!-- issue number, if applicable -->
+
+## Type of change
+
+- [ ] Bug fix (non-breaking change that fixes an issue)
+- [ ] New feature (non-breaking change that adds functionality)
+- [ ] Breaking change (fix or feature that would cause existing behaviour to change)
+- [ ] Documentation update
+- [ ] Refactor / internal improvement
+- [ ] CI / tooling
+
+## Changes
+
+<!-- Bullet-point list of what changed. Be specific — mention file names and function names where useful. -->
+
+-
+-
+
+## Testing
+
+<!-- Describe how you tested this change. -->
+
+- [ ] Unit tests added / updated (`pytest tests/`)
+- [ ] Manually tested locally
+- [ ] Frontend build passes (`cd frontend && npm run build`)
+- [ ] No new lint or type errors (`ruff check frostwatch/ && mypy frostwatch/`)
+
+## Screenshots (if UI change)
+
+<!-- Before / after screenshots help reviewers a lot. Delete this section if not applicable. -->
+
+## Checklist
+
+- [ ] PR title follows Conventional Commits format (`feat(scope): description`)
+- [ ] I have read [CONTRIBUTING.md](CONTRIBUTING.md)
+- [ ] My changes do not introduce new security vulnerabilities
+- [ ] I have updated documentation where relevant

frostwatch-0.1.0/.github/dependabot.yml

@@ -0,0 +1,71 @@
+version: 2
+
+updates:
+  - package-ecosystem: pip
+    directory: "/"
+    schedule:
+      interval: weekly
+      day: monday
+      time: "06:00"
+    open-pull-requests-limit: 5
+    labels:
+      - dependencies
+      - backend
+    ignore:
+      - dependency-name: "*"
+        update-types: ["version-update:semver-major"]
+    groups:
+      llm-providers:
+        patterns:
+          - "anthropic"
+          - "openai"
+          - "google-genai"
+      fastapi-stack:
+        patterns:
+          - "fastapi"
+          - "uvicorn"
+          - "pydantic*"
+          - "sqlalchemy"
+          - "aiosqlite"
+
+  - package-ecosystem: npm
+    directory: "/frontend"
+    schedule:
+      interval: weekly
+      day: monday
+      time: "06:00"
+    open-pull-requests-limit: 5
+    labels:
+      - dependencies
+      - frontend
+    ignore:
+      - dependency-name: "*"
+        update-types: ["version-update:semver-major"]
+    groups:
+      react:
+        patterns:
+          - "react"
+          - "react-dom"
+          - "react-router-dom"
+          - "@types/react*"
+      build-tools:
+        patterns:
+          - "vite"
+          - "@vitejs/*"
+          - "typescript"
+          - "tailwindcss"
+          - "postcss"
+          - "autoprefixer"
+
+  - package-ecosystem: github-actions
+    directory: "/"
+    schedule:
+      interval: weekly
+      day: monday
+      time: "06:00"
+    labels:
+      - dependencies
+      - ci
+    ignore:
+      - dependency-name: "*"
+        update-types: ["version-update:semver-major"]

frostwatch-0.1.0/.github/labeler.yml

@@ -0,0 +1,36 @@
+backend:
+  - changed-files:
+    - any-glob-to-any-file: "frostwatch/**/*"
+
+frontend:
+  - changed-files:
+    - any-glob-to-any-file: "frontend/src/**/*"
+
+ci:
+  - changed-files:
+    - any-glob-to-any-file: ".github/workflows/**/*"
+
+docs:
+  - changed-files:
+    - any-glob-to-any-file:
+      - "*.md"
+      - "docs/**/*"
+
+docker:
+  - changed-files:
+    - any-glob-to-any-file:
+      - "Dockerfile"
+      - "docker-compose.yml"
+
+dependencies:
+  - changed-files:
+    - any-glob-to-any-file:
+      - "pyproject.toml"
+      - "frontend/package.json"
+      - "frontend/package-lock.json"
+
+security:
+  - changed-files:
+    - any-glob-to-any-file:
+      - ".github/workflows/security.yml"
+      - "SECURITY.md"

frostwatch-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,121 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+concurrency:
+  group: ci-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  lint:
+    name: Lint & format (Python)
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+
+      - name: Install ruff
+        run: pip install ruff==0.4.10
+
+      - name: Check formatting
+        run: ruff format --check frostwatch/
+
+      - name: Lint
+        run: ruff check frostwatch/
+
+  typecheck:
+    name: Type check (Python)
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+
+      - name: Install package + mypy
+        run: |
+          pip install -e ".[dev]"
+          pip install mypy types-PyYAML types-aiofiles
+
+      - name: mypy
+        run: mypy frostwatch/ --ignore-missing-imports --no-strict-optional
+
+  test:
+    name: Unit tests (Python ${{ matrix.python-version }})
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.11", "3.13"]
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install package + test deps
+        run: pip install -e ".[dev]"
+
+      - name: Run tests
+        run: pytest tests/unit/ -v --cov=frostwatch --cov-report=xml --cov-report=term-missing
+
+      - name: Upload coverage
+        uses: codecov/codecov-action@v4
+        if: matrix.python-version == '3.11'
+        with:
+          files: coverage.xml
+          fail_ci_if_error: false
+
+  frontend:
+    name: Frontend build & type check
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: "20"
+          cache: "npm"
+          cache-dependency-path: frontend/package-lock.json
+
+      - name: Install dependencies
+        run: npm ci
+        working-directory: frontend
+
+      - name: Type check + build
+        run: npm run build
+        working-directory: frontend
+
+      - name: Upload dist artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: frontend-dist
+          path: frontend/dist/
+          retention-days: 7
+
+  docker-build:
+    name: Docker build (smoke test)
+    runs-on: ubuntu-latest
+    needs: [lint, typecheck, test, frontend]
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Download frontend dist
+        uses: actions/download-artifact@v4
+        with:
+          name: frontend-dist
+          path: frontend/dist/
+
+      - name: Build Docker image
+        run: docker build -t frostwatch:ci .
+
+      - name: Smoke test — frostwatch version
+        run: docker run --rm frostwatch:ci frostwatch version

frostwatch-0.1.0/.github/workflows/pr-checks.yml

@@ -0,0 +1,160 @@
+name: PR Checks
+
+on:
+  pull_request:
+    types: [opened, edited, synchronize, reopened, labeled, unlabeled]
+  pull_request_target:
+    types: [opened]
+
+permissions:
+  contents: read
+  pull-requests: write
+  issues: write
+
+jobs:
+  pr-title:
+    name: Conventional commit title
+    runs-on: ubuntu-latest
+    if: github.event_name == 'pull_request'
+    steps:
+      - name: Check PR title
+        uses: amannn/action-semantic-pull-request@v5
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        with:
+          types: |
+            feat
+            fix
+            docs
+            style
+            refactor
+            test
+            chore
+            ci
+            perf
+            revert
+            build
+          requireScope: false
+
+  pr-description:
+    name: PR description not empty
+    runs-on: ubuntu-latest
+    if: github.event_name == 'pull_request'
+    steps:
+      - name: Validate description
+        uses: actions/github-script@v7
+        with:
+          script: |
+            const body = context.payload.pull_request.body || '';
+            const stripped = body
+              .replace(/<!--.*?-->/gs, '')   // strip HTML comments (template hints)
+              .replace(/\[[ x]\]/g, '')      // strip checkboxes
+              .trim();
+            if (stripped.length < 30) {
+              core.setFailed(
+                'PR description is too short. Please fill in the Summary and Changes sections of the PR template.'
+              );
+            } else {
+              core.info('PR description looks good ✓');
+            }
+
+  size-label:
+    name: PR size label
+    runs-on: ubuntu-latest
+    if: github.event_name == 'pull_request'
+    steps:
+      - uses: codelytv/pr-size-labeler@v1
+        with:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          xs_label: "size/XS"
+          xs_max_size: 9
+          s_label: "size/S"
+          s_max_size: 99
+          m_label: "size/M"
+          m_max_size: 499
+          l_label: "size/L"
+          l_max_size: 999
+          xl_label: "size/XL"
+          fail_if_xl: false
+          message_if_xl: |
+            This PR is very large. Consider splitting it into smaller PRs for easier review.
+
+  labeler:
+    name: Auto-label by changed paths
+    runs-on: ubuntu-latest
+    if: github.event_name == 'pull_request'
+    steps:
+      - uses: actions/labeler@v5
+        with:
+          repo-token: ${{ secrets.GITHUB_TOKEN }}
+          configuration-path: .github/labeler.yml
+          sync-labels: true
+
+  check-changelog:
+    name: Remind about CHANGELOG
+    runs-on: ubuntu-latest
+    if: "github.event_name == 'pull_request' && !contains(github.event.pull_request.labels.*.name, 'skip-changelog')"
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Check if CHANGELOG.md was updated
+        run: |
+          if git diff --name-only origin/main...HEAD | grep -q "CHANGELOG.md"; then
+            echo "✅ CHANGELOG.md updated"
+          else
+            echo "::warning::CHANGELOG.md was not updated. Add a 'skip-changelog' label if this PR doesn't need a changelog entry."
+          fi
+
+  welcome-contributor:
+    name: Welcome first-time contributor
+    runs-on: ubuntu-latest
+    if: github.event_name == 'pull_request_target' && github.event.action == 'opened'
+    steps:
+      - name: Check contribution history
+        id: check
+        uses: actions/github-script@v7
+        with:
+          script: |
+            const { data: prs } = await github.rest.pulls.list({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              state: 'all',
+              per_page: 10,
+            });
+            const author = context.payload.pull_request.user.login;
+            const previous = prs.filter(
+              pr => pr.user.login === author && pr.number !== context.payload.pull_request.number
+            );
+            return previous.length === 0;
+          result-encoding: string
+
+      - name: Post welcome comment
+        if: steps.check.outputs.result == 'true'
+        uses: actions/github-script@v7
+        with:
+          script: |
+            const author = context.payload.pull_request.user.login;
+            await github.rest.issues.createComment({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              issue_number: context.payload.pull_request.number,
+              body: `👋 Welcome to FrostWatch, @${author}! Thanks for opening your first PR.
+
+            Here's what happens next:
+            1. **CI runs automatically** — lint, type check, unit tests (Python 3.11 + 3.13), frontend build, and Docker smoke test must all pass.
+            2. **A maintainer will review** your changes. Please make sure the PR template is filled in.
+            3. **Need help?** Check [CONTRIBUTING.md](../blob/main/CONTRIBUTING.md) or open a [Discussion](../../discussions).
+
+            Quick local checks before pushing:
+            \`\`\`bash
+            # Backend
+            ruff check frostwatch/ && mypy frostwatch/
+            pytest tests/unit/
+
+            # Frontend
+            cd frontend && npm run build
+            \`\`\`
+            `,
+            });