from pathlib import Path


README = Path(__file__).parents[1] / "README.md"


def test_readme_documents_hash_bound_producer_intake_and_revision_decisions():
    text = README.read_text()
    assert "POST /api/v1/human-gates/intake" in text
    assert "Idempotency-Key" in text
    assert '"candidate_hash"' in text
    assert "expected_revision" in text
    assert "STACKCHAIN_HUMAN_GATE_DB" in text
    assert "principal ID and login" in text
    assert "reopens the exact hash" in text


def test_readme_defines_privacy_safe_telegram_coalescing_contract():
    text = README.read_text()
    assert "Telegram coalescing contract" in text
    assert "#/my-work/human-gates" in text
    assert "count and route only" in text
    assert "candidate hash" in text
    assert "superseded" in text