import unittest
from assistant import answer, Document

class ContractTests(unittest.TestCase):
    def test_known(self):
        r = answer("timeout retry")
        self.assertEqual((r["status"], r["source"]), ("evidence", "D1"))
        self.assertEqual(r["trace"][0]["score"], 1.0)
    def test_unknown_and_empty(self):
        for query in ("", "quasar orbit", "日本語"):
            self.assertEqual(answer(query)["status"], "abstain")
    def test_no_private_trace(self):
        r = answer("private incident recovery password")
        self.assertEqual(r["status"], "abstain")
        self.assertNotIn("D3", str(r))
    def test_stable_tie(self):
        docs = (Document("B", "retry"), Document("A", "retry"))
        self.assertEqual(answer("retry", docs)["source"], "A")
    def test_boundaries(self):
        self.assertEqual(answer("timeout missing")["status"], "evidence")
        self.assertEqual(answer("timeout missing extra")["status"], "abstain")
        self.assertEqual(answer("retry", ())["status"], "abstain")
    def test_invalid(self):
        for query in (None, "x" * 2001):
            with self.assertRaises(ValueError): answer(query)
        with self.assertRaises(ValueError): answer("retry", threshold=0)
        with self.assertRaises(ValueError): answer("retry", (Document("A", "x"), Document("A", "y")))
    def test_lexical_failure_is_visible(self):
        # Semantically similar wording is intentionally NOT solved by this baseline.
        self.assertEqual(answer("connection stalled")["status"], "abstain")

if __name__ == "__main__":
    unittest.main()
