Entity System Architecture

Characters are the primary agents of narrative prose. Beyond standard bios, roles, statuses, and aliases, characters possess temporal superpowers:

• Time-Anchored Knowledge States: Discrete facts tracked by who knows what and when they learned it. Lenses filter information based on the active chapter or world time.
• Dynamic Relationship Turning Points: Unidirectional (subjective feelings like trust/spite) and mutual social bonds (married, allies) that evolve at specific chapters or dates.
• Time Gutter Paragraph Reactivity: Setting a paragraph time override (e.g. a flashback) automatically shifts the active world time and updates the character's visible knowledge in real-time.
• Live Age Calculator: Computes the character's exact in-world age against the custom world calendar.

Locations represent the spatial environment of the story, organized into an intuitive tree with atmospheric inheritance:

• Hierarchical Nesting (Self-Referencing Tree): Locations reference a parent_location_id with built-in cyclic protection and drag-and-drop tree reordering.
• 5-Level Cascading Weather Inheritance: Setting "Heavy Blizzard" on a parent region (e.g. The Northern Reach) automatically cascades down to all child rooms and points of interest unless explicitly overridden.
• Cursor-Synchronized Weather Context: Moving your cursor in the editor refreshes the Location Inspector to display the exact weather condition at that story moment.

Generic Catch-All Classification: Rather than forcing writers into rigid schemas (e.g., hardcoding distinct tables for spells vs artifacts vs religions), FleshNote uses an open-ended lore model.

• Custom User Categories: Writers define their own arbitrary categories (e.g. artifact, magic_spell, organization, relic, concept, vehicle, deity) via project configuration.
• Unrestricted Creativity: The system adapts to any genre or worldbuilding complexity without code changes while preserving full linkification, autocomplete, and appearance tracking.
• Dedicated Inspector Fields: Provides fields for rules, origin, limitations, aliases, and notes.

Replaces the Deprecated "Secrets" & "Danger Phrases" System: Legacy versions attempted to track secrets via keyword scans. This has been completely replaced by a structured, two-part clue-and-reveal lifecycle.

• Clue Tracking & Quick Jumps: Authors highlight foreshadowing breadcrumbs ({{foreshadow:ID|clue}}) in chapters leading up to the reveal chapter ({{twist:ID|reveal}}).
• Twist Spacing Warnings Engine: Heuristic analysis alerts the writer if clues are clustered too close together or if a "desert gap" leaves readers without hints for thousands of words.
• Reader Experience Visualization: Multi-lane Plot Planner trajectory lines display clue distribution to audit pacing for complex mysteries.