ci: add Python package tests across 3.10-3.12 and PyPI publish on release

CI: schema validation + Python adapter round-trips + CLI tests on every push/PR
CD: trusted publisher to PyPI on GitHub release (no API tokens needed)

Author: varun29ankuS

.github/workflows/publish.yml

@@ -0,0 +1,34 @@
+name: Publish to PyPI
+
+on:
+  release:
+    types: [published]
+
+permissions:
+  id-token: write
+
+jobs:
+  publish:
+    name: Build & Publish
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/p/mif-tools
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Install build tools
+        run: pip install build
+
+      - name: Build package
+        working-directory: python
+        run: python -m build
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          packages-dir: python/dist/

.github/workflows/validate.yml

@@ -1,4 +1,4 @@
-name: Validate MIF Examples
+name: CI
 
 on:
   push:
@@ -7,7 +7,8 @@ on:
     branches: [main]
 
 jobs:
-  validate:
+  schema:
+    name: Schema & Examples
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4
@@ -19,11 +20,105 @@ jobs:
       - name: Install dependencies
         run: pip install -r requirements.txt
 
-      - name: Validate examples against schema
-        run: python validate.py examples/*.mif.json
-
       - name: Validate schema is valid JSON
         run: python -c "import json; json.load(open('schema/mif-v2.schema.json'))"
 
+      - name: Validate examples against schema
+        run: python validate.py examples/*.mif.json
+
       - name: Round-trip test
         run: python tests/round_trip.py examples/*.mif.json
+
+  python:
+    name: Python Package
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.10", "3.11", "3.12"]
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install mif-tools
+        run: pip install -e "./python[validate]"
+
+      - name: Test adapters (MIF v2 round-trip)
+        run: |
+          python -c "
+          from mif import load, dump
+          data = open('examples/full.mif.json').read()
+          doc = load(data)
+          assert len(doc.memories) == 3
+          assert doc.knowledge_graph is not None
+          rt = load(dump(doc))
+          assert len(rt.memories) == 3
+          print('MIF v2 round-trip: PASS')
+          "
+
+      - name: Test adapters (mem0 round-trip)
+        run: |
+          python -c "
+          from mif import load, dump
+          data = open('examples/full.mif.json').read()
+          doc = load(data)
+          mem0 = dump(doc, format='mem0')
+          doc2 = load(mem0, format='mem0')
+          assert len(doc2.memories) == len(doc.memories)
+          print('mem0 round-trip: PASS')
+          "
+
+      - name: Test adapters (markdown round-trip)
+        run: |
+          python -c "
+          from mif import load, dump
+          data = open('examples/full.mif.json').read()
+          doc = load(data)
+          md = dump(doc, format='markdown')
+          doc2 = load(md, format='markdown')
+          assert len(doc2.memories) == len(doc.memories)
+          print('markdown round-trip: PASS')
+          "
+
+      - name: Test adapters (generic JSON round-trip)
+        run: |
+          python -c "
+          from mif import load, dump
+          data = open('examples/full.mif.json').read()
+          doc = load(data)
+          gen = dump(doc, format='generic')
+          doc2 = load(gen, format='generic')
+          assert len(doc2.memories) == len(doc.memories)
+          print('generic JSON round-trip: PASS')
+          "
+
+      - name: Test auto-detection
+        run: |
+          python -c "
+          from mif import load
+          # mem0 auto-detect
+          doc = load('[{\"memory\": \"test\", \"created_at\": \"2026-01-01T00:00:00Z\"}]')
+          assert doc.memories[0].content == 'test'
+          # generic auto-detect
+          doc = load('[{\"content\": \"test2\", \"timestamp\": \"2026-01-01T00:00:00Z\"}]')
+          assert doc.memories[0].content == 'test2'
+          print('auto-detection: PASS')
+          "
+
+      - name: Test CLI
+        run: |
+          mif formats
+          mif inspect examples/full.mif.json
+          mif validate examples/minimal.mif.json examples/full.mif.json
+
+      - name: Test schema validation
+        run: |
+          python -c "
+          from mif import validate
+          data = open('examples/full.mif.json').read()
+          ok, errors = validate(data)
+          assert ok, f'Validation failed: {errors}'
+          print('schema validation: PASS')
+          "