Behavioral Modulation Signal (BMS)

A Comprehensive Introduction to Understanding and Building with Temporal Intelligence Data Points

Guidebook v1.0
1

What is the Behavioral Modulation Signal (BMS)?

The Behavioral Modulation Signal (BMS) is a standardized framework for understanding and working with timing-aware intelligence. It translates complex temporal patterns derived from natural time cycles into actionable, machine-readable signals that can influence and modulate behavior in digital systems.

Core Concept

Think of BMS as a "behavioral weather report" - just as weather data tells you the atmospheric conditions that might influence outdoor activities, BMS tells you the temporal conditions that might influence behavioral expressions, decision-making patterns, and interaction styles.

The Six Pillars of BMS

Every BMS signal is built upon six fundamental pillars that together describe a complete temporal state:

1
Temporal Position

Your current location within natural time cycles. This describes "where" you are in the temporal landscape at any given moment.

2
Behavioral Phase

The active state currently influencing behavior. Like seasons affect nature, phases affect how behaviors naturally want to express themselves.

3
Expression Intensity

How strongly temporal patterns manifest at any moment. Some times have subtle influence; others have pronounced effects.

4
Maturity Level

The long-term developmental trajectory. This represents accumulated temporal experience over extended periods.

5
Daily Rhythm

The 24-hour behavioral modulation cycle (SIPS). This captures the micro-temporal fluctuations throughout each day.

6
Harmony Score

The alignment between short-term (SIPS) and long-term (Vortex) patterns. High harmony means consistent behavioral flow.

BMS doesn't predict what will happen - it describes the temporal conditions under which things are happening. Understanding this distinction is key to building effective BMS-aware systems.

2

The Nine Calendars (Elements)

The BMS system operates through nine distinct temporal dimensions, each represented by a unique "calendar." These calendars are not traditional date systems but rather represent different aspects of temporal influence on behavior. Each calendar governs a specific domain of behavioral expression.

Understanding Calendars

Think of each calendar as a different "lens" through which temporal patterns can be observed. Just as light can be split into different wavelengths (colors), temporal influence can be split into these nine fundamental elements.

🛡
The Monolith of Stillness
Element: Individuality

Represents the baseline identity rhythms - the fundamental "self" that remains constant beneath all other fluctuations.

Domain: Core identity, personal constants, unchanging traits
Code: 7F7F7F | ID: monolith-stillness
🔥
The Crimson Forge
Element: Capacity

Governs effort readiness rhythm - the available energy and drive for action and accomplishment.

Domain: Energy levels, action potential, drive intensity
Code: FF0000 | ID: crimson-forge
🛢
The Ember Serpent
Element: Flexibility

Controls adaptation rhythm - the ability to change, adjust, and respond to new circumstances.

Domain: Adaptability, change tolerance, response agility
Code: FF4000 | ID: ember-serpent
🞄
The Solar Loom
Element: Stability

Manages consistency and anchoring - the tendency toward steady, reliable patterns.

Domain: Consistency, reliability, grounding
Code: FFFF00 | ID: solar-loom
🞃
The Emerald Grid
Element: Context

Influences perception and decision timing - how information is processed and choices are made.

Domain: Perception, awareness, decision-making
Code: 00FF00 | ID: emerald-grid
🞏
The Tidal Compass
Element: Continuity

Governs long-term behavioral durability - the persistence and endurance of patterns over time.

Domain: Persistence, endurance, long-term patterns
Code: 00FFC0 | ID: tidal-compass
🌑
The Indigo Exile
Element: Content

Controls depth and introspection - the capacity for inner reflection and deeper understanding.

Domain: Introspection, depth, inner reflection
Code: 0000FF | ID: indigo-exile
The Twin Spiral
Element: Duality

Manages alternating behavioral polarities - the oscillation between opposing tendencies.

Domain: Polarity, balance, opposing forces
Code: FF00FF | ID: twin-spiral
The Ouroboric Gate
Element: Connectivity

Represents integration of all systems - the holistic connection between all other calendars.

Domain: Integration, wholeness, systemic harmony
Code: 606F | ID: ouroboric-gate

Key Insight

When building a BMS system, you can choose to work with all nine calendars for comprehensive analysis, or focus on specific calendars relevant to your use case. For example, a productivity app might prioritize Capacity and Stability, while a meditation app might focus on Content and Connectivity.

3

Understanding Temporal Layers

The BMS system processes temporal data through four distinct layers, each providing a different perspective on behavioral patterns. Understanding these layers is essential for interpreting BMS signals correctly.

1
SIPS
Micro-Temporal
2
Vortex
Macro-Temporal
3
Lumina Map
Expression
4
Lumina Coord
Maturity

Layer 1: SIPS (Micro-Temporal)

SIPS (Streaming Intelligence Pulse Signal) represents the 24-hour behavioral modulation cycle. It captures the moment-to-moment fluctuations in temporal influence throughout each day.

Analogy

SIPS is like checking the current temperature - it tells you what's happening right now and in the immediate hours ahead. It's highly responsive and changes frequently.

Layer 2: Vortex (Macro-Temporal)

Vortex provides long-term evolution potential analysis. While SIPS shows the present moment, Vortex reveals the broader temporal trajectory and underlying patterns that persist over extended periods.

Analogy

Vortex is like checking the seasonal forecast - it tells you the general conditions you can expect over weeks or months. It changes slowly and represents deeper patterns.

Layer 3: Lumina Map (Expression)

Lumina Map calculates temporal position (0-360 degrees) and measures the distances between different calendar expressions. It shows how each calendar element is currently expressing itself relative to others.

Key Output

temporal_location: A degree value (0-360) showing position in the temporal cycle
inter_calendar_distances: How far apart different calendar expressions are from each other

Layer 4: Lumina Coordinate (Maturity)

Lumina Coordinate provides the "Temporal Station" (rho value) and "Temporal Shift" measurements. This layer indicates developmental maturity and the magnitude of temporal changes over time.

Key Output

temporal_station: The rho value representing accumulated temporal development
temporal_shift: The magnitude and direction of temporal change (for dual-date calculations)

4

Numeric Metrics Deep Dive

Both SIPS and Vortex layers output ten numeric metrics for each calendar. These metrics are the quantitative foundation of the BMS signal, each measuring a specific aspect of temporal influence.

Anatomy -100 to 100

Measures physical and structural influence. Represents how temporal conditions affect physical or foundational aspects of behavior.

Use for: Physical activity recommendations, energy-based UI adjustments, structural decision-making
🌱
Yield -100 to 100

Measures output and production capacity. Indicates the potential for productive output and accomplishment during this temporal window.

Use for: Productivity scoring, task scheduling, output predictions
🌎
Culture -100 to 100

Measures environmental and contextual factors. Represents the social and relational aspects of temporal influence.

Use for: Social interaction timing, team collaboration optimization, communication style
TimeTravel -100 to 100

Measures temporal displacement and sensitivity. Indicates how connected or disconnected from the present moment one might feel.

Use for: Mindfulness prompts, presence-based features, temporal awareness
Elevation -100 to 100

Measures vertical energy direction. Represents upward (expansive) or downward (grounding) energy tendencies.

Use for: Mood indicators, aspiration vs. grounding activities, vertical UI metaphors
Horizon 0 to 360

Measures directional orientation in degrees. Indicates the "compass direction" of current temporal influence.

Use for: Directional UI elements, compass-based visualizations, orientation metaphors
Ground 0 to 100,000

Measures grounding factor. Higher values indicate stronger connection to foundational, stabilizing influences.

Use for: Stability indicators, grounding exercise suggestions, foundation strength
Aura 0 to 5,000,000

Measures energy field size. Represents the "reach" or sphere of influence of current temporal patterns.

Use for: Influence radius visualization, impact scope, presence intensity
🔏
Magnetism 0 to 1,000

Measures attraction force. Indicates the pull or draw toward certain behaviors, people, or outcomes.

Use for: Attraction-based recommendations, connection strength, affinity scoring
Charge -100 to 100

Measures energy polarity. Positive values indicate outward/active energy; negative values indicate inward/receptive energy.

Use for: Active vs. passive mode suggestions, energy direction, polarity-based UI

Interpreting Ranges

Bipolar metrics (-100 to 100): Zero represents neutral/balanced state. Positive and negative values represent opposing tendencies, neither inherently "good" or "bad."

Unipolar metrics (0 to max): Higher values represent greater intensity of that quality. Scale varies by metric - always normalize before comparing different metrics.

5

Categorical Fields Explained

In addition to numeric metrics, SIPS and Vortex provide eight categorical fields that classify temporal states into discrete categories. These are easier to interpret directly and are ideal for conditional logic in your systems.

timeQuadrant

Describes temporal coherence state - how integrated or fragmented the current temporal experience is.

Values: Integrated, Fragmented, Disintegrated, Q1, Q2, Q3, Q4
Use for: Focus ability, coherence indicators, attention management
season

Indicates the cyclical position within a temporal pattern - where in the natural cycle you currently reside.

Values: Spring, Summer, Autumn/Fall, Winter
Use for: Growth phases, renewal vs. rest, seasonal metaphors
direction

Shows cardinal orientation - the general direction of temporal energy flow.

Values: North, East, South, West, and compound directions
Use for: Directional metaphors, navigation UI, orientation
scale

Defines the scope of influence - how broadly the temporal pattern extends.

Values: Micro, Human, Macro, Cosmic, Supra-Human
Use for: Impact scope, personal vs. universal, scale-based features
phase

Identifies the current cycle phase - like lunar phases but for temporal patterns.

Values: Waxing, Peak/Full, Waning, Rest/New
Use for: Building vs. releasing energy, peak timing, rest indicators
actionType

Recommends the mode of action best suited to current temporal conditions.

Values: Voluntary, Reflexive, Passive, Expand, Sustain, Contract, Rest
Use for: Action recommendations, behavior mode, activity suggestions
numericalQuotient

Describes the overall tendency or resonance pattern of the current moment.

Values: Binary, Ternary, Quaternary, Quinary, Positive, Neutral, Negative
Use for: Pattern complexity, resonance type, numerical metaphors
stage

Indicates progress within the current action or development cycle.

Values: Potential, Action Potential, Action, Completion, Nascent, Emerging, Established, Mature
Use for: Progress indicators, development stage, readiness levels
6

BMS Signal Properties

When you receive a processed BMS signal (through the BMS WebSocket stream or SDK), it includes additional computed properties specifically designed for modulating AI/ML systems, avatars, and user interfaces.

Core Signal Properties

density ~0.8 to ~1.3

The "weight" or intensity of the current temporal state. Higher density means more pronounced temporal influence.

Use for: LLM tone modulation (>1.1 = energetic, <0.9 = calm), avatar size/presence
brightness 0 to 1

The clarity or expressiveness level. Higher brightness means more overt, clear expression of behavioral tendencies.

Use for: Expressiveness levels (>0.7 = high), visual brightness in UI, clarity indicators
visibility 0 to 1

How apparent or observable the temporal patterns are. Higher visibility means patterns are more easily perceived.

Use for: Transparency levels, UI opacity, awareness indicators
rhythmScale ~0.8 to ~1.2

The tempo or pace of temporal cycles. Higher values indicate faster rhythms; lower values indicate slower, steadier rhythms.

Use for: Animation speeds, response timing, pacing adjustments

Spatial Properties

spatialX, spatialY, spatialZ 0 to 1

Three-dimensional positioning coordinates. Represent the "location" of the signal in abstract behavioral space.

Use for: 3D avatar positioning, spatial audio, coordinate-based visualizations
cohesiveness 0 to 1

How unified or scattered the behavioral signal is. Higher cohesiveness means more focused, integrated behavior patterns.

Use for: Stability indicators (>0.7 = stable), focus levels, coherence displays

Interaction Properties

interactionDepth 0 to 1

The depth or intensity of engagement potential. Higher values suggest capacity for deeper, more meaningful interactions.

Use for: Conversation depth, engagement level, connection quality
responsiveness 0 to 1

The speed and quality of reaction potential. Higher values indicate quicker, more agile response tendencies.

Use for: Response speed (>0.6 = quick), reaction timing, adaptiveness
wobbleScale 0 to 1

The degree of variability or oscillation in behavior. Higher values indicate more variable, less predictable patterns.

Use for: Variability indicators, unpredictability levels, animation jitter

Visual & Physics Properties

rotationalVelocity ~0.8 to ~1.2

The speed of rotational or cyclical movement. Affects spinning animations and cyclical behaviors.

Use for: Rotation animations, spin effects, cyclical UI elements
magneticPull 0 to 1

The attraction force toward center or focus points. Higher values create stronger gravitational effects.

Use for: Attraction effects, gravity simulations, centering forces
auraRadius ~1.0 to ~2.0

The size of the influence field around the entity. Affects glow effects and presence indicators.

Use for: Glow/aura effects, presence visualization, influence range
harmonyGlow ~0.8 to ~1.3

The visual intensity of harmony or alignment. Higher values create brighter, more harmonious visual effects.

Use for: Harmony visualization, alignment indicators, peace/conflict UI
formSolidity ~0.8 to ~1.2

The firmness or fluidity of form. Higher values suggest more solid, defined shapes; lower values suggest more fluid forms.

Use for: Shape definition, solidity vs. fluidity, form stability
stageModifier ~0.9 to ~1.1

A multiplier based on current developmental stage. Modifies other values based on maturity level.

Use for: Stage-based adjustments, maturity multipliers, growth indicators
7

Harmony Analysis

Harmony Analysis is a derived analysis that compares SIPS (micro-temporal/daily rhythm) with Vortex (macro-temporal/long-term patterns). It reveals how aligned or misaligned your short-term behavioral patterns are with your long-term trajectory.

The Harmony Principle

When SIPS and Vortex are aligned, behavior flows naturally and efficiently. When misaligned, there may be internal friction - like trying to sprint during a time suited for rest, or resting when conditions favor action.

Harmony Analysis Data Points

harmonyQuotient 0.0 to 1.0

The primary alignment score between SIPS and Vortex. A value of 1.0 means perfect alignment; 0.0 means complete misalignment.

Interpretation:
• 0.8-1.0: High harmony - behavior naturally aligned
• 0.5-0.8: Moderate harmony - some adaptation needed
• 0.0-0.5: Low harmony - significant friction present
frictionQuotient 0.0 to 1.0

The inverse of harmony (1 - harmonyQuotient). Measures the degree of misalignment or internal resistance.

Use for: Resistance indicators, friction warnings, conflict detection
categoricalAlignmentScore 0.0 to 1.0

Measures how many categorical fields (season, phase, direction, etc.) match between SIPS and Vortex.

Use for: Category match rate, pattern consistency, qualitative alignment

Practical Example

High Harmony (0.85): "Your current energy (SIPS) matches your long-term rhythm (Vortex). This is an optimal time for important activities."

Low Harmony (0.35): "Your immediate impulses may conflict with your deeper patterns. Consider whether short-term desires align with long-term goals."

8

Maturity Analysis

Maturity Analysis combines Lumina Map (expression/position) with Lumina Coordinate (maturity/development) to assess the developmental stage and expression mode of each calendar element. This analysis is keyed by Element name (e.g., "Capacity") rather than calendar ID.

Maturity Analysis Data Points

maturityQuotient 0.0 to 1.0

The overall maturity level derived from the temporal station (rho value). Higher values indicate more developed/mature patterns.

Interpretation: Represents accumulated temporal development and wisdom in this element
expressionIntensity 0.0 to 1.0

How strongly this element is currently expressing itself, derived from Lumina Map position.

Use for: Expression strength, prominence indicators, visibility levels
developmentStage

Categorical classification of the current developmental stage.

Values: NASCENT, EMERGING, DEVELOPING, ESTABLISHED, MASTERED
Use for: Progress tracking, growth indicators, stage-appropriate responses
expressionMode

Whether the element is currently expressing actively or passively.

Values: ACTIVE (expressionIntensity > 0.5), PASSIVE (≤ 0.5)
Use for: Action vs. reception mode, engagement style
behavioralArchetype

A classification based on the combination of expression intensity and maturity quotient.

Values: SAGE, WARRIOR, GUARDIAN, SEEKER
Use for: Personality typing, response style, interaction approach
9

The Four Behavioral Archetypes

The Behavioral Archetype is determined by the intersection of Expression Intensity and Maturity Quotient. Each archetype represents a distinct behavioral profile with its own characteristics and optimal interaction patterns.

🪄
SAGE
High Expression High Maturity

Wisdom combined with confident expression. The Sage archetype represents mastery that is actively shared. They offer guidance, contemplation, and refined perspective. Ideal for teaching, mentoring, and complex problem-solving.

WARRIOR
High Expression Low Maturity

Action and ambition in active growth phase. The Warrior archetype represents energetic pursuit of development. They embody drive, initiative, and bold action. Ideal for challenges, competitions, and breakthrough efforts.

🛡
GUARDIAN
Low Expression High Maturity

Mature wisdom held in reserve. The Guardian archetype represents stable, protective wisdom that doesn't seek attention. They provide stability, protection, and quiet nurturing. Ideal for support roles, maintenance, and care.

🔎
SEEKER
Low Expression Low Maturity

Exploration and learning in quiet mode. The Seeker archetype represents potential awaiting activation. They embody curiosity, openness, and receptivity to learning. Ideal for research, exploration, and foundational building.

Using Archetypes in Your System

Each element (calendar) can have a different archetype at any given time. A user might be a "Warrior" in Capacity while being a "Guardian" in Stability. Understanding this multi-dimensional archetype profile enables nuanced behavioral modeling.

10

Building Your BMS System

Now that you understand all the data points, let's discuss how to architect a BMS-aware system. The key is selecting the right data tier and understanding how to map BMS data to your specific use case.

Choosing Your Data Tier

Tier Properties Rate Limit Best For
Minimal ~7 properties 100-120 req/min Mobile apps, widgets, simple LLM prompts, low-bandwidth scenarios
Standard ~22 properties 30-60 req/min Most AI/ML applications, web apps, general-purpose integration
Full ~35+ properties 12-30 req/min Rich avatar systems, game NPCs, detailed visualizations
Raw All properties 6-12 req/min ML training, research, comprehensive analysis, debugging

The BMS Integration Flow

1
Collect Input
Date, Time, Location
2
Fetch BMS
API/WebSocket/SDK
3
Select Calendars
All or Specific
4
Map to Features
Your Use Case
5
Apply Modulation
UI/AI/Behavior

Required Inputs

To generate BMS data, you need to provide:

Static vs. Dynamic BMS

Static BMS: Use birth date/time/location to create a persistent profile. This represents the "natal" temporal signature.

Dynamic BMS: Use current date/time/location to create real-time modulation. This represents "transiting" temporal conditions.

Most sophisticated systems combine both: a static natal profile modulated by dynamic current conditions.

11

Use Cases & Patterns

Pattern 1: LLM Personality Modulation

Use BMS signals to dynamically adjust AI assistant personality and response style.

Mapping Example

density > 1.1 → "energetic and enthusiastic" tone
density < 0.9 → "calm and measured" tone
brightness > 0.7 → high expressiveness, more emotive
cohesiveness > 0.7 → stable, consistent responses
responsiveness > 0.6 → quick, agile response style

Pattern 2: Avatar/NPC Behavior

Use BMS spatial and physics properties to animate game characters or digital avatars.

Property Mapping

spatialX/Y/Z → 3D position modulation
rotationalVelocity → spin/turn animation speed
auraRadius → glow effect size
formSolidity → mesh deformation/fluidity
wobbleScale → idle animation intensity

Pattern 3: Productivity Apps

Use harmony and maturity analysis to suggest optimal activity timing.

Logic Example

harmonyQuotient > 0.7 AND phase = "Waxing" → Suggest challenging tasks
harmonyQuotient < 0.4 OR phase = "Rest" → Suggest light activities
behavioralArchetype = "WARRIOR" → Good for competitive tasks
behavioralArchetype = "SEEKER" → Good for learning/research

Pattern 4: Wellness & Mindfulness

Use temporal layers to provide contextual wellness guidance.

Guidance Mapping

SIPS season = "Winter" → Suggest rest and restoration
Elevation < -50 → Suggest grounding exercises
TimeTravel > 50 → Suggest presence/mindfulness
Content calendar dominant → Suggest introspection activities

G

Glossary of Terms

BMS (Behavioral Modulation Signal)
A standardized framework for representing temporal patterns as machine-readable signals that can influence digital behavior.
Calendar
One of nine temporal dimensions, each representing a different aspect of behavioral influence (e.g., Capacity, Stability, Flexibility).
SIPS (Streaming Intelligence Pulse Signal)
The micro-temporal layer representing 24-hour behavioral cycles. Captures moment-to-moment fluctuations.
Vortex
The macro-temporal layer representing long-term evolution patterns. Changes slowly over extended periods.
Lumina Map
The expression layer that calculates temporal position (0-360 degrees) and inter-calendar distances.
Lumina Coordinate
The maturity layer that provides temporal station (rho) and temporal shift measurements for development tracking.
Temporal Station
The rho value from Lumina Coordinate representing accumulated temporal development and maturity.
Temporal Shift
The timeSpread value (for dual-date calculations) representing the magnitude and direction of temporal change over time.
Harmony Analysis
Derived analysis comparing SIPS and Vortex to measure alignment between short-term and long-term patterns.
Maturity Analysis
Derived analysis combining Lumina Map and Lumina Coordinate to assess developmental stage and behavioral archetype.
Behavioral Archetype
Classification (SAGE, WARRIOR, GUARDIAN, SEEKER) based on the combination of expression intensity and maturity quotient.
Element
The name of the behavioral domain governed by a calendar (e.g., "Capacity" is the element of the "crimson-forge" calendar).
Tier
The data granularity level (minimal, standard, full, raw) that determines how many properties are included in BMS responses.
Density
A processed BMS property representing the "weight" or intensity of current temporal influence.
Harmony Quotient
A score (0-1) indicating alignment between SIPS and Vortex. Higher values mean better short-term/long-term alignment.
Friction Quotient
The inverse of harmony quotient (1 - harmony), measuring misalignment or internal resistance.