gristle 0.1.0__tar.gz

gristle-0.1.0/.dockerignore

@@ -0,0 +1,52 @@
+# Version control
+.git
+.gitignore
+
+# Python
+__pycache__
+*.pyc
+*.pyo
+*.egg-info
+dist
+build
+.eggs
+
+# Virtual environments
+.venv
+venv
+env
+
+# IDE
+.vscode
+.idea
+*.swp
+*.swo
+
+# Tests
+tests
+.pytest_cache
+.coverage
+htmlcov
+
+# Documentation (keep README.md for pyproject.toml metadata)
+*.md
+!README.md
+docs
+LICENSE
+
+# Docker
+Dockerfile
+docker-compose.yml
+.dockerignore
+
+# Environment and config
+.env
+.env.*
+!.env.example
+
+# Repos cloned during ingestion
+repos
+
+# OS
+.DS_Store
+Thumbs.db

gristle-0.1.0/.env.example

@@ -0,0 +1,21 @@
+# FalkorDB connection
+GRISTLE_FALKORDB_HOST=localhost
+GRISTLE_FALKORDB_PORT=6390
+GRISTLE_FALKORDB_PASSWORD=
+
+# Ingestion
+GRISTLE_MAX_FILE_SIZE_BYTES=512000
+GRISTLE_REPO_STORAGE_PATH=./repos
+GRISTLE_INGESTION_BATCH_SIZE=200
+
+# Transport: "stdio" for local MCP, "streamable-http" for remote/Railway
+GRISTLE_TRANSPORT=stdio
+GRISTLE_HTTP_HOST=0.0.0.0
+GRISTLE_HTTP_PORT=8080
+
+# Auth — set to enable bearer token auth on HTTP transport
+GRISTLE_API_KEY=
+
+# Logging — level: DEBUG, INFO, WARNING, ERROR | format: json, text (auto-detected if unset)
+GRISTLE_LOG_LEVEL=INFO
+GRISTLE_LOG_FORMAT=

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

@@ -0,0 +1,90 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.11", "3.12", "3.13"]
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Cache pip packages
+        uses: actions/cache@v4
+        with:
+          path: ~/.cache/pip
+          key: ${{ runner.os }}-pip-${{ matrix.python-version }}-${{ hashFiles('pyproject.toml') }}
+          restore-keys: |
+            ${{ runner.os }}-pip-${{ matrix.python-version }}-
+
+      - name: Install dependencies
+        run: pip install -e ".[dev]"
+
+      - name: Run tests
+        run: pytest --tb=short -q
+
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.13"
+
+      - name: Install ruff
+        run: pip install ruff
+
+      - name: Check formatting
+        run: ruff format --check src/ tests/
+
+      - name: Lint
+        run: ruff check src/ tests/
+
+  typecheck:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.13"
+
+      - name: Install dependencies
+        run: pip install -e ".[dev]"
+
+      - name: Type check
+        run: mypy src/
+
+  docker:
+    runs-on: ubuntu-latest
+    needs: test
+    if: github.ref == 'refs/heads/main'
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Build Docker image
+        run: docker build -t gristle:test .
+
+      - name: Verify health endpoint exists
+        run: |
+          docker run -d --name gristle-test \
+            -e GRISTLE_TRANSPORT=streamable-http \
+            -e GRISTLE_FALKORDB_HOST=localhost \
+            -p 8080:8080 \
+            gristle:test
+          sleep 5
+          curl -sf http://localhost:8080/health || echo "Health check failed (expected without FalkorDB)"
+          docker stop gristle-test

gristle-0.1.0/.github/workflows/release.yml

@@ -0,0 +1,64 @@
+name: Release
+
+# Publishes a release when a vX.Y.Z tag is pushed:
+#   - PyPI wheel/sdist via OIDC trusted publishing (no stored token)
+#   - multi-tag Docker image to GitHub Container Registry (ghcr.io)
+#
+# One-time setup before the first release:
+#   1. On PyPI, configure a "trusted publisher" for this repo + the `pypi`
+#      environment (https://docs.pypi.org/trusted-publishers/).
+#   2. Bump __version__ in src/gristle/__init__.py, commit, then:
+#        git tag v0.1.0 && git push origin v0.1.0
+
+on:
+  push:
+    tags: ["v*"]
+
+permissions:
+  contents: read
+
+jobs:
+  pypi:
+    name: Publish to PyPI
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      id-token: write # OIDC trusted publishing
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.13"
+      - name: Build sdist and wheel
+        run: |
+          python -m pip install --upgrade build
+          python -m build
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+
+  docker:
+    name: Publish image to GHCR
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      packages: write
+    steps:
+      - uses: actions/checkout@v4
+      - uses: docker/login-action@v3
+        with:
+          registry: ghcr.io
+          username: ${{ github.actor }}
+          password: ${{ secrets.GITHUB_TOKEN }}
+      - uses: docker/metadata-action@v5
+        id: meta
+        with:
+          images: ghcr.io/alchemy-agentic/gristle
+          tags: |
+            type=semver,pattern={{version}}
+            type=raw,value=latest
+      - uses: docker/build-push-action@v6
+        with:
+          context: .
+          push: true
+          tags: ${{ steps.meta.outputs.tags }}
+          labels: ${{ steps.meta.outputs.labels }}

gristle-0.1.0/.gitignore

@@ -0,0 +1,44 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.egg-info/
+*.eggs/
+dist/
+build/
+*.egg
+
+# Virtual environments
+.venv/
+venv/
+env/
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+
+# Environment
+.env
+
+# Testing
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+.tox/
+htmlcov/
+.coverage
+
+# OS
+Thumbs.db
+.DS_Store
+
+# Repos storage
+repos/
+
+# Claude Code
+.claude/
+
+# Misc artifacts
+nul