upstrace 0.1.0__tar.gz

upstrace-0.1.0/.dockerignore

@@ -0,0 +1,17 @@
+.venv/
+__pycache__/
+*.egg-info/
+build/
+dist/
+.git/
+.env
+.DS_Store
+warehouse/
+data/*.parquet
+!data/demo/
+app/node_modules/
+app/static/
+transform/target/
+transform/dbt_packages/
+transform/logs/
+docs/*.png

upstrace-0.1.0/.env.example

@@ -0,0 +1,11 @@
+# Copy this file to .env and fill in your own key.
+# Free key: https://console.groq.com  (no card required)
+
+GROQ_API_KEY=
+UPSTRACE_LLM_PROVIDER=groq
+
+# Alternatives:
+# GEMINI_API_KEY=            # https://aistudio.google.com
+# UPSTRACE_LLM_PROVIDER=gemini
+# UPSTRACE_LLM_PROVIDER=ollama   # local, no key needed
+# UPSTRACE_LLM_MODEL=            # override the default model

upstrace-0.1.0/.github/workflows/nightly.yml

@@ -0,0 +1,87 @@
+name: nightly
+
+on:
+  schedule:
+    - cron: "0 6 * * *"
+  push:
+    branches: [main]
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: pages
+  cancel-in-progress: false
+
+jobs:
+  self-check:
+    name: Detects a real fault, and nothing else
+    runs-on: ubuntu-latest
+    
+    environment:
+      name: github-pages
+      url: ${{ steps.deploy.outputs.page_url }}
+
+    env:
+      GROQ_API_KEY: ${{ secrets.GROQ_API_KEY }}
+      UPSTRACE_LLM_PROVIDER: groq
+      UPSTRACE_LLM_MODEL: qwen/qwen3.8-27b
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+
+      - name: Install
+        run: pip install -e . "dbt-core==1.10.*" "dbt-duckdb==1.9.*"
+
+      - name: Build the demo warehouse
+        run: |
+          cp data/demo/*.parquet data/
+          python scripts/build_demo_warehouse.py
+
+      # Half the value of a data quality tool is not crying wolf. This asserts
+      # that two profile runs over unchanged data produce nothing at all - not
+      # even a warning.
+      
+      - name: No false positives on unchanged data
+        run: upstrace drift --fail-on warning
+
+      # The other half is actually catching something. A green badge that only
+      # proved the tool stays quiet would be worthless.
+      
+      - name: A real fault is detected
+        run: |
+          upstrace fault unit-change
+          cd transform && dbt run --profiles-dir . && cd ..
+          upstrace profile
+          if upstrace drift --fail-on critical; then
+            echo "::error::A unit change was injected and no critical signal was raised."
+            exit 1
+          fi
+          echo "Fault detected, as expected."
+
+      - name: Root cause
+        run: upstrace rca
+
+      # The warehouse still holds the injected fault, so the published page shows
+      # a real incident rather than an empty all-clear.
+      
+      - name: Build the report
+        run: |
+          mkdir -p site
+          upstrace report -o site/index.html
+
+      - uses: actions/configure-pages@v5
+
+      - uses: actions/upload-pages-artifact@v3
+        with:
+          path: site
+
+      - id: deploy
+        uses: actions/deploy-pages@v4

upstrace-0.1.0/.gitignore

@@ -0,0 +1,19 @@
+.venv/
+__pycache__/
+*.pyc
+data/*
+!data/demo/
+data/demo/*
+!data/demo/*.parquet
+warehouse/
+.env
+.DS_Store
+transform/target/
+transform/dbt_packages/
+transform/logs/
+*.egg-info/
+build/
+dist/
+app/node_modules/
+app/static/
+cache/

upstrace-0.1.0/Dockerfile

@@ -0,0 +1,61 @@
+# ---- stage 1: build the React SPA -------------------------------------------
+FROM node:22-slim AS frontend
+WORKDIR /app
+COPY app/package.json app/package-lock.json ./
+RUN npm ci
+COPY app/ ./
+RUN npm run build
+
+# ---- stage 2: the tool, with no data of its own -----------------------------
+# Build this one to run Upstrace against your own dbt project:
+#   docker build --target runtime -t upstrace .
+#   docker run -v /path/to/your/project:/project -w /project \
+#     -p 7860:7860 upstrace uvicorn upstrace.api:app --host 0.0.0.0 --port 7860
+# upstrace.yml is discovered by walking up from the working directory, and every
+# path inside it resolves relative to that file - so the mounted project's
+# warehouse and dbt project are found, while the package stays at /srv.
+FROM python:3.11-slim AS runtime
+
+ENV PYTHONUNBUFFERED=1 \
+    PIP_NO_CACHE_DIR=1 \
+    UPSTRACE_LLM_PROVIDER=mock
+
+WORKDIR /srv
+
+COPY pyproject.toml README.md ./
+COPY src/ src/
+
+# Editable install, deliberately. It keeps the package rooted at /srv, so
+# PROJECT_ROOT still resolves to the repo - app/static where the API expects it.
+# A normal install would move the package to site-packages and break that.
+RUN pip install -e . "dbt-core==1.10.*" "dbt-duckdb==1.9.*"
+
+COPY --from=frontend /app/static app/static
+
+RUN useradd -m -u 1000 user && chown -R user:user /srv
+USER user
+
+EXPOSE 7860
+CMD ["uvicorn", "upstrace.api:app", "--host", "0.0.0.0", "--port", "7860"]
+
+# ---- stage 3: the public demo -----------------------------------------------
+# Same tool, plus a 400k-row sample of the NYC taxi data and a warehouse built
+# at image build time. This is what Hugging Face Spaces runs: it starts in under
+# a second and needs no external data source.
+FROM runtime AS demo
+
+USER root
+
+COPY upstrace.yml ./
+COPY transform/ transform/
+COPY scripts/ scripts/
+COPY cache/ cache/
+COPY data/demo/yellow_tripdata_demo.parquet data/
+
+RUN python scripts/build_demo_warehouse.py
+
+RUN chown -R user:user /srv
+USER user
+
+EXPOSE 7860
+CMD ["uvicorn", "upstrace.api:app", "--host", "0.0.0.0", "--port", "7860"]

upstrace-0.1.0/LICENSE

@@ -0,0 +1,9 @@
+MIT License
+
+Copyright (c) 2026 Ashwin Gururaj
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.