axor-core 0.1.0__tar.gz

axor_core-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,102 @@
+name: CI/CD
+
+on:
+  push:
+    branches: [main]
+    tags: ["v*.*.*"]
+  pull_request:
+    branches: [main]
+
+jobs:
+  test:
+    name: Test (Python ${{ matrix.python-version }})
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.11", "3.12"]
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+          cache: pip
+
+      - name: Install
+        run: |
+          pip install -e ".[dev]"
+
+      - name: Static analysis — no provider imports in core
+        run: |
+          python - << 'EOF'
+          import ast, os, sys
+          issues = []
+          for root, dirs, files in os.walk("axor_core"):
+              dirs[:] = [d for d in dirs if not d.startswith("__")]
+              for f in files:
+                  if not f.endswith(".py"):
+                      continue
+                  path = os.path.join(root, f)
+                  src  = open(path).read()
+                  for provider in ["anthropic", "openai", "langchain", "boto3"]:
+                      if f"import {provider}" in src or f"from {provider}" in src:
+                          issues.append(f"PROVIDER_IMPORT: {path} imports {provider}")
+          if issues:
+              print("\n".join(issues))
+              sys.exit(1)
+          print(f"✓ no provider imports in axor_core/")
+          EOF
+
+      - name: Run tests
+        run: pytest tests/ -v --tb=short
+
+  publish:
+    name: Publish to PyPI
+    needs: test
+    runs-on: ubuntu-latest
+    if: startsWith(github.ref, 'refs/tags/v')
+    environment: pypi
+
+    permissions:
+      id-token: write   # for trusted publishing
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+
+      - name: Verify tag matches package version
+        run: |
+          python - << 'EOF'
+          import pathlib
+          import re
+          import sys
+          import tomllib
+
+          ref = "${{ github.ref_name }}"
+          m = re.fullmatch(r"v(\d+\.\d+\.\d+)", ref)
+          if not m:
+              print(f"Tag {ref!r} must match vX.Y.Z")
+              sys.exit(1)
+
+          tag_version = m.group(1)
+          data = tomllib.loads(pathlib.Path("pyproject.toml").read_text(encoding="utf-8"))
+          pkg_version = data["project"]["version"]
+
+          if tag_version != pkg_version:
+              print(f"Version mismatch: tag={tag_version}, pyproject={pkg_version}")
+              sys.exit(1)
+
+          print(f"Version check passed: {pkg_version}")
+          EOF
+
+      - name: Build
+        run: |
+          pip install hatchling build
+          python -m build
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

axor_core-0.1.0/.gitignore

@@ -0,0 +1,13 @@
+__pycache__/
+*.py[cod]
+*.egg-info/
+dist/
+build/
+.venv/
+.env
+*.egg
+.pytest_cache/
+.coverage
+htmlcov/
+~/.axor/
+*.bin

axor_core-0.1.0/CHANGELOG.md

@@ -0,0 +1,17 @@
+# Changelog
+
+## 0.1.0 — 2025-04-12
+
+Initial release.
+
+### Added
+- Core governance kernel (axor-core)
+- Claude Code adapter (axor-claude)  
+- CLI with interactive REPL (axor-cli)
+- Dynamic policy selection (7-policy matrix)
+- ContextManager with 11 waste categories
+- ToolResultBus for async tool loop
+- Federation via spawn_child with child_executor
+- CancelToken cooperative cancellation
+- BudgetPolicyEngine (60/80/90/95% thresholds)
+- TraceCollector with lineage (17 event kinds)

axor_core-0.1.0/CONTRIBUTING.md

@@ -0,0 +1,55 @@
+# Contributing to axor-core
+
+## Architecture principles
+
+Before contributing, read the design invariants in README.md.
+
+The most important ones:
+
+- **Core never imports providers.** No anthropic, openai, or other SDK imports in `axor_core/`.
+- **Policy meaning belongs to core.** Adapters translate envelopes, never define governance.
+- **Executors never self-assign capabilities.** Always derived from policy.
+- **Waste elimination always runs.** Mode controls aggressiveness, not whether it happens.
+
+## Setup
+
+```bash
+git clone https://github.com/your-org/axor-core
+cd axor-core
+python -m venv .venv
+source .venv/bin/activate
+pip install -e ".[dev]"
+```
+
+## Running tests
+
+```bash
+pytest tests/
+pytest tests/integration/   # integration only
+pytest tests/ -k "cancel"   # filter by name
+```
+
+## Adding a subsystem
+
+1. Add contracts to `axor_core/contracts/` first — no imports from other axor_core modules
+2. Implement in the appropriate subsystem package
+3. Export from the package `__init__.py`
+4. Add tests in `tests/<subsystem>/`
+5. Update `axor_core/__init__.py` if adding public API
+
+## Adding an adapter
+
+Adapters live in separate repositories (`axor-claude`, `axor-openai`, etc.).
+They implement:
+- `Invokable` — the executor contract
+- `ToolHandler` — one per tool
+- `ExtensionLoader` — optional, for provider-specific extensions (CLAUDE.md etc.)
+
+See `README.md` → "Implementing an Adapter" for details.
+
+## Pull request checklist
+
+- [ ] No provider imports in `axor_core/`
+- [ ] New contracts added to `contracts/__init__.py`
+- [ ] Tests added for new functionality  
+- [ ] `PYTHONPATH=. python -c "from axor_core import GovernedSession"` passes

axor_core-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Axor Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.