mithai 0.12.0__tar.gz

mithai-0.12.0/.dockerignore

@@ -0,0 +1,23 @@
+.git
+.gitignore
+.github
+.claude
+.env
+.env.*
+.venv
+.mithai
+__pycache__
+*.pyc
+*.pyo
+*.pyd
+*.egg-info
+dist/
+build/
+deploy/
+tests/
+docs/
+docs-site/
+memory/
+TESTING.md
+SPEC-*.md
+uv.lock

mithai-0.12.0/.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,31 @@
+name: Bug report
+description: Report a reproducible problem in Mithai.
+labels: ["bug"]
+body:
+  - type: textarea
+    id: summary
+    attributes:
+      label: Summary
+      description: What happened?
+    validations:
+      required: true
+  - type: textarea
+    id: reproduce
+    attributes:
+      label: Reproduction
+      description: Steps, config shape, and commands needed to reproduce.
+    validations:
+      required: true
+  - type: textarea
+    id: expected
+    attributes:
+      label: Expected behavior
+    validations:
+      required: true
+  - type: textarea
+    id: environment
+    attributes:
+      label: Environment
+      description: Mithai version, Python version, OS, adapter, and LLM provider.
+    validations:
+      required: true

mithai-0.12.0/.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,5 @@
+blank_issues_enabled: false
+contact_links:
+  - name: Security reports
+    url: mailto:security@last9.io
+    about: Report vulnerabilities privately.

mithai-0.12.0/.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,23 @@
+name: Feature request
+description: Propose an improvement or new capability.
+labels: ["enhancement"]
+body:
+  - type: textarea
+    id: problem
+    attributes:
+      label: Problem
+      description: What user workflow or operational need is blocked?
+    validations:
+      required: true
+  - type: textarea
+    id: proposal
+    attributes:
+      label: Proposal
+      description: What should Mithai do differently?
+    validations:
+      required: true
+  - type: textarea
+    id: alternatives
+    attributes:
+      label: Alternatives
+      description: Any workarounds or designs considered?

mithai-0.12.0/.github/ISSUE_TEMPLATE/security.md

@@ -0,0 +1,9 @@
+---
+name: Security report
+about: Do not file public security issues.
+labels: security
+---
+
+Please do not include vulnerability details in a public issue.
+
+Email security@last9.io with the affected version or commit, reproduction steps, impact, and logs with secrets removed.

mithai-0.12.0/.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,8 @@
+## Summary
+
+## Testing
+
+## Notes
+
+- [ ] I did not commit secrets, runtime state, `.env`, `.mithai/`, `.wrangler/`, or `memory/`.
+- [ ] I updated docs for user-facing behavior or configuration changes.

mithai-0.12.0/.github/dependabot.yml

@@ -0,0 +1,10 @@
+version: 2
+updates:
+  - package-ecosystem: "pip"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+  - package-ecosystem: "npm"
+    directory: "/docs-site"
+    schedule:
+      interval: "weekly"

mithai-0.12.0/.github/workflows/ci.yml

@@ -0,0 +1,65 @@
+name: CI
+
+on:
+  push:
+    branches: [master, main]
+  pull_request:
+    branches: [master, main]
+
+jobs:
+  test:
+    name: Test (Python ${{ matrix.python-version }})
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.11", "3.12", "3.13"]
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v4
+        with:
+          version: "latest"
+
+      - name: Set up Python ${{ matrix.python-version }}
+        run: uv python install ${{ matrix.python-version }}
+
+      - name: Install dependencies
+        run: uv sync --all-extras
+
+      - name: Lint
+        run: uv run ruff check src/ tests/
+
+      - name: Run tests
+        run: uv run pytest tests/ -v
+
+  build-smoke:
+    name: Binary smoke test
+    runs-on: ubuntu-latest
+    needs: test
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v4
+        with:
+          version: "latest"
+
+      - name: Set up Python
+        run: uv python install 3.13
+
+      - name: Install dependencies
+        run: uv sync --all-extras
+
+      - name: Build binary
+        run: |
+          uv run pyinstaller mithai.spec --noconfirm
+          ls -lh dist/mithai-*
+
+      - name: Smoke test
+        run: |
+          BINARY=$(ls dist/mithai-*)
+          chmod +x "$BINARY"
+          "$BINARY" --version
+          "$BINARY" --help

mithai-0.12.0/.github/workflows/docs.yml

@@ -0,0 +1,50 @@
+name: Deploy docs
+
+on:
+  push:
+    branches: [master]
+    paths:
+      - 'docs/**'
+      - 'docs-site/**'
+  pull_request:
+    paths:
+      - 'docs/**'
+      - 'docs-site/**'
+
+jobs:
+  build-and-deploy:
+    name: Build and deploy docs
+    runs-on: ubuntu-latest
+    env:
+      CLOUDFLARE_API_TOKEN: ${{ secrets.CLOUDFLARE_API_TOKEN }}
+      CLOUDFLARE_ACCOUNT_ID: ${{ secrets.CLOUDFLARE_ACCOUNT_ID }}
+    permissions:
+      contents: read
+      deployments: write
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Migrate docs to Starlight content
+        run: python3 docs-site/migrate.py
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 22
+          cache: npm
+          cache-dependency-path: docs-site/package-lock.json
+
+      - name: Install dependencies
+        run: npm ci --legacy-peer-deps
+        working-directory: docs-site
+
+      - name: Build
+        run: npm run build
+        working-directory: docs-site
+
+      - name: Deploy to Cloudflare Pages
+        if: github.event_name == 'push' && github.ref == 'refs/heads/master' && env.CLOUDFLARE_API_TOKEN != '' && env.CLOUDFLARE_ACCOUNT_ID != ''
+        uses: cloudflare/wrangler-action@v3
+        with:
+          apiToken: ${{ env.CLOUDFLARE_API_TOKEN }}
+          accountId: ${{ env.CLOUDFLARE_ACCOUNT_ID }}
+          command: pages deploy docs-site/dist --project-name=mithai-docs --branch=${{ github.ref_name }}

mithai-0.12.0/.github/workflows/promote-stable.yml

@@ -0,0 +1,87 @@
+name: Promote to Stable
+
+on:
+  workflow_dispatch:
+    inputs:
+      tag:
+        description: "Tag to promote as stable (e.g. v0.4.0)"
+        required: true
+        type: string
+
+permissions:
+  contents: write
+
+jobs:
+  promote:
+    name: Promote ${{ inputs.tag }} to stable
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Validate tag exists
+        env:
+          TAG: ${{ inputs.tag }}
+        run: |
+          if ! git rev-parse "refs/tags/$TAG" >/dev/null 2>&1; then
+            echo "::error::Tag $TAG does not exist"
+            exit 1
+          fi
+
+      - name: Validate release exists
+        env:
+          TAG: ${{ inputs.tag }}
+          GH_TOKEN: ${{ github.token }}
+        run: |
+          if ! gh release view "$TAG" >/dev/null 2>&1; then
+            echo "::error::No GitHub release found for $TAG. Run the release workflow first."
+            exit 1
+          fi
+
+      - name: Download assets from tagged release
+        env:
+          TAG: ${{ inputs.tag }}
+          GH_TOKEN: ${{ github.token }}
+        run: |
+          mkdir -p stable-assets/
+          gh release download "$TAG" --dir stable-assets/
+          echo "=== Downloaded assets ==="
+          ls -lh stable-assets/
+
+      - name: Create or update stable release
+        env:
+          TAG: ${{ inputs.tag }}
+          GH_TOKEN: ${{ github.token }}
+          REPO: ${{ github.repository }}
+        run: |
+          # Get the tagged release notes
+          ORIGINAL_NOTES=$(gh release view "$TAG" --json body --jq .body)
+
+          # Build stable release notes
+          STABLE_NOTES=$(cat <<EOF
+          ## Stable Release
+
+          Promoted from [\`$TAG\`](https://github.com/$REPO/releases/tag/$TAG).
+
+          ---
+
+          $ORIGINAL_NOTES
+          EOF
+          )
+
+          # Delete existing stable release if present
+          gh release delete stable --yes 2>/dev/null || true
+          git push origin :refs/tags/stable 2>/dev/null || true
+
+          # Create stable tag pointing to the same commit as the source tag
+          TAG_SHA=$(git rev-parse "refs/tags/$TAG")
+          git tag -f stable "$TAG_SHA"
+          git push origin stable --force
+
+          # Create the stable release with the same assets
+          gh release create stable \
+            --title "stable ($TAG)" \
+            --notes "$STABLE_NOTES" \
+            --latest \
+            stable-assets/*

mithai-0.12.0/.github/workflows/release.yml

@@ -0,0 +1,311 @@
+name: Release
+
+on:
+  push:
+    tags:
+      - 'v*'
+
+  # Keep manual trigger for dry runs
+  workflow_dispatch:
+    inputs:
+      dry_run:
+        description: "Dry run — build everything but don't publish"
+        required: false
+        type: boolean
+        default: true
+
+permissions:
+  contents: write
+  packages: write
+
+jobs:
+  # ── Extract version from tag or pyproject.toml ──
+  meta:
+    name: Extract version
+    runs-on: ubuntu-latest
+    outputs:
+      version: ${{ steps.ver.outputs.version }}
+      is_tag: ${{ steps.ver.outputs.is_tag }}
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Determine version
+        id: ver
+        run: |
+          if [[ "$GITHUB_REF" == refs/tags/v* ]]; then
+            TAG_VERSION="${GITHUB_REF#refs/tags/}"
+            echo "version=$TAG_VERSION" >> "$GITHUB_OUTPUT"
+            echo "is_tag=true" >> "$GITHUB_OUTPUT"
+          else
+            PY_VERSION="v$(python3 -c "import tomllib; print(tomllib.load(open('pyproject.toml','rb'))['project']['version'])")"
+            echo "version=$PY_VERSION" >> "$GITHUB_OUTPUT"
+            echo "is_tag=false" >> "$GITHUB_OUTPUT"
+          fi
+
+      - name: Verify pyproject.toml matches tag
+        if: startsWith(github.ref, 'refs/tags/v')
+        run: |
+          PY_VERSION="v$(python3 -c "import tomllib; print(tomllib.load(open('pyproject.toml','rb'))['project']['version'])")"
+          TAG_VERSION="${GITHUB_REF#refs/tags/}"
+          if [ "$PY_VERSION" != "$TAG_VERSION" ]; then
+            echo "::error::pyproject.toml version ($PY_VERSION) does not match tag ($TAG_VERSION)"
+            exit 1
+          fi
+
+  # ── Fast Linux test job ──
+  test:
+    name: Test (linux-amd64)
+    needs: meta
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v4
+        with:
+          version: "latest"
+
+      - name: Set up Python
+        run: uv python install 3.13
+
+      - name: Install dependencies
+        run: uv sync --all-extras
+
+      - name: Run tests
+        run: uv run pytest tests/ -v
+
+  # ── Build platform binaries ──
+  build-binaries:
+    name: Build ${{ matrix.platform }}
+    needs: meta
+    runs-on: ${{ matrix.runner }}
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - runner: macos-14
+            platform: darwin-arm64
+          - runner: ubuntu-latest
+            platform: linux-amd64
+          - runner: ubuntu-24.04-arm
+            platform: linux-arm64
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v4
+        with:
+          version: "latest"
+
+      - name: Set up Python
+        run: uv python install 3.13
+
+      - name: Install dependencies
+        run: uv sync --all-extras
+
+      - name: Run tests
+        run: uv run pytest tests/ -v
+
+      - name: Build binary
+        run: |
+          uv run pyinstaller mithai.spec --noconfirm
+          ls -lh dist/mithai-*
+
+      - name: Smoke test binary
+        shell: bash
+        run: |
+          BINARY=$(ls dist/mithai-*)
+          chmod +x "$BINARY" 2>/dev/null || true
+          "$BINARY" --version
+          "$BINARY" --help
+          echo "Smoke tests passed for $BINARY"
+
+      - name: Upload artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: mithai-${{ matrix.platform }}
+          path: dist/mithai-*
+          if-no-files-found: error
+
+  # ── Build Python package ──
+  build-python-package:
+    name: Build Python package
+    needs: [meta, test]
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v4
+        with:
+          version: "latest"
+
+      - name: Set up Python
+        run: uv python install 3.13
+
+      - name: Build wheel and sdist
+        run: uv build
+
+      - name: Validate package metadata
+        run: uvx twine check dist/*
+
+      - name: Upload Python package artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: python-dist
+          path: dist/*
+          if-no-files-found: error
+
+  # ── Build and publish container image ──
+  build-container:
+    name: Build container image
+    needs: [meta, test]
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      packages: write
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Docker Buildx
+        uses: docker/setup-buildx-action@v3
+
+      - name: Log in to GitHub Container Registry
+        if: ${{ needs.meta.outputs.is_tag == 'true' && !inputs.dry_run }}
+        uses: docker/login-action@v3
+        with:
+          registry: ghcr.io
+          username: ${{ github.actor }}
+          password: ${{ github.token }}
+
+      - name: Extract image metadata
+        id: meta
+        uses: docker/metadata-action@v5
+        with:
+          images: ghcr.io/last9/mithai
+          tags: |
+            type=semver,pattern={{version}},value=${{ needs.meta.outputs.version }}
+            type=semver,pattern={{major}}.{{minor}},value=${{ needs.meta.outputs.version }}
+            type=raw,value=latest,enable=${{ needs.meta.outputs.is_tag == 'true' }}
+
+      - name: Build and optionally push image
+        uses: docker/build-push-action@v6
+        with:
+          context: .
+          file: deploy/Dockerfile
+          platforms: linux/amd64
+          push: ${{ needs.meta.outputs.is_tag == 'true' && !inputs.dry_run }}
+          tags: ${{ steps.meta.outputs.tags }}
+          labels: ${{ steps.meta.outputs.labels }}
+          cache-from: type=gha
+          cache-to: type=gha,mode=max
+
+  # ── Publish Python package ──
+  publish-pypi:
+    name: Publish to PyPI
+    needs: [meta, build-python-package]
+    if: ${{ needs.meta.outputs.is_tag == 'true' && !inputs.dry_run }}
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/project/mithai/
+    permissions:
+      contents: read
+    steps:
+      - name: Verify PYPI_API_TOKEN is configured
+        env:
+          PYPI_API_TOKEN: ${{ secrets.PYPI_API_TOKEN }}
+        run: |
+          if [ -z "$PYPI_API_TOKEN" ]; then
+            echo "::error::PYPI_API_TOKEN secret is required to publish mithai to PyPI"
+            exit 1
+          fi
+
+      - name: Download Python package artifact
+        uses: actions/download-artifact@v4
+        with:
+          name: python-dist
+          path: dist/
+
+      - name: Publish package distributions to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          password: ${{ secrets.PYPI_API_TOKEN }}
+
+  # ── Create GitHub Release ──
+  release:
+    name: Create GitHub Release
+    needs: [meta, build-binaries, build-container, publish-pypi]
+    if: ${{ needs.meta.outputs.is_tag == 'true' && !inputs.dry_run }}
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Download binary artifacts
+        uses: actions/download-artifact@v4
+        with:
+          pattern: mithai-*
+          path: artifacts/
+
+      - name: Prepare release assets
+        run: |
+          mkdir -p release/
+          find artifacts/ -name 'mithai-*' -type f -exec mv {} release/ \;
+          chmod +x release/mithai-* 2>/dev/null || true
+
+          cd release
+          sha256sum mithai-* > checksums.txt 2>/dev/null || shasum -a 256 mithai-* > checksums.txt
+          echo "=== Release assets ==="
+          ls -lh
+          echo ""
+          echo "=== Checksums ==="
+          cat checksums.txt
+
+      - name: Generate release notes
+        id: notes
+        env:
+          RELEASE_VERSION: ${{ needs.meta.outputs.version }}
+        run: |
+          PREV_TAG=$(git describe --tags --abbrev=0 HEAD^ 2>/dev/null || echo "")
+
+          {
+            echo "NOTES<<EOF"
+            echo "## Mithai ${RELEASE_VERSION}"
+            echo ""
+            echo "### What's changed"
+            echo ""
+            if [ -n "$PREV_TAG" ]; then
+              git log --pretty=format:"- %s" "${PREV_TAG}..HEAD" -- | head -30
+            else
+              git log --pretty=format:"- %s" -20
+            fi
+            echo ""
+            echo ""
+            echo "### Checksums (SHA256)"
+            echo ""
+            echo '```'
+            cat release/checksums.txt
+            echo '```'
+            echo "EOF"
+          } >> "$GITHUB_OUTPUT"
+
+      - name: Create GitHub Release
+        env:
+          RELEASE_VERSION: ${{ needs.meta.outputs.version }}
+          RELEASE_NOTES: ${{ steps.notes.outputs.NOTES }}
+          GH_TOKEN: ${{ github.token }}
+        run: |
+          PRERELEASE_FLAG=""
+          case "$RELEASE_VERSION" in
+            *-*) PRERELEASE_FLAG="--prerelease" ;;
+          esac
+
+          gh release create "$RELEASE_VERSION" \
+            --title "$RELEASE_VERSION" \
+            --notes "$RELEASE_NOTES" \
+            $PRERELEASE_FLAG \
+            release/mithai-* \
+            release/checksums.txt

mithai-0.12.0/.gitignore

@@ -0,0 +1,31 @@
+.env
+.claude/
+.mithai/
+.wrangler/
+.venv/
+/memory/
+__pycache__/
+*.pyc
+*.pyo
+*.egg-info/
+dist/
+build/
+.eggs/
+.pytest_cache/
+.ruff_cache/
+*.egg
+deploy/k8s/secret.yaml
+deploy/helm/values-private.yaml
+ideas/
+
+# Docs site
+docs-site/node_modules/
+docs-site/.astro/
+docs-site/dist/
+docs-site/src/content/docs/
+.DS_Store
+
+# Local binaries
+/mithai
+/mithai-*
+!mithai*.spec

mithai-0.12.0/AUTHORS

@@ -0,0 +1,11 @@
+# Authors
+
+Mithai's public history includes contributions from:
+
+- Nishant Modak <nishantmodak@users.noreply.github.com>
+- Prathamesh Sonpatki <csonpatki@gmail.com>
+- Shekhar Patil <cshekhar.patil@gmail.com>
+- Sahil Khan <1988.sahil@gmail.com>
+- Kapil Neurgaonkar <kapil.neurgaonkar@gmail.com>
+
+Automated dependency updates may appear from dependabot[bot].

mithai-0.12.0/CHANGELOG.md

@@ -0,0 +1,9 @@
+# Changelog
+
+All notable public changes will be documented here.
+
+## 0.12.0
+
+- Prepare Mithai for open-source publication.
+- Sanitize public history and remove private infrastructure defaults.
+- Add community health files and public-safe release defaults.