epistemic-graph 0.24.0__tar.gz

epistemic_graph-0.24.0/.bumpversion.cfg

@@ -0,0 +1,16 @@
+[bumpversion]
+current_version = 0.24.0
+commit = True
+tag = True
+
+[bumpversion:file:pyproject.toml]
+search = version = "{current_version}"
+replace = version = "{new_version}"
+
+[bumpversion:file:Cargo.toml]
+search = version = "{current_version}"
+replace = version = "{new_version}"
+
+[bumpversion:file:README.md]
+search = version-{current_version}-blue
+replace = version-{new_version}-blue

epistemic_graph-0.24.0/.codespellignore

@@ -0,0 +1,28 @@
+# Codespell ignore words
+ans
+linar
+nam
+tread
+ot
+petgraph
+toposort
+pyo3
+pymethods
+pyclass
+pymodule
+cdylib
+stable_graph
+bfs
+dfs
+dijkstra
+maturin
+tomllib
+bumpversion
+bump2version
+hadolint
+vulture
+codespell
+pre-commit
+epistemic
+epistemic-graph
+epistemic_graph

epistemic_graph-0.24.0/.env.example

@@ -0,0 +1,9 @@
+# epistemic-graph environment configuration
+PYTHONPATH=.
+
+# Runtime environment settings
+GRAPH_SERVICE_AUTH_SECRET=changeme
+GRAPH_SERVICE_SOCKET=/tmp/epistemic_graph.sock
+XDG_RUNTIME_DIR=/tmp
+PATH=/usr/local/bin:/usr/bin:/bin
+UID=1000

epistemic_graph-0.24.0/.gitattributes

@@ -0,0 +1,197 @@
+# Auto detect
+##   Handle line endings automatically for files detected as
+##   text and leave all files detected as binary untouched.
+##   This will handle all files NOT defined below.
+*                 text=auto
+
+# Source code
+*.bash            text eol=lf
+*.bat             text eol=crlf
+*.cmd             text eol=crlf
+*.coffee          text
+*.css             text diff=css
+*.htm             text diff=html
+*.html            text diff=html
+*.inc             text
+*.ini             text
+*.js              text
+*.json            text
+*.jsx             text
+*.less            text
+*.ls              text
+*.map             text -diff
+*.od              text
+*.onlydata        text
+*.php             text diff=php
+*.pl              text
+*.ps1             text eol=crlf
+*.py              text diff=python
+*.rb              text diff=ruby
+*.rs              text diff=rust
+*.sass            text
+*.scm             text
+*.scss            text diff=css
+*.sh              text eol=lf
+.husky/*          text eol=lf
+*.sql             text
+*.styl            text
+*.tag             text
+*.ts              text
+*.tsx             text
+*.xml             text
+*.xhtml           text diff=html
+
+# Docker
+Dockerfile        text
+
+# Documentation
+*.ipynb           text
+*.markdown        text diff=markdown
+*.md              text diff=markdown
+*.mdwn            text diff=markdown
+*.mdown           text diff=markdown
+*.mkd             text diff=markdown
+*.mkdn            text diff=markdown
+*.mdtxt           text
+*.mdtext          text
+*.txt             text
+AUTHORS           text
+CHANGELOG         text
+CHANGES           text
+CONTRIBUTING      text
+COPYING           text
+copyright         text
+*COPYRIGHT*       text
+INSTALL           text
+license           text
+LICENSE           text
+NEWS              text
+readme            text
+*README*          text
+TODO              text
+
+# Templates
+*.dot             text
+*.ejs             text
+*.erb             text
+*.haml            text
+*.handlebars      text
+*.hbs             text
+*.hbt             text
+*.jade            text
+*.latte           text
+*.mustache        text
+*.njk             text
+*.phtml           text
+*.svelte          text
+*.tmpl            text
+*.tpl             text
+*.twig            text
+*.vue             text
+
+# Configs
+*.cnf             text
+*.conf            text
+*.config          text
+.editorconfig     text
+.env              text
+.gitattributes    text
+.gitconfig        text
+.htaccess         text
+*.lock            text -diff
+package.json      text eol=lf
+package-lock.json text eol=lf -diff
+pnpm-lock.yaml    text eol=lf -diff
+.prettierrc       text
+yarn.lock         text -diff
+*.toml            text
+*.yaml            text
+*.yml             text
+browserslist      text
+Makefile          text
+makefile          text
+
+# Heroku
+Procfile          text
+
+# Graphics
+*.ai              binary
+*.bmp             binary
+*.eps             binary
+*.gif             binary
+*.gifv            binary
+*.ico             binary
+*.jng             binary
+*.jp2             binary
+*.jpg             binary
+*.jpeg            binary
+*.jpx             binary
+*.jxr             binary
+*.pdf             binary
+*.png             binary
+*.psb             binary
+*.psd             binary
+# SVG treated as an asset (binary) by default.
+*.svg             text
+# If you want to treat it as binary,
+# use the following line instead.
+# *.svg           binary
+*.svgz            binary
+*.tif             binary
+*.tiff            binary
+*.wbmp            binary
+*.webp            binary
+
+# Audio
+*.kar             binary
+*.m4a             binary
+*.mid             binary
+*.midi            binary
+*.mp3             binary
+*.ogg             binary
+*.ra              binary
+
+# Video
+*.3gpp            binary
+*.3gp             binary
+*.as              binary
+*.asf             binary
+*.asx             binary
+*.avi             binary
+*.fla             binary
+*.flv             binary
+*.m4v             binary
+*.mng             binary
+*.mov             binary
+*.mp4             binary
+*.mpeg            binary
+*.mpg             binary
+*.ogv             binary
+*.swc             binary
+*.swf             binary
+*.webm            binary
+
+# Archives
+*.7z              binary
+*.gz              binary
+*.jar             binary
+*.rar             binary
+*.tar             binary
+*.zip             binary
+
+# Fonts
+*.ttf             binary
+*.eot             binary
+*.otf             binary
+*.woff            binary
+*.woff2           binary
+
+# Executables
+*.exe             binary
+*.pyc             binary
+
+# RC files (like .babelrc or .eslintrc)
+*.*rc             text
+
+# Ignore files (like .npmignore or .gitignore)
+*.*ignore         text

epistemic_graph-0.24.0/.github/workflows/pages.yml

@@ -0,0 +1,14 @@
+name: Deploy GitHub Pages
+
+on:
+  push:
+    branches:
+      - main
+    paths:
+      - 'docs/**'
+      - 'mkdocs.yml'
+      - 'README.md'
+
+jobs:
+  publish-pages:
+    uses: Knuckles-Team/pipelines/.github/workflows/pages_pipeline.yml@main

epistemic_graph-0.24.0/.github/workflows/pipeline.yml

@@ -0,0 +1,20 @@
+name: Build|Upload|Release Python Package
+
+on:
+  push:
+    branches:
+      - 'main'
+
+jobs:
+  publish-pypi:
+    uses: Knuckles-Team/pipelines/.github/workflows/maturin_pipeline.yml@main
+    secrets:
+      PYPI_API_TOKEN: ${{ secrets.PYPI_API_TOKEN }}
+  publish-docker:
+    needs: publish-pypi
+    uses: Knuckles-Team/pipelines/.github/workflows/container_pipeline.yml@main
+    secrets:
+      DOCKER_REGISTRY: ${{ secrets.DOCKER_REGISTRY }}
+      DOCKER_USERNAME: ${{ secrets.DOCKER_USERNAME }}
+      DOCKER_PASSWORD: ${{ secrets.DOCKER_PASSWORD }}
+      DOCKER_REPOSITORY: ${{ secrets.DOCKER_REPOSITORY }}

epistemic_graph-0.24.0/.gitignore

@@ -0,0 +1,91 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+/.ruff_cache/
+
+# C extensions
+*.so
+*.pyd
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+pip-wheel-metadata/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Rust target directory and backups
+target/
+debug/
+**/*.rs.bk
+*.pdb
+**/mutants.out*/
+.idea/
+
+# Model-generated transient scripts at root level
+/test_*.py
+/fix_*.py
+/debug_*.py
+/scratch_*.py
+/temp_*.py
+
+# Transient logs, traces, patch files, and test outputs
+*.orig
+*.rej
+*.patch
+*.log
+*output*.txt
+*errors*.txt
+failed_tests.txt
+trace.txt
+
+# AI agent scratch (do not commit) — keep repo roots pristine
+.agent/
+.agents/
+.agent_data/
+.tmp/
+.pytest_tmp/
+.hypothesis/

epistemic_graph-0.24.0/.pre-commit-config.yaml

@@ -0,0 +1,110 @@
+default_language_version:
+  python: python3
+exclude: 'dotnet|node_modules|target'
+ci:
+  autofix_prs: true
+  autoupdate_commit_msg: '[pre-commit.ci] pre-commit suggestions'
+  autoupdate_schedule: 'monthly'
+
+repos:
+- repo: https://github.com/pre-commit/pre-commit-hooks
+  rev: v6.0.0
+  hooks:
+  - id: check-added-large-files
+    args: ["--maxkb=2000"]
+    exclude: '.*\.db$'
+  - id: check-ast
+    exclude: ^(tests/|test/|scripts/|script/)
+  - id: check-yaml
+    args: ["--unsafe"]
+  - id: check-toml
+  - id: check-json
+  - id: fix-byte-order-marker
+    exclude: .gitignore
+  - id: check-merge-conflict
+  - id: detect-private-key
+  - id: trailing-whitespace
+  - id: end-of-file-fixer
+- repo: https://github.com/astral-sh/ruff-pre-commit
+  rev: v0.15.12
+  hooks:
+  - id: ruff-check
+    args: ["--fix", "--ignore=E402,B008,E501"]
+    exclude: ^(tests/|test/|scripts/|script/)
+  - id: ruff-format
+    exclude: ^(tests/|test/|scripts/|script/)
+- repo: https://github.com/pre-commit/mirrors-mypy
+  rev: v1.20.2
+  hooks:
+  - id: mypy
+    additional_dependencies: [pydantic, types-PyYAML, types-requests, types-setuptools]
+    args: ["--ignore-missing-imports"]
+- repo: https://github.com/jendrikseipp/vulture
+  rev: v2.16
+  hooks:
+  - id: vulture
+    pass_filenames: false
+    args: [".", "--min-confidence", "95", "--exclude", "node_modules,dotnet,.venv,venv,node_modules,.git,build,dist,target"]
+    require_serial: true
+- repo: https://github.com/codespell-project/codespell
+  rev: v2.4.2
+  hooks:
+  - id: codespell
+    args: ["-L", "ans,linar,nam,tread,ot,", "--ignore-words=.codespellignore"]
+    exclude: ^(tests/|test/|scripts/|script/|.*lock.*|Cargo.lock|\.specify/)
+- repo: https://github.com/PyCQA/bandit
+  rev: 1.9.4
+  hooks:
+  - id: bandit
+    args: ["--skip", "B101,B404,B603"]
+    exclude: ^(tests/|test/|scripts/|script/|__tests__/)
+- repo: https://github.com/astral-sh/uv-pre-commit
+  rev: 0.11.8
+  hooks:
+  - id: uv-lock
+- repo: local
+  hooks:
+  - id: check-stubs
+    name: Check for Active Stubs and TODOs
+    entry: python3 /home/apps/workspace/agent-packages/agent-utilities/scripts/check_stubs.py
+    language: system
+    types: [python]
+  - id: check-sprawl
+    name: Guardrail — anti-sprawl
+    entry: python3 /home/apps/workspace/agent-packages/agent-utilities/scripts/check_sprawl.py
+    language: system
+    args: ["."]
+    pass_filenames: false
+    always_run: true
+  - id: check-bumpversion
+    name: validate bumpversion config
+    entry: |-
+      bash -c 'if [ -f ".bumpversion.cfg" ]; then bump2version patch --dry-run --allow-dirty; fi'
+    language: system
+    pass_filenames: false
+    always_run: true
+- repo: local
+  hooks:
+  - id: cargo-test
+    name: cargo test
+    entry: bash -c 'if [ -f "Cargo.toml" ]; then cargo test --quiet; fi'
+    language: system
+    pass_filenames: false
+    always_run: true
+- repo: local
+  hooks:
+  - id: pytest
+    name: pytest
+    entry: bash -c 'test_target="tests"; for d in tests/unit test/unit tests test; do if [ -d "$d" ]; then test_target="$d"; break; fi; done; if [ -f uv.lock ]; then uv run --all-extras pytest "$test_target" -q --tb=short -m "not slow" --timeout=60; else pytest "$test_target" -q --tb=short -m "not slow" --timeout=60; fi'
+    language: system
+    types: [python]
+    pass_filenames: false
+    always_run: true
+- repo: local
+  hooks:
+  - id: security-sanitizer
+    name: Security and Garbage Sanitizer
+    entry: python scripts/security_sanitizer.py
+    language: python
+    pass_filenames: false
+    always_run: true