TELEN

TELEN is a query-conditioned graph residual system for Vietnamese statutory article retrieval. It stores provision vectors in a stable text space, appends new legal versions without re-encoding older vectors, and adds a bounded local residual only when the candidate graph exposes a typed edge.

This Hub repository mirrors the tested source release. It contains no manuscript, benchmark records, trained checkpoint, embedding cache, or per-query rankings. The absence of model weights is intentional.

Runtime contract

legal update
  -> validate new versions and events
  -> encode new provision texts only
  -> append vectors and graph state
  -> verify unchanged parameters and older vectors

query
  -> frozen text candidates
  -> typed local graph messages
  -> structural evidence gate
  -> bounded residual
  -> final ranking

If a candidate has no exposed graph edge, the residual is exactly zero and its final score equals its frozen text score.

Install

git clone https://github.com/dangdinh2405/telen.git
cd telen
python -m pip install -e ".[dev]"

Verify

python examples/frozen_update_demo.py
python -m pytest -q
python scripts/audit_public_release.py

Source layout

• src/telen/: current TELEN package and TELENEngine public API.
• src/telen/legacy/: compatibility code used only by predecessor-baseline scripts.
• scripts/: experiment preparation, interventions, controls, and evaluation commands.
• tests/: offline unit and contract tests.
• docs/: architecture and experiment guidance.

No fitted TELEN checkpoint is distributed. The earlier TELEN-GP checkpoint and all paper materials are held in private archives and are not part of this release.

DRiLL, ALQAC, FiscalQA, and licensed Vietnamese retrieval data must be obtained independently from their providers.