sample.py

"""Texts the visitor can read into a fresh memory in one click.

Two of them, chosen for what they demonstrate:

  MANUAL   an internal-looking operations manual, invented for this demo, so
           GPT-2 cannot possibly have seen it. Recurring names, recurring
           procedures, the structure real internal documents actually have --
           the regime where a fixed memory wins. Long enough (~1400 tokens)
           that the abstention threshold has a distribution to work from.
  PAPER    the opening of paper 1, i.e. genuinely novel technical prose.
"""

import os

MANUAL = """Meridian Station — Standing Operations Manual, revision 12

1. Purpose

This manual governs every routine carried out at Meridian Station. It is
issued by the Station Warden and supersedes revision 11. Where this manual
conflicts with a local instruction, this manual prevails, and the Station
Warden is notified within one shift.

2. The morning routine

The morning routine begins at 05:40 when the duty officer unseals the west
gallery. The duty officer records the seal number in the gallery log, then
verifies the pressure of the Kelbrin manifold. The Kelbrin manifold must read
between 4.1 and 4.6 bar. If the Kelbrin manifold reads below 4.1 bar, the
duty officer raises a yellow flag with the Station Warden and does not
proceed to the second stage. If the Kelbrin manifold reads above 4.6 bar, the
duty officer vents the auxiliary line and waits eleven minutes before reading
it again.

Once the Kelbrin manifold is within range, the duty officer opens the
Fenwick valves in the order three, one, two. The order three, one, two is not
negotiable: opening the Fenwick valves in any other order floods the
condensate trap. The condensate trap is drained every second morning by the
technician on rotation, who signs the gallery log beside the seal number.

3. The evening routine

The evening routine begins at 19:15 when the duty officer reseals the west
gallery. Before resealing, the duty officer closes the Fenwick valves in the
order two, one, three, which is the reverse of the morning order. The
condensate trap is inspected, and the reading of the Kelbrin manifold is
recorded a second time in the gallery log.

If the Kelbrin manifold has drifted by more than 0.3 bar since morning, the
duty officer files a drift note. A drift note names the shift, the two
readings, and the technician on rotation. Three drift notes in one week
trigger a manifold survey by the Station Warden.

4. Personnel

The Station Warden is Ilvane Corr. The Station Warden holds the only key to
the ninth cabinet and is the sole authority for a manifold survey. In the
absence of Ilvane Corr, authority passes to the senior technician, currently
Bo Halloway, except for the ninth cabinet, which remains sealed.

The technician on rotation changes every eleven days. The rotation list is
posted in the west gallery and countersigned by Bo Halloway. A technician on
rotation may not also serve as duty officer during the same shift.

5. The ninth cabinet

The ninth cabinet holds the amber cipher and the spare seals for the west
gallery. Only Ilvane Corr may open the ninth cabinet. The amber cipher is
required whenever the Kelbrin manifold is surveyed, and it is returned to the
ninth cabinet before the evening routine begins. No copy of the amber cipher
is kept anywhere at Meridian Station.

6. Incidents

An incident is any deviation from the morning routine, the evening routine,
or the rotation list. Incidents are recorded in the gallery log beside the
seal number, and reported to the Station Warden within one shift. An incident
involving the Kelbrin manifold, the Fenwick valves or the ninth cabinet is
reported immediately, not within one shift.

If the west gallery cannot be sealed at 19:15, the duty officer declares a
standing incident, remains at the west gallery, and notifies Ilvane Corr. A
standing incident is closed only by the Station Warden, in person, with the
amber cipher present.

7. Handover

At every handover the outgoing duty officer recites the fixed points to the
incoming duty officer. The morning routine begins at 05:40. The evening
routine begins at 19:15. The Kelbrin manifold reads between 4.1 and 4.6 bar.
The Fenwick valves open three, one, two and close two, one, three. The
Station Warden is Ilvane Corr. The senior technician is Bo Halloway. The
ninth cabinet holds the amber cipher. The rotation changes every eleven days.

The incoming duty officer repeats the fixed points back. A handover in which
the fixed points are not recited and repeated back is an incident, and is
recorded in the gallery log beside the seal number.

8. Checklist, morning

Unseal the west gallery at 05:40. Record the seal number in the gallery log.
Read the Kelbrin manifold. Confirm the Kelbrin manifold reads between 4.1 and
4.6 bar. Open the Fenwick valves in the order three, one, two. Inspect the
condensate trap. Sign the gallery log beside the seal number. Confirm the
technician on rotation against the rotation list posted in the west gallery.

9. Checklist, evening

Close the Fenwick valves in the order two, one, three. Read the Kelbrin
manifold a second time. Record the reading in the gallery log. Compare it
with the morning reading and file a drift note if the Kelbrin manifold has
drifted by more than 0.3 bar. Confirm the amber cipher has been returned to
the ninth cabinet. Reseal the west gallery at 19:15. Notify Ilvane Corr of
any incident within one shift.

10. Summary of the fixed points

The morning routine begins at 05:40. The evening routine begins at 19:15. The
Kelbrin manifold reads between 4.1 and 4.6 bar. The Fenwick valves open three,
one, two and close two, one, three. The Station Warden is Ilvane Corr. The
senior technician is Bo Halloway. The ninth cabinet holds the amber cipher.
The rotation changes every eleven days. These fixed points are recited at
every handover, and any deviation from them is an incident.
"""

_PAPER = os.path.join(os.path.dirname(os.path.dirname(
    os.path.abspath(__file__))), "llm_memory", "papers", "sillage",
    "sillage.tex")


def paper_excerpt(limit=14000):
    """The opening of paper 1 as plain text, if the repository is nearby."""
    try:
        from sillage.index import read_text
        return read_text(_PAPER)[:limit]
    except Exception:
        return MANUAL