sovyx 0.1.0__tar.gz

sovyx-0.1.0/.dockerignore

@@ -0,0 +1,16 @@
+.git
+.github
+.venv
+__pycache__
+*.pyc
+.pytest_cache
+.hypothesis
+.mypy_cache
+.ruff_cache
+.coverage
+htmlcov
+tests
+benchmarks
+docs
+*.md
+!README.md

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

@@ -0,0 +1,84 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  lint:
+    name: Lint (ruff)
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v5
+        with:
+          version: "latest"
+      - name: Install dependencies
+        run: uv sync --dev
+      - name: Ruff check
+        run: uv run ruff check src/ tests/
+      - name: Ruff format check
+        run: uv run ruff format --check src/ tests/
+
+  typecheck:
+    name: Type Check (mypy)
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v5
+        with:
+          version: "latest"
+      - name: Install dependencies
+        run: uv sync --dev
+      - name: mypy strict
+        run: uv run mypy src/
+
+  security:
+    name: Security (bandit)
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v5
+        with:
+          version: "latest"
+      - name: Install dependencies
+        run: uv sync --dev
+      - name: Bandit scan
+        run: uv run bandit -r src/sovyx/ --configfile pyproject.toml
+
+  test:
+    name: Test (Python ${{ matrix.python-version }})
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: true
+      matrix:
+        python-version: ["3.11", "3.12"]
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v5
+        with:
+          version: "latest"
+      - name: Set Python version
+        run: uv python install ${{ matrix.python-version }}
+      - name: Install dependencies
+        run: uv sync --dev --python ${{ matrix.python-version }}
+      - name: Run tests with coverage
+        run: >
+          uv run python -m pytest tests/
+          --cov=sovyx
+          --cov-report=term-missing
+          --cov-report=xml:coverage.xml
+          --cov-fail-under=95
+          -v
+      - name: Upload coverage
+        if: matrix.python-version == '3.12'
+        uses: actions/upload-artifact@v4
+        with:
+          name: coverage-report
+          path: coverage.xml

sovyx-0.1.0/.github/workflows/docker.yml

@@ -0,0 +1,51 @@
+name: Docker
+
+on:
+  push:
+    tags: ["v*"]
+  workflow_dispatch:
+
+jobs:
+  build:
+    name: Build & Push
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      packages: write
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Set up QEMU (multi-arch)
+        uses: docker/setup-qemu-action@v3
+
+      - name: Set up Docker Buildx
+        uses: docker/setup-buildx-action@v3
+
+      - name: Login to GHCR
+        uses: docker/login-action@v3
+        with:
+          registry: ghcr.io
+          username: ${{ github.actor }}
+          password: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Extract version
+        id: meta
+        uses: docker/metadata-action@v5
+        with:
+          images: ghcr.io/sovyx-ai/sovyx
+          tags: |
+            type=semver,pattern={{version}}
+            type=semver,pattern={{major}}.{{minor}}
+            type=raw,value=latest,enable={{is_default_branch}}
+
+      - name: Build and push
+        uses: docker/build-push-action@v6
+        with:
+          context: .
+          platforms: linux/amd64,linux/arm64
+          push: true
+          tags: ${{ steps.meta.outputs.tags }}
+          labels: ${{ steps.meta.outputs.labels }}
+          cache-from: type=gha
+          cache-to: type=gha,mode=max

sovyx-0.1.0/.github/workflows/publish.yml

@@ -0,0 +1,27 @@
+name: Publish to PyPI
+
+on:
+  push:
+    tags: ["v*"]
+  workflow_dispatch:
+
+jobs:
+  publish:
+    name: Build & Publish
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      id-token: write  # trusted publisher (no API key needed)
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: astral-sh/setup-uv@v5
+        with:
+          version: "latest"
+
+      - name: Build
+        run: uv build
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

sovyx-0.1.0/.gitignore

@@ -0,0 +1,59 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+
+# Virtual environments
+.venv/
+venv/
+ENV/
+
+# Distribution
+dist/
+build/
+*.egg-info/
+*.egg
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+*~
+
+# Environment
+.env
+.env.*
+
+# Databases
+*.db
+*.db-wal
+*.db-shm
+
+# Coverage
+htmlcov/
+.coverage
+.coverage.*
+coverage.xml
+
+# mypy
+.mypy_cache/
+
+# ruff
+.ruff_cache/
+
+# pytest
+.pytest_cache/
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Models (large binaries)
+*.onnx
+*.bin
+
+# Sovyx data (local)
+.sovyx/
+.hypothesis/

sovyx-0.1.0/.pre-commit-config.yaml

@@ -0,0 +1,20 @@
+repos:
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.3.0
+    hooks:
+      - id: ruff
+        args: [--fix]
+      - id: ruff-format
+
+  - repo: https://github.com/pre-commit/mirrors-mypy
+    rev: v1.9.0
+    hooks:
+      - id: mypy
+        additional_dependencies:
+          - pydantic>=2.6
+          - pydantic-settings>=2.2
+          - typer>=0.12
+          - structlog>=24.1
+        args: [--strict]
+        pass_filenames: false
+        entry: mypy src/

sovyx-0.1.0/CHANGELOG.md

@@ -0,0 +1,48 @@
+# Changelog
+
+All notable changes to Sovyx will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [0.1.0] — 2026-04-03
+
+### Added
+- **Cognitive Loop**: Full perception → attention → thinking → action → reflection pipeline
+- **Brain System**: Concept/episode/relation storage with SQLite + sqlite-vec embeddings
+- **Working Memory**: Activation-based with geometric decay
+- **Spreading Activation**: Multi-hop concept retrieval
+- **Hebbian Learning**: Strengthen connections between co-occurring concepts
+- **Ebbinghaus Decay**: Forgetting curve with rehearsal factor
+- **Hybrid Retrieval**: RRF fusion of FTS5 + vector search
+- **Memory Consolidation**: Scheduled decay + pruning cycles
+- **Personality Engine**: OCEAN model with 3-level descriptors
+- **Context Assembly**: Token-budget-aware with Lost-in-Middle ordering (Liu et al. 2023)
+- **LLM Router**: Multi-provider failover (Anthropic, OpenAI, Ollama) with circuit breaker
+- **Cost Guard**: Per-conversation and daily budget limits
+- **Telegram Channel**: aiogram 3.x with exponential backoff reconnect
+- **Person Resolver**: Auto-create identity on first contact
+- **Conversation Tracker**: 30min timeout, 50-turn history
+- **CLI**: `sovyx init/start/stop/status/doctor/brain/mind` commands (typer + rich)
+- **Daemon**: JSON-RPC 2.0 over Unix socket (0o600 permissions)
+- **Lifecycle Manager**: PID lock, SIGTERM/SIGINT graceful shutdown, sd_notify
+- **Health Checker**: 10 concurrent checks (sqlite, brain, LLM, disk, memory)
+- **Graceful Degradation**: Fallback chains for each component
+- **Service Registry**: Lightweight DI with singleton factories
+- **Event Bus**: Typed pub/sub for system events
+- **Structured Logging**: structlog with JSON output
+- **Docker**: Multi-stage build, non-root user, healthcheck
+- **systemd**: Unit file with security hardening
+- **Installer**: One-liner shell script via uv
+
+### Technical
+- 1138 tests (1130 passed, 8 skipped)
+- 95%+ code coverage
+- mypy strict mode (zero errors)
+- ruff lint + format (zero warnings)
+- bandit security scan (zero high/critical)
+- Python 3.11 + 3.12 CI matrix
+- Property-based tests (Hypothesis) for core algorithms
+- Performance benchmarks with threshold validation
+
+[0.1.0]: https://github.com/sovyx-ai/sovyx/releases/tag/v0.1.0

sovyx-0.1.0/CONTRIBUTING.md

@@ -0,0 +1,85 @@
+# Contributing to Sovyx
+
+Thank you for your interest in contributing to Sovyx.
+
+## Setup
+
+### Prerequisites
+
+- Python 3.11+
+- [uv](https://docs.astral.sh/uv/) (recommended) or pip
+- Git
+
+### Getting Started
+
+```bash
+# Clone the repository
+git clone https://github.com/sovyx-ai/sovyx.git
+cd sovyx
+
+# Install dependencies (production + dev)
+uv sync --dev
+
+# Verify installation
+uv run python -m sovyx
+# → Sovyx v0.1.0
+```
+
+### Running Checks
+
+```bash
+# Run all checks (lint + typecheck + security + tests)
+make all
+
+# Or individually:
+make lint        # ruff check
+make typecheck   # mypy --strict
+make security    # bandit
+make test        # pytest
+make test-cov    # pytest with coverage (≥95% required)
+
+# Or use the script:
+./scripts/check.sh
+```
+
+## Quality Standards
+
+All contributions must pass:
+
+- **ruff** — zero warnings, formatted
+- **mypy --strict** — zero errors, no `Any` except JSON boundaries
+- **bandit** — zero high/critical findings
+- **pytest** — all tests passing, ≥95% coverage per modified file
+- **Docstrings** — on every public API
+
+## Code Style
+
+- Python 3.11+, type hints everywhere
+- Line length: 99 characters
+- Imports: sorted by ruff (isort rules)
+- Async: use `asyncio`, never `threading` for IO
+- Errors: always inherit from `SovyxError` hierarchy
+- Config: no hardcodes, use `SOVYX_` env prefix
+- Tests: each test < 2s, async tests with 5s timeout
+
+## Commit Messages
+
+One commit per logical change:
+
+```
+feat: TASK-XX — Short description
+fix: Brief description of the fix
+docs: What was documented
+test: What was tested
+```
+
+## Pull Requests
+
+1. Branch from `main`
+2. Run `make all` before pushing
+3. PR title: `feat: TASK-XX — Description`
+4. All CI checks must pass
+
+## License
+
+By contributing, you agree that your contributions will be licensed under AGPL-3.0.

sovyx-0.1.0/COVERAGE.md

@@ -0,0 +1,19 @@
+# Coverage Policy — Sovyx v0.1.x
+
+## pragma: no cover Audit (28 annotations)
+
+All 28 `pragma: no cover` annotations have been audited and classified as **legitimate**.
+
+### Categories
+
+| Module | Count | Reason |
+|--------|-------|--------|
+| `cli/main.py` | 12 | Click CLI commands with Rich console — require click.testing.CliRunner integration |
+| `engine/health.py` | 10 | OS-level health checks (/proc, psutil, subprocess) — OS-dependent |
+| `engine/lifecycle.py` | 4 | PidFile PermissionError, default paths, socket cleanup — OS-dependent |
+| `cli/rpc_client.py` | 2 | Socket timeout/OS errors — not reproducible in unit tests |
+
+### Policy
+- **No code logic is being masked.** All 28 are error handlers or OS-interaction paths.
+- Removal target: v1.0 with proper integration test infrastructure.
+- New `pragma: no cover` requires PR review justification.

sovyx-0.1.0/Dockerfile

@@ -0,0 +1,50 @@
+# Sovyx — Sovereign Minds Engine
+# Multi-stage build: build deps → slim runtime
+# Supports: linux/amd64, linux/arm64
+
+FROM python:3.12-slim AS build
+
+WORKDIR /app
+RUN pip install --no-cache-dir uv==0.10.11
+
+# Copy dependency files first (cache layer)
+COPY pyproject.toml uv.lock ./
+RUN uv sync --no-dev --frozen
+
+# Copy source
+COPY src/ ./src/
+RUN uv pip install --no-deps .
+
+# ── Runtime ──────────────────────────────────────────────────────────────────
+
+FROM python:3.12-slim AS runtime
+
+LABEL org.opencontainers.image.title="Sovyx" \
+      org.opencontainers.image.description="Sovereign Minds Engine" \
+      org.opencontainers.image.source="https://github.com/sovyx-ai/sovyx" \
+      org.opencontainers.image.licenses="AGPL-3.0" \
+      org.opencontainers.image.version="0.1.0"
+
+# Create non-root user
+RUN groupadd --system sovyx && \
+    useradd --system --gid sovyx --create-home sovyx
+
+WORKDIR /app
+
+# Copy virtual environment from build stage
+COPY --from=build /app/.venv /app/.venv
+ENV PATH="/app/.venv/bin:$PATH" \
+    SOVYX_DATA_DIR="/data" \
+    PYTHONUNBUFFERED=1
+
+# Create data directory
+RUN mkdir -p /data && chown sovyx:sovyx /data
+VOLUME ["/data"]
+
+USER sovyx
+
+HEALTHCHECK --interval=30s --timeout=5s --start-period=10s --retries=3 \
+    CMD ["sovyx", "doctor"] || exit 1
+
+ENTRYPOINT ["sovyx"]
+CMD ["start", "--foreground"]