Skip to content

Suggestion: Add knowledge-spread visualization tooling #1

@possibly

Description

@possibly

Knowledge visualization is a powerful feature for understanding emergent narratives in Viv worlds. I built a tool (viv-knowledge-diagrams) that visualizes three key perspectives:

  1. Knowledge tree - How knowledge of a specific action spread through characters (who told whom)
  2. Memory map - What a character knows and how they learned it (witnessed vs. secondhand)
  3. Propagation wave - Temporal waves of knowledge spread

Example of a memory map diagram:

◉ Varr — 133 memories (11 secondhand)

  Witnessed (122):
    retell-market-drama  sal:6  t=1740
    hold-court-from-bench  sal:4  t=300

  Learned secondhand (11):
    whisper-rumor-about  sal:5  t=1620  <- heard via elder-recounts-old-tale

This fills a gap. Viv already has built-in support for visualizing the causal graph (who did what, and what caused what). But there's no built-in way to visualize the knowledge layer: who remembers what, how they learned it, and how information spread through the world.

Having this as an official tool would help:

  • Authors understand if their knowledge-relaying actions are working as intended
  • Researchers study how knowledge spreads in procedural worlds
  • Debuggers trace knowledge formation bugs

The tool is language-agnostic (works with any Viv adapter) and minimal (just reads from the runtime state). It might be worth including in the official toolkit or linking from the Viv docs.

Reference: https://github.com/possibly/viv-knowledge-diagrams

Metadata

Metadata

Assignees

No one assigned

    Labels

    ecosystemViv tooling beyond the core componentsruntimeJavaScript runtime

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions