Contributing

python -m pip install -e '.[dev]'
./lint.sh                 # ruff and mypy on honed/
python -m pytest -q       # tests/ ; the Graphify fixtures need the tests/fastapi submodule

Tests make no model calls: scripted runtimes stand in for reflectors, curators, and mergers, and call the real MCP tools. Live checks are the cookbook scripts.

Where things are defined

  • Concepts (docs/concepts.md) defines every concept — AgentConfig, journal, markers, reflection, curation, merging — and is updated together with the code.

Layout

Package Holds
honed.resources AgentConfig, resources, workspace, journal, ratings, markers, git, installation
honed.sessions Transcript indexing and selection; analysis/ contains graph and pattern views, scanner/ behavioural matching, and export/ harness conversions
honed.reflection Reflector, harness runtimes, the MCP tool server, Markdown rendering
honed.curation Curator and Merger
honed.evolve The /evolve skill: setup, rounds, and its recipe
honed.flow Flow tracking and its visualisation

Session analysis APIs are available from honed.sessions.analysis (and the supported honed.sessions package exports). The former flat imports such as honed.sessions.workgraph have been removed.