Skip to content

Repository files navigation

A luminous geodesic loop on a sphere, representing linguistic holonomy

Linguistic Holonomy

Inner Geometry of Meaning-preserving Transformations.

Local tests: 5 passed Python 3.11+ Research release Publication status: work in progress

Statistical text watermarks inhabit the freedom of the signifier: they mark choices of form that preserve meaning. This project studies what happens when a text is rewritten along a chain of meaning-preserving transformations. Its central proposal is geometric: two rewriting chains can share the same semantic endpoint and nevertheless differ by a measurable path residue, a holonomy.

The repository is the public research release accompanying the draft Linguistic Holonomy and the Erosion of Statistical Watermarks. It contains the manuscript, the exact proof certificates, runnable Python experiments, and immutable recorded outputs supporting the certified claims.

Important

This is a transparent work-in-progress snapshot dated 19 August 2026, not a submission package. The mathematical core and the synthetic detector experiments are certified; the real-text pilot is not yet large enough to execute the preregistered test. See Research status.

The idea in one line

For a chain of embedded linguistic states, the loop rotation separates as

$$ R_{\mathcal{U}} = R_{\mathrm{dir}} H, \quad H \in \mathrm{Stab}(v_0) \cong \mathrm{SO}(n-1). $$

The endpoint statistic sees $R_{\mathrm{dir}}$; the path remembers $H$.

flowchart LR
    A[initial text] --> B[rewrite 1]
    B --> C[rewrite 2]
    C --> D[final text]
    A -. semantic endpoint .-> D
    A --> E[direct transport R_dir]
    B --> F[path transport R_U]
    C --> F
    E --> G[holonomy H = R_dir^-1 R_U]
    F --> G
Loading

What is established

Result Status Evidence
The Sylvester signature of a linguistic-loop rotation degenerates to its rank; the angle spectrum is the finer invariant. Proven Certificate A
The loop rotation is parallel transport and factors into endpoint transport and a holonomy in $\mathrm{SO}(n-1)$. Proven Certificate B
For context-seeded watermarks, residual signal is controlled by the intact seeding windows; under independent retention it decays as $\rho^{h+1}$. Proven under stated hypotheses; numerically verified Certificate C
The implemented detectors are calibrated against their synthetic nulls. Verified, with explicit limitations Detector certificate
Holonomy energy predicts residual detectability beyond retention and semantic deficit on real rewriting chains. Not yet evaluable in the pilot Status and next steps

Explore the release

Quick start

The geometry and synthetic detector experiments need only NumPy and SciPy:

python -m venv .venv
python -m pip install -r requirements-dev.txt
python -m pytest -q
python scripts/exp_geometry_v1.py
python scripts/exp_decay_v1.py
python scripts/exp_detector_validation_v1.py

Each experiment creates a new immutable directory under results/runs/ with its outputs, log, environment, hashes, conclusions, and limitations.

The GitHub Actions workflow is included for pull requests and manual runs. Its first remote run could not start because GitHub reported an account-level billing lock; no remote test step executed. The same suite passes locally on Python 3.11. See Research status.

The real-text pipeline additionally downloads language and translation models:

python -m pip install -r requirements-full.txt
python scripts/exp_corpus_v1.py --n-prompts 30 --max-new-tokens 180
python scripts/exp_indicators_v1.py
python scripts/exp_analysis_v1.py

The first full run downloads roughly 2.5 GB of model weights. The scripts run on CPU, although the larger study described in STATUS.md will benefit substantially from a GPU.

Scientific context

The construction develops the formalism introduced by D. Corradetti and A. Marrani in Linguistic Loops and Geometric Invariants as a Way to Pre-Verbal Thought?. This repository corrects and refines the proposed signature invariant, identifies the loop rotation with spherical parallel transport, and connects the resulting path geometry to statistical text watermarking.

The draft deliberately makes no claim about undisclosed production watermarking systems. Its detector results concern the implemented green-list, Unigram, and context-seeded exponential families under the assumptions stated in the certificates.

Citation and reuse

Citation metadata are provided in CITATION.cff. No reuse license has been selected in this release; copyright remains with the author until a license is chosen explicitly.

Author

Daniele Corradetti
Grupo de Física Matemática, Instituto Superior Técnico, Lisbon
Departamento de Matemática, Universidade do Algarve, Faro


Geometry for the path. Statistics for the trace. Reproducibility for the claim.

About

Geometry of meaning-preserving rewriting paths and the erosion of statistical text watermarks.

Topics

Resources

Contributing

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages