Skip to content
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
40 changes: 40 additions & 0 deletions CLAUDE.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,40 @@
# pyDatalog — CLAUDE.md

Magnon mirror of the pyDatalog library — Python logic programming.
Part of MagnonOS Project-Aethra.

## Purpose

Magnon's private mirror of the unmaintained pyDatalog library. Used by Project-Aethra
for Datalog-based policy evaluation and knowledge querying in the NeSy (neurosymbolic)
pipeline. Note: upstream is unmaintained — consider IDP-Z3 for new features.

Upstream: https://github.com/pcarbonn/pyDatalog (unmaintained)

## Tech stack

- Python (Datalog engine)
- Note: unmaintained upstream — use only for existing integrations

## Dev commands

```bash
pip install -e .
python -c "from pyDatalog import pyDatalog; print('OK')"
```

## Key conventions

- This is a **maintenance mirror only** — do not add new features or APIs.
- New Datalog/logic programming needs should use IDP-Z3 instead.
- Bug fixes are accepted; new feature development is not.

## What NOT to do

- Never add new features — only bug fixes and compatibility patches.
- Never use `ubuntu-latest` CI runners — always `magnon-enterprise-runners`.
- Do not use as a dependency for new services — prefer IDP-Z3.

## CI

All GitHub Actions workflow jobs use `runs-on: magnon-enterprise-runners`.