Skip to content

Upstream Source

This page is part of Truthound Orchestration 3.x.

Source repository: seadonggyun4/truthound-orchestration Upstream docs path: docs/migration/3.0.md Edit upstream page: Edit in orchestration

3.0 Migration

What Changed

The 3.0 line is the first Truthound-3-only orchestration line.

Breaking changes:

  • truthound-orchestration 3.x targets Truthound>=3.0,<4.0
  • the Truthound adapter now maps ValidationRunResult instead of legacy report shapes
  • default Truthound orchestration contexts are ephemeral and non-persistent
  • platform packages are expected to use the shared resolver and preflight APIs

If You Are Upgrading From 1.x

  1. Upgrade Truthound itself to 3.x.
  2. Upgrade the orchestration package line to 3.x.
  3. Remove assumptions tied to legacy Truthound report objects.
  4. Prefer shared resolver and serialization helpers if you maintain custom wrappers.
  • run your main platform smoke tests
  • confirm local zero-config runs do not create .truthound/ in project roots
  • confirm SQL sources have the expected connection or profile configured
  • confirm any custom engine registration still works through the plugin or registry path