tomtan/EverOS
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
518b8eca855fcd9310afa7c254edf6c6a8f2a938
EverOS/.claude/rules/testing.md
Elliot Chen 518b8eca85 chore: initialize EverOS 1.0.0 
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.
2026-06-06 07:33:17 +08:00

1.2 KiB
Raw Blame History

paths
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.