518b8eca85
md-first memory extraction framework for AI agents. Markdown is the single source of truth; SQLite holds state and LanceDB provides the rebuildable vector + BM25 + scalar index. The codebase follows a single-direction DDD layering (entrypoints -> service -> memory -> infra, with component / core / config cross-cutting) enforced by import-linter. Engineering surface: - Coding conventions in .claude/rules/ (path-scoped) and workflows in .claude/skills/ (/commit, /new-branch, /pr). - GitHub Actions CI runs make lint + test + integration; pre-commit mirrors the gates locally (ruff, hygiene hooks, gitlint commit-msg). - Commit messages follow Conventional Commits, enforced by gitlint. - make lint also enforces datetime two-zone discipline and OpenAPI drift.
28 lines
1.2 KiB
Markdown
28 lines
1.2 KiB
Markdown
---
|
|
paths:
|
|
- "tests/**/*.py"
|
|
---
|
|
|
|
# Testing rule
|
|
|
|
Tests mirror the source layout: `tests/unit/test_<layer>/...`,
|
|
`tests/integration/...`, `tests/e2e/...`.
|
|
|
|
- **Structure**: `tests/unit/` mirrors `src/everos/` package-for-package. Put a test
|
|
next to where its subject lives in the mirror.
|
|
- **Async**: `pytest-asyncio` is in `auto` mode — write `async def test_*` directly,
|
|
no marker needed.
|
|
- **Markers** (default run excludes both — `-m "not slow and not live_llm"`):
|
|
- `@pytest.mark.slow` — tests ≥ ~10s.
|
|
- `@pytest.mark.live_llm` — needs real LLM/embedder credentials.
|
|
Keep unit tests fast and credential-free; push anything needing real services
|
|
behind a marker or into `integration`/`e2e`.
|
|
- **Fixtures**: shared fixtures live in the nearest `conftest.py`. The root conftest
|
|
resets module caches (settings/logging/datetime) per test — rely on that for
|
|
isolation rather than mutating globals.
|
|
- **Module docstring** on each test file stating what contract it pins (see existing
|
|
tests for the style).
|
|
- **Coverage gate**: `make cov` enforces 80% (`--cov-fail-under=80`). New code should
|
|
not drop coverage below the gate.
|
|
- Run `make test` (unit) and `make integration` before pushing; both run in CI.
|