Knowledge, Secrets, and Player Visibility

Facts, knowledge, and disclosure should be first-class data.

Many continuity tools store secrets as hidden text inside notes. That makes them hard to query. ttrpg-forge should model the underlying fact, who knows or believes it, and who is allowed to see it.

Fact

A fact is a claim about the project or a continuity.

Example:

Fact:
  The old bridge is unsafe.

Scope:
  Main canon

Secret

A secret is a fact or disclosure state that is hidden from some audiences.

Example:

Secret:
  The old bridge is unsafe.

Known by:
  bridge keeper
  town engineer

Unknown to:
  villagers
  player characters

Long term, Secret should usually be modeled as restricted disclosure around a fact rather than as an unrelated note.

Knowledge and Belief

Knowledge describes who knows or believes a fact and with what certainty.

Character -> knows -> Fact
Faction -> suspects -> Fact
PlayerCharacter -> falsely_believes -> Fact

Visibility

Visibility controls who can see data in the application.

Common visibility levels:

• private to owner
• visible to GMs
• visible to collaborators
• visible to specific players
• visible to continuity participants
• public

Belief vs Truth

The system should allow false beliefs.

Example:

Truth:
  The bridge failed because of poor maintenance.

Belief:
  The villagers think a monster damaged the bridge.

This allows mystery, propaganda, misinformation, and unreliable witnesses without corrupting the real project state.