thoth

How to test and verify changes to thoth — the tox GATE, the injected-fakes testing model (and why green CI does not prove a boundary change works), the live-smoke marker, and how to deploy a branch to the live VPS appliance and verify it before merge (the gold standard: git checkout + uv sync + systemd restart, plus the deploy-to-verify gotchas). Use when running the test suite, adding tests, deciding whether a change is safe to merge, or deploying / testing / verifying a branch on the VPS (the live appliance / production box) — e.g. "test this on the vps", "deploy the branch to the appliance", "verify live before merge", "restart thoth-slack". Also covers packaging/publishing the container image + OCI Helm chart (Charts/thoth, _helm.yml, the helm-schema hook foot-guns, verifying a ghcr publish is public) — e.g. "test the chart publish", "tag a beta", "why does the helm-schema lint hook fail".

Engineering and process conventions for working on thoth that aren't obvious from the code — how to shape LLM output, the clean-slate stance, and how findings turn into issues and docs. Use when implementing a feature, changing LLM-facing prompts, or deciding how to record work.

Orientation map for the thoth codebase — what to read first, what each module does, the vault page-type model, and the Hindsight semantic-index reality. Use when starting work on thoth and you need to know where things live or which file owns a responsibility, before diving into a feature or bug.