Methodology

How Actalux works

How Actalux works

What we publish

Actalux indexes public records of the Clayton, Missouri school district: board meeting agendas, minutes, board packets, resolutions, curriculum documents, budgets, strategic plans, and transcripts of public board meetings. We also publish records obtained through Missouri Sunshine Law requests. We do not claim completeness of the record. We publish what we have gathered and can verify against a source.

Document processing

Documents are converted from their original format (PDF, HTML, or transcript) to plain text. Text is split into verbatim passages of approximately 200 words, preserving section boundaries and sentence integrity. No text is paraphrased or rewritten.

How search works

Search uses two methods in parallel:

  • Keyword matching finds passages containing your exact search terms, using PostgreSQL full-text search.
  • Semantic search finds passages with similar meaning, even when the exact words differ, using a 384-dimensional embedding (bge-small-en-v1.5) and pgvector cosine similarity.

Results from both methods are combined using reciprocal rank fusion (k=60). Passages that appear in both result sets rank higher than those appearing in only one.

Citation integrity

At ingestion time, every passage is verified to be an exact substring of its source document. Passages that fail this check are rejected. Each displayed passage includes a short hash ID (e.g., #q003f) that is a stable, shareable reference.

When the system generates a summary of search results, every claim in the summary must cite at least one passage by its hash ID. Unverified claims are removed after generation before the summary is displayed.

What we do not do

  • We do not editorialize, summarize without citation, or express opinions.
  • We do not publish closed session content.
  • We do not publish content about individual personnel, teachers, or students.
  • We do not infer intent or make causal claims unless explicitly stated in a source document.
  • We do not advocate for or against any candidate, ballot measure, or policy position.

Corrections

If you find an error, use the "Report an error" link on any page. Include the quote ID so we can locate the passage. Corrections are tracked publicly as GitHub issues; anyone can see what has been reported, investigated, and resolved.

Open source

The full source code is available at github.com/Actalux/actalux. Actalux is an independent, noncommercial public-records project. We take no paid advertising, track no users, and sell no data.