solpbc.org / solstone
personal memory agent
0
fork

Configure Feed

Select the types of activity you want to include in your feed.

solstone / docs / testing.md
at main 2.2 kB view raw view code
Jer Miller refactor: collapse top-level packages into solstone namespace
514dfbd9

Testing#

Test Structure#

  • Framework: pytest with coverage reporting
  • Unit Tests: tests/ root directory
    • Fast, no external API calls
    • Use tests/fixtures/journal/ mock data
    • Test individual functions and modules
  • Integration Tests: tests/integration/ subdirectory
    • Test real backends (Anthropic, OpenAI, Google)
    • Require API keys in .env
    • Test end-to-end workflows
  • Naming: Files test_*.py, functions test_*
  • Fixtures: Shared fixtures in tests/conftest.py

Fixture Journal#

# The autouse set_test_journal_path fixture in tests/conftest.py does this
# for unit tests. Set it explicitly only when a test needs a different journal.
os.environ["SOLSTONE_JOURNAL"] = "tests/fixtures/journal"
# Now all journal operations work with test data

The tests/fixtures/journal/ directory contains a complete mock journal structure with sample facets, agents, transcripts, and indexed data for testing.

Running Tests#

  • make test for unit tests
  • make test-apps to run app tests
  • make test-integration for integration tests
  • make test-all to run all tests (core + apps + integration)
  • make test-only TEST=path to run specific tests
  • make coverage to generate a coverage report
  • make ci before committing (formats, lints, tests)
  • Always run sol restart-convey after editing solstone/convey/ or solstone/apps/ to reload code

Worktree Development#

Run the full stack (supervisor + callosum + sense + cortex + convey) against test fixture data:

make dev                    # Start stack (Ctrl+C to stop)

In a second terminal, hit endpoints:

export SOLSTONE_JOURNAL=tests/fixtures/journal
export PATH=$(pwd)/.venv/bin:$PATH
curl -s http://localhost:$(cat tests/fixtures/journal/health/convey.port)/

Notes:

  • Agents won't execute without API keys — this is expected in worktrees
  • Output artifacts go in scratch/ (git-ignored)
  • Service logs: tests/fixtures/journal/health/<service>.log
  • make dev writes runtime artifacts (stats cache, health logs, task logs) into the fixtures journal — these are covered by tests/fixtures/journal/.gitignore and should never be committed