Files
ThothII/docs/index.md

1.6 KiB

ThothII documentation

ThothII is a human-reviewed datamart builder. It turns a question into validated SQL through an eight-phase workflow: the model proposes; a reviewer makes the decisions that are persisted.

Start with the path that matches the work you need to do:

I need to… Start here
Install or operate one instance Install and first start
Add, update, or prepare a workspace Workspace operations
Ask a question and review the SQL workflow User guide
Configure and refresh an authoritative database catalog Database management
Author and publish domain Evidence Evidence
Understand boundaries and persistence Architecture overview

How the documentation is organised

  • Install and operate documents host-side setup, authentication, lifecycle, workspaces, and Pi administration.
  • Use ThothII documents the two application paths: reviewed NL→SQL sessions and administrative database management.
  • Architecture and contracts explain why the system behaves as it does and define the machine-facing boundaries. Consult them when integrating or changing an implementation; they are not a substitute for an operator runbook.

The host-side tht command is the operator interface. The Python tht inside harness/ is a different, internal workflow CLI invoked by the core. In examples, use an absolute installation descriptor path whenever discovery is not unambiguous.