fathom-rules 0.3.0__tar.gz → 0.3.2__tar.gz

fathom_rules-0.3.2/.codespellignore

@@ -0,0 +1,19 @@
+clips
+clipspy
+deftemplate
+defrule
+defmodule
+deffunction
+rete
+salience
+cuid
+pii
+phi
+nist
+hipaa
+cmmc
+owasp
+mkdocs
+pdoc
+gomarkdoc
+typedoc

fathom_rules-0.3.2/.github/FUNDING.yml

@@ -0,0 +1 @@
+github: KrakenNet

fathom_rules-0.3.2/.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,81 @@
+name: Bug Report
+description: Report a bug in fathom-rules
+labels: ["bug"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for reporting a bug! Please fill out the sections below.
+  - type: textarea
+    id: description
+    attributes:
+      label: Description
+      description: A clear description of the bug.
+    validations:
+      required: true
+  - type: textarea
+    id: reproduction
+    attributes:
+      label: Steps to Reproduce
+      description: Minimal code or steps to reproduce the issue.
+      render: python
+    validations:
+      required: true
+  - type: textarea
+    id: expected
+    attributes:
+      label: Expected Behavior
+      description: What you expected to happen.
+    validations:
+      required: true
+  - type: textarea
+    id: actual
+    attributes:
+      label: Actual Behavior
+      description: What actually happened. Include tracebacks if applicable.
+    validations:
+      required: true
+  - type: input
+    id: version
+    attributes:
+      label: Fathom Version
+      description: "Output of: python -c 'import fathom; print(fathom.__version__)'"
+      placeholder: "0.3.1"
+    validations:
+      required: true
+  - type: input
+    id: python-version
+    attributes:
+      label: Python Version
+      description: "Output of: python --version"
+      placeholder: "3.13.0"
+    validations:
+      required: true
+  - type: input
+    id: os
+    attributes:
+      label: Operating System
+      placeholder: "Ubuntu 24.04 / macOS 15 / Windows 11"
+    validations:
+      required: true
+  - type: dropdown
+    id: component
+    attributes:
+      label: Component
+      options:
+        - Core Engine
+        - YAML Compiler
+        - REST Server (FastAPI)
+        - gRPC Server
+        - MCP Server
+        - CLI
+        - Rule Pack (OWASP/NIST/HIPAA/CMMC)
+        - LangChain Integration
+        - CrewAI Integration
+        - OpenAI Agents Integration
+        - Google ADK Integration
+        - Attestation
+        - Fleet (Redis/Postgres)
+        - Other
+    validations:
+      required: true

fathom_rules-0.3.2/.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,8 @@
+blank_issues_enabled: true
+contact_links:
+  - name: Documentation
+    url: https://fathom.krakn.ai
+    about: Check the docs before opening an issue
+  - name: Discussions
+    url: https://github.com/KrakenNet/fathom/discussions
+    about: Ask questions and discuss ideas

fathom_rules-0.3.2/.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,44 @@
+name: Feature Request
+description: Suggest a new feature or improvement
+labels: ["enhancement"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for suggesting an improvement! Please describe the use case.
+  - type: textarea
+    id: problem
+    attributes:
+      label: Problem or Use Case
+      description: What problem does this solve? What use case does it enable?
+    validations:
+      required: true
+  - type: textarea
+    id: solution
+    attributes:
+      label: Proposed Solution
+      description: How do you think this should work?
+    validations:
+      required: true
+  - type: textarea
+    id: alternatives
+    attributes:
+      label: Alternatives Considered
+      description: Any alternative approaches you've considered.
+  - type: dropdown
+    id: component
+    attributes:
+      label: Component
+      options:
+        - Core Engine
+        - YAML Compiler
+        - REST Server (FastAPI)
+        - gRPC Server
+        - MCP Server
+        - CLI
+        - Rule Packs
+        - SDK (Python/Go/TypeScript)
+        - Documentation
+        - Other
+    validations:
+      required: true

fathom_rules-0.3.2/.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,23 @@
+## Summary
+
+<!-- What does this PR do? Why? -->
+
+## Changes
+
+<!-- Bullet list of key changes -->
+
+-
+
+## Testing
+
+<!-- How was this tested? -->
+
+- [ ] `uv run pytest` passes
+- [ ] `uv run ruff check src/ tests/` passes
+- [ ] `uv run mypy src/` passes
+- [ ] New tests added for new functionality
+- [ ] Documentation updated (if applicable)
+
+## Related Issues
+
+<!-- Link related issues: Fixes #123, Relates to #456 -->

fathom_rules-0.3.2/.github/dependabot.yml

@@ -0,0 +1,17 @@
+version: 2
+updates:
+  - package-ecosystem: "pip"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+    labels:
+      - "dependencies"
+    open-pull-requests-limit: 10
+
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+    labels:
+      - "dependencies"
+      - "ci"

fathom_rules-0.3.2/.github/workflows/ci.yml

@@ -0,0 +1,72 @@
+name: CI
+
+on:
+  pull_request:
+  push:
+    branches: [main]
+
+concurrency:
+  group: ci-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  test:
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest]
+        python-version: ["3.12", "3.13"]
+        include:
+          - os: windows-latest
+            python-version: "3.13"
+          - os: macos-latest
+            python-version: "3.13"
+    timeout-minutes: 15
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v3
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install dependencies
+        run: uv sync --all-extras
+
+      - name: Run tests with coverage
+        run: uv run pytest --cov=fathom --cov-report=xml --cov-report=term-missing -q
+
+      - name: Upload coverage
+        if: matrix.os == 'ubuntu-latest' && matrix.python-version == '3.13'
+        uses: codecov/codecov-action@v4
+        with:
+          files: coverage.xml
+          token: ${{ secrets.CODECOV_TOKEN }}
+          fail_ci_if_error: false
+
+  lint:
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v3
+        with:
+          python-version: "3.13"
+
+      - name: Install dependencies
+        run: uv sync --all-extras
+
+      - name: Ruff check
+        run: uv run ruff check src/ tests/
+
+      - name: Ruff format check
+        run: uv run ruff format --check src/ tests/
+
+      - name: mypy
+        run: uv run mypy src/
+
+      - name: Version sync
+        run: uv run python scripts/check_version_sync.py

fathom_rules-0.3.2/.github/workflows/docs-deploy.yml

@@ -0,0 +1,96 @@
+name: docs-deploy
+
+on:
+  push:
+    tags:
+      - "v*.*.*"
+  workflow_dispatch:
+    inputs:
+      version:
+        description: "mike version alias (e.g. 0.3 or latest)"
+        required: true
+        default: "latest"
+
+permissions:
+  contents: write
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    timeout-minutes: 20
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v3
+        with:
+          python-version: "3.13"
+
+      - name: Install protoc
+        uses: arduino/setup-protoc@v3
+        with:
+          version: "27.3"
+          repo-token: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Set up Go
+        uses: actions/setup-go@v5
+        with:
+          go-version: "1.24"
+
+      - name: Install protoc-gen-doc
+        run: go install github.com/pseudomuto/protoc-gen-doc/cmd/protoc-gen-doc@v1.5.1
+
+      - name: Install Node
+        uses: actions/setup-node@v4
+        with:
+          node-version: "20"
+
+      - name: Install pnpm
+        uses: pnpm/action-setup@v4
+        with:
+          version: 9
+      
+      - name: Set up Python
+        uses: actions/setup-python@v5                                                                                                                                                
+        with:
+          python-version: "3.13"  
+      
+      - name: Install Python deps
+        run: uv sync --extra docs --extra server --extra mcp
+
+      - name: Generate everything
+        run: |
+          make docs-gen
+          make docs-gen-foreign
+
+      - name: Configure git for mike
+        run: |
+          git config user.name "docs-bot"
+          git config user.email "docs-bot@users.noreply.github.com"
+
+      - name: Resolve version label
+        id: label
+        run: |
+          if [ "${{ github.event_name }}" = "workflow_dispatch" ]; then
+            echo "version=${{ inputs.version }}" >> "$GITHUB_OUTPUT"
+            echo "alias=" >> "$GITHUB_OUTPUT"
+          else
+            TAG="${GITHUB_REF##refs/tags/}"
+            VER="${TAG#v}"
+            MM="$(echo "$VER" | awk -F. '{print $1"."$2}')"
+            echo "version=${MM}" >> "$GITHUB_OUTPUT"
+            echo "alias=latest" >> "$GITHUB_OUTPUT"
+          fi
+
+      - name: Deploy via mike
+        run: |
+          if [ -n "${{ steps.label.outputs.alias }}" ]; then
+            uv run mike deploy --push --update-aliases \
+              "${{ steps.label.outputs.version }}" "${{ steps.label.outputs.alias }}"
+            uv run mike set-default --push "${{ steps.label.outputs.alias }}"
+          else
+            uv run mike deploy --push "${{ steps.label.outputs.version }}"
+            uv run mike set-default --push "${{ steps.label.outputs.version }}"
+          fi

fathom_rules-0.3.2/.github/workflows/docs.yml

@@ -0,0 +1,114 @@
+name: docs
+
+on:
+  pull_request:
+    paths:
+      - "src/**"
+      - "docs/**"
+      - "packages/**"
+      - "protos/**"
+      - "CHANGELOG.md"
+      - "mkdocs.yml"
+      - "Makefile"
+      - "scripts/**"
+      - ".github/workflows/docs.yml"
+  push:
+    branches: [main]
+
+jobs:
+  docs:
+    runs-on: ubuntu-latest
+    timeout-minutes: 15
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v3
+        with:
+          python-version: "3.13"
+
+      - name: Install Python deps
+        run: uv sync --extra docs --extra server --extra mcp
+
+      # arduino/setup-protoc@v3 has an unfixed bug ("unable to get latest
+      # version", arduino/setup-protoc#108) that intermittently breaks CI
+      # even with an explicit version pin. Install protoc directly from
+      # the upstream release archive instead.
+      - name: Install protoc
+        run: |
+          set -euo pipefail
+          PROTOC_VERSION=27.3
+          curl -fsSL -o /tmp/protoc.zip \
+            "https://github.com/protocolbuffers/protobuf/releases/download/v${PROTOC_VERSION}/protoc-${PROTOC_VERSION}-linux-x86_64.zip"
+          sudo unzip -q -o /tmp/protoc.zip -d /usr/local
+          sudo chmod +x /usr/local/bin/protoc
+          protoc --version
+
+      - name: Set up Go
+        uses: actions/setup-go@v5
+        with:
+          go-version: "1.24"
+
+      - name: Install protoc-gen-doc
+        run: go install github.com/pseudomuto/protoc-gen-doc/cmd/protoc-gen-doc@v1.5.1
+
+      - name: Install Node
+        uses: actions/setup-node@v4
+        with:
+          node-version: "20"
+
+      - name: Install pnpm
+        uses: pnpm/action-setup@v4
+        with:
+          version: 9
+
+      - name: Version sync
+        run: uv run python scripts/check_version_sync.py
+
+      - name: Generate docs artifacts
+        run: make docs-gen
+
+      - name: Generate foreign-toolchain docs
+        run: make docs-gen-foreign
+
+      - name: Drift gate
+        run: |
+          if ! git diff --exit-code docs/reference docs/llms.txt docs/llms-full.txt docs/changelog.json; then
+            echo "::error::Generated docs artifacts are stale. Run 'make docs-gen && make docs-gen-foreign' and commit."
+            exit 1
+          fi
+
+      - name: Build (strict)
+        run: uv run mkdocs build --strict
+
+      - name: Docstring coverage
+        run: uv run python scripts/check_docstrings.py
+
+      - name: SDK coverage
+        run: uv run python scripts/check_sdk_coverage.py
+
+      - name: Doc source drift gate
+        run: uv run python scripts/check_doc_sources.py
+
+      - name: Tutorial snippet verification
+        run: uv run python scripts/verify_tutorial_snippets.py docs/tutorials
+        if: hashFiles('docs/tutorials/*.md') != ''
+
+      - name: Markdown lint
+        uses: DavidAnson/markdownlint-cli2-action@v16
+        with:
+          globs: |
+            docs/**/*.md
+            !docs/reference/**
+            !docs/llms*.txt
+            !docs/superpowers/**
+            !docs/_prompts/**
+
+      - name: Spelling
+        run: uv run codespell docs/ --skip "docs/reference/*,docs/llms*.txt,docs/changelog.json,docs/superpowers/*"
+
+      - name: Link check
+        uses: lycheeverse/lychee-action@v1
+        with:
+          args: --no-progress --exclude-path docs/superpowers docs/
+          fail: true

fathom_rules-0.3.2/.github/workflows/go-ci.yml

@@ -0,0 +1,90 @@
+name: go-ci
+
+on:
+  pull_request:
+    paths:
+      - "protos/**"
+      - "packages/fathom-go/**"
+      - ".github/workflows/go-ci.yml"
+  push:
+    branches: [main]
+    paths:
+      - "protos/**"
+      - "packages/fathom-go/**"
+      - ".github/workflows/go-ci.yml"
+  workflow_dispatch: {}
+
+concurrency:
+  group: go-ci-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    timeout-minutes: 15
+    defaults:
+      run:
+        working-directory: packages/fathom-go
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Go
+        uses: actions/setup-go@v5
+        with:
+          go-version: "1.24"
+
+      - name: Set up protoc
+        uses: arduino/setup-protoc@v3
+        with:
+          version: "25.3"
+          repo-token: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Install protoc Go plugins
+        run: |
+          go install google.golang.org/protobuf/cmd/protoc-gen-go@latest
+          go install google.golang.org/grpc/cmd/protoc-gen-go-grpc@v1.6.1
+          echo "$(go env GOPATH)/bin" >> "$GITHUB_PATH"
+
+      - name: verify-grpc (drift check)
+        run: make verify-grpc
+
+      - name: go vet
+        run: go vet ./...
+
+      - name: go build
+        run: go build ./...
+
+      - name: go test
+        run: go test ./...
+
+  integration:
+    runs-on: ubuntu-latest
+    timeout-minutes: 20
+    needs: test
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up Go
+        uses: actions/setup-go@v5
+        with:
+          go-version: "1.24"
+
+      - name: Set up protoc
+        uses: arduino/setup-protoc@v3
+        with:
+          version: "25.3"
+          repo-token: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v5
+        with:
+          python-version: "3.13"
+
+      - name: Install fathom (Python) for live gRPC server
+        run: |
+          uv sync --all-extras
+          uv pip install -e .
+
+      - name: go test (integration)
+        working-directory: packages/fathom-go
+        run: go test -tags integration ./...

fathom_rules-0.3.2/.github/workflows/pypi-publish.yml

@@ -0,0 +1,53 @@
+name: pypi-publish
+on:
+  push:
+    tags:
+      - "v*.*.*"
+  workflow_dispatch: {}
+permissions:
+  id-token: write
+  contents: write
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    environment: pypi
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v3
+        with:
+          python-version: "3.13"
+
+      - name: Clean old artifacts
+        run: rm -rf dist/
+
+      - name: Build
+        run: uv build
+
+      - name: Install minisign
+        run: sudo apt-get update && sudo apt-get install -y minisign
+
+      - name: Write signing key
+        env:
+          MINISIGN_KEY_PRIMARY: ${{ secrets.MINISIGN_KEY_PRIMARY }}
+        run: |
+          set -euo pipefail
+          if [[ -z "${MINISIGN_KEY_PRIMARY}" ]]; then
+            echo "error: MINISIGN_KEY_PRIMARY secret is not set" >&2
+            exit 1
+          fi
+          printf '%s\n' "${MINISIGN_KEY_PRIMARY}" > /tmp/mini.key
+          chmod 600 /tmp/mini.key
+
+      - name: Sign and verify artifacts
+        run: bash scripts/sign_release.sh /tmp/mini.key docs/reference/release-signing-pubkey.minisig
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+
+      - name: Upload signatures to GitHub release
+        if: startsWith(github.ref, 'refs/tags/')
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: gh release upload "${GITHUB_REF_NAME}" dist/*.minisig

fathom_rules-0.3.2/.gitignore

@@ -0,0 +1,82 @@
+# AI / Editor tooling
+.claude
+.vscode
+.cursor
+.worktrees
+CLAUDE.md
+
+# Specs / orchestration state
+./specs/
+specs/.current-spec
+specs/.index/.work-indicators/
+**/.tasks.lock
+**/.progress.md
+**/.ralph-state.json
+**/.git-commit.lock
+
+# Python bytecode
+__pycache__/
+*.py[codz]
+*$py.class
+*.so
+
+# Distribution / packaging
+build/
+dist/
+*.egg-info/
+*.egg
+.installed.cfg
+MANIFEST
+
+# Virtual environments
+.venv
+.env
+.envrc
+
+# uv
+uv.lock
+
+# Testing / coverage
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+coverage.xml
+*.cover
+*.py.cover
+.hypothesis/
+.pytest_cache/
+
+# Type checkers / linters
+.mypy_cache/
+.dmypy.json
+dmypy.json
+.pytype/
+.pyre/
+.ruff_cache/
+
+# mkdocs
+/site
+
+# Node / TypeScript
+node_modules/
+packages/*/node_modules
+
+# Logs
+*.log
+
+# Docker
+*.pid
+
+# Secrets / tokens
+.pypi-token
+.pypirc
+
+# OS files
+.DS_Store
+Thumbs.db
+
+# Scratch / test artifacts
+.live-test-*/
+CLAUDE.md