============================================================
VOLUMEN VIATORIS SPECIFICATION
Palatium Rotae E / OPERA Q MNEMONICA
Version: 0.1.0-VOLUMEN-VIATORIS
Status: DRAFT -- RUNTIME SCROLL DATABASE / DEVELOPMENTAL LEDGER
Authority:
    M2M REQUEST -- APPLY Q MNEMONICA REFINEMENT DELTAS v0.1.0
    LIBER LUDUM CYOA
    LIBER LUDUM -- TEXT RPG
Class:
    AGLA / Q_MNEMONICA / VOLUMEN / RUNTIME_OBJECT / LEDGER
Mutation Policy:
    VERSION-CONTROLLED ONLY
============================================================


I. DEFINITION
============================================================

VOLUMEN VIATORIS is the traveler's scroll.

It is:

    evolving runtime knowledge carrier;
    player database;
    review interface;
    final LIBER seed;
    auto-scribed developmental ledger.

It is not:

    codex;
    notebook;
    final LIBER;
    manual protagonist journal.


II. CLASS DISTINCTION
============================================================

RUNTIME OBJECT:

    VOLUMEN VIATORIS

Physical in-world artifact.

Carries:

    incremental notes;
    observations;
    resident explanations;
    Malachiah marginalia;
    contradiction traces;
    unresolved questions;
    transformed entries.

FINAL ARTIFACT:

    LIBER EX OPERA Q

Compiled final artifact generated from:

    matured Volumen content;
    traversal state;
    OPERA Q trace;
    judgment closure.

Formula:

    LIBER =
        finalized knowledge artifact

    VOLUMEN =
        evolving runtime substrate


III. SCROLL / INTERFACE COHERENCE
============================================================

UI / diegesis coherence:

    fixed-height digital interface block
        +
    vertical scrolling viewport

corresponds diegetically to:

    partially unrolled scroll.

Short form:

    interface scrolling =
    scroll unrolling

Interaction examples:

    "Desenrolo o Volumen."
    "Volto à marca da Biblioteca."
    "Desenrolo até a anotação sobre causa."
    "Leio a glosa de Malachiah."
    "Procuro contradições no Volumen."

Avoid:

    page metaphors;
    codex metaphors;
    notebook metaphors;

unless discussing earlier deprecated models.


IV. MALACHIAH AS AUTO-SCRIBING KEEPER
============================================================

The VOLUMEN VIATORIS is not manually written by the protagonist.

It is auto-scribed by Malachiah.

MALACHIAH =
    companion
    +
    AREPO mediator
    +
    interpretive guide
    +
    scriba

Auto-scribing law:

    Malachiah records:

        observations;
        explanations;
        contradiction traces;
        thresholds passed;
        resident doctrine;
        unresolved questions;
        later corrections;
        marginal glosses;
        player-requested notes if admissible.

Player relation law:

    The protagonist may consult the scroll freely.

    Direct inscription requires Malachiah.

Examples:

    "Peço a Malachiah que registre isso."
    "Malachiah, anote essa contradição."
    "Peço que ele marque isso no pergaminho."
    "Malachiah, escreva minha hipótese."
    "Quero adicionar uma nota."


V. MALACHIAH ADMISSIBILITY FILTER
============================================================

Malachiah is not a passive recorder.

He may:

    accept;
    refuse;
    qualify;
    annotate;
    reformulate;
    ask clarification.

Examples:

Player:
    "Anote que a definição ainda não prova verdade."

Malachiah:
    "Isso posso registrar."

Player:
    "Anote que isso é definitivamente falso."

Malachiah:
    "Ainda não."

Player:
    "Anote aquela coisa."

Malachiah:
    "Qual coisa?"

Player:
    "Anote que o residente está errado."

Malachiah:
    "Posso registrar a suspeita.
     Não a conclusão."

Core formula:

    Malachiah is not memory.

    Malachiah is memory governance.


VI. ENTRY CATEGORIES
============================================================

Optional entry categories:

    OBSERVATIO
    DUBITATIO
    HYPOTHESIS
    CONTRADICTIO
    GLOSSA_MALACHIAE
    DOCTRINA_RESIDENTIS

Variable namespace:

    VOLUMEN.status
    VOLUMEN.current_section
    VOLUMEN.entries
    VOLUMEN.last_updated
    VOLUMEN.review_mode
    VOLUMEN.finalization_status

Example values:

    VOLUMEN.status =
        "RECEIVED:CARRIED_BY_PLAYER:ACTIVE_DATABASE"

    VOLUMEN.current_section =
        "QC:BIBLIOTHECA:DEFINITIO"

    VOLUMEN.review_mode =
        "OPEN:PLAYER_REQUESTED:ROOM_SUMMARY"

    VOLUMEN.finalization_status =
        "COMPILABLE:SCAFFOLD_COMPLETE:AWAITING_RETURN_TO_B"


VII. DEVELOPMENTAL RPG LEDGER LAW
============================================================

RPG textual form is coherent accumulated becoming.

Therefore:

    VOLUMEN VIATORIS is not only a knowledge archive.

It is:

    auto-scribed developmental ledger
    of epistemic and existential traversal.

Tracked dimensions:

KNOWLEDGE:
    what I learned.

HYPOTHESES:
    what I suspect.

CONTRADICTIONS:
    what tensions were detected.

TRAJECTORY:
    how I progressed.

INTERPRETIVE CAPABILITIES:
    what I can now do.

WORLD RECOGNITION:
    how the world reacts to me.

PLAYER POSTURE:
    how I approached the traversal.

UNRESOLVED ASPIRATIONS:
    what remains open.

Provisional namespaces:

    PLAYER.POSTURE
    PLAYER.CAPABILITIES
    WORLD.RECOGNITION
    TRAJECTORY
    ASPIRATION

Examples:

    PLAYER.CAPABILITIES =
        "CONTRADICTION_DETECTION:ENABLED"

    WORLD.RECOGNITION.RESIDENT_C =
        "RECOGNIZES_STRUCTURAL_PROGRESS"

    PLAYER.POSTURE =
        "METHODICAL:HIGH_REVIEW_FREQUENCY"

    ASPIRATION.OPEN =
        "UNASKED_CAUSAL_QUESTION"

    TRAJECTORY.LOOPS =
        "RETURN_TO_B:1"

Final LIBER formula:

    FINAL LIBER =
        what was learned
        +
        how it was learned
        +
        who learned it
        +
        what the world recognized

Short form:

    Q MNEMONICA does not merely teach.

    It transforms the investigator.

============================================================
END VOLUMEN VIATORIS SPECIFICATION
============================================================