{% extends "base.html" %} {% block title %}Guide — Fractal Memory{% endblock %} {% block content %}
Contents
Intelligence
Feedback Working Buffer
Universal Color Language
Green — Healthy, active, confirmed, FLOW state, safety signals
Blue — Confirmed memories, selected items, active elements, information
Orange — Probation (new/unverified), warnings, moderate concern
Red — Critical, danger signals, STRESS state, safety-critical memories, errors
Purple — Permanent memories, pinned items, active domain
Cyan — CURIOSITY state, EKF active, exploration mode
Yellow — Degraded, moderate sensitivity, circuit breaker fallback
Gold — Reinforced scars, repair lines
Core

Domain Organs

Open page →
What

The home page of the dashboard. It shows the entire organism as a body made of organs — each organ is a domain (a named group of memories, like a folder). Each domain card displays live memory count, association edges (links between memories), and a health bar showing how full it is.

Why

You need a single overview to understand the organism's shape — how many domains exist, which are active, and where your memories live. Without this page you'd have to check each domain individually. It's the starting point for all navigation.

How to use

Click any organ card to drill into that domain and see its individual memories. The sidebar vitals show real-time session activity. Look for the ACTIVE badge (purple) to identify which domain is currently receiving new memories.

What you should see
Example 1 — Fresh Start

You see one organ card labeled "default" with 3 memories and 0 edges. The heart rate shows ♥ 3 ops. Pressure is at 0.1%.

What this means: You've just started using Fractal Memory. Only 3 memories have been stored, none are linked to each other yet (0 edges means the system hasn't seen any memories co-retrieved together). This is completely normal for a new domain — it's in "PIONEER" stage (fewer than 10 memories).

Example 2 — Healthy Active System

You see 3 organ cards: "work-project" (142 memories, 89 edges), "personal" (45 memories, 23 edges), "default" (8 memories). Heart rate is pulsing at 24 ops. Pressure is 34%.

What this means: The organism has grown 3 distinct domains. "work-project" is the most mature with many memories and a dense association network (89 edges means memories are well-connected — the system has learned relationships between them). 34% pressure means plenty of room for new memories. The high heart rate indicates an active session.

Example 3 — Pressure Warning

One domain "research" shows 487 memories with pressure at 87%. The pressure indicator is red.

What this means: This domain is approaching its memory budget limit (the maximum number of memories it can hold before it starts automatically deleting weak ones). Above 80%, the system prunes aggressively — old, unimportant memories will be deleted via apoptosis to make room. You might want to check the Apoptosis page to see what's being removed, or increase the budget in Config.

Neural Network

Open page →
What

A force-directed graph (a visual layout where nodes attract and repel each other like magnets, forming natural clusters) showing all memories in a domain as circles (nodes) connected by lines (edges). The thickness of a line shows how strongly two memories are associated.

Why

Understanding the structure of your memories is crucial. Are they all isolated facts, or do they form clusters of related knowledge? This page reveals the hidden topology — which memories are central (connected to many others) vs. peripheral (isolated). Isolated memories with zero edges are candidates for deletion.

How to use

Select a domain from the dropdown. Drag nodes to reposition. Scroll/pinch to zoom. Click a node to open that memory's detail page. Use the edge threshold slider to hide weak connections and reveal only strong ones.

What you should see
Example 1 — Sparse New Domain

5 small orange nodes scattered with no edges between them.

What this means: All 5 memories are new (orange = probation) and have never been retrieved together, so no associations exist yet. This is normal for a brand-new domain. As you start querying and the system retrieves combinations of these memories, edges will form naturally.

Example 2 — Two Clear Clusters

Two tight groups of blue nodes connected internally with thick edges, with only 1-2 thin edges between the groups.

What this means: Your domain has two distinct sub-topics. The thick internal edges show strong associations within each cluster (memories within the same topic are frequently retrieved together). The thin edges between clusters are weak cross-topic links. This is healthy — the Niche Construction page might suggest splitting this into two separate domains.

Example 3 — One Central Hub

One large purple node in the center connected to 15+ smaller blue nodes radiating outward.

What this means: The large purple node is a permanent, frequently-retrieved memory that serves as a "hub" connecting many other concepts. This is typical for core facts (like "this project uses TypeScript" in a dev domain) that get pulled into many different queries. The hub pattern is healthy — it means the system has identified a central piece of knowledge.

Lifecycle

Open page →
What

A chrysalis ring (a circular visualization showing proportions, like a pie chart but as concentric rings) displaying how memories are distributed across four lifecycle stages: Probation, Confirmed, Permanent, and Safety Critical. Shows the maturation journey of every memory.

Why

Not all memories are equal. New memories are uncertain — they might be wrong, irrelevant, or temporary. The lifecycle system ensures that only memories that prove their worth (by being retrieved and found useful) get promoted to higher tiers with stronger protections. This page tells you whether the system is learning effectively.

How to use

Watch the promotion rate (% of memories that graduated from Probation to Confirmed or higher) — it should be above 30% in a healthy domain. A high pruning rate (% of memories still stuck in Probation) is normal early on, but if it stays high, you may not be querying stored information enough.

What you should see
Example 1 — New Domain (All Orange)

The ring is almost entirely orange with tiny blue sliver. Promotion rate: 8%.

What this means: Nearly all memories are still in Probation — this is a young domain where memories haven't been retrieved enough to confirm. The 8% promotion rate is low but expected. As you interact more with this domain, memories will naturally promote as they prove useful.

Example 2 — Mature Healthy Domain

Ring shows 20% orange, 55% blue, 20% purple, 5% red. Promotion rate: 72%.

What this means: Excellent health. Most memories (55%) are Confirmed — trusted and stable. 20% Permanent means the system has identified core knowledge. The 20% orange is a healthy churn of new information being evaluated. 72% promotion rate means the gate is selecting well — most stored memories turn out to be useful.

Example 3 — Stagnant Domain

Ring shows 85% orange, 12% blue, 3% purple. Promotion rate: 15%.

What this means: Too many memories stuck in Probation. This usually means: (a) memories are being stored but never queried, so they can't confirm, or (b) the gate is too loose, storing low-quality information. Check the Feedback page for retrieval patterns, and consider tightening the gate via the Processing Pipeline page.

Processing Pipeline

Open page →
What

The gate that controls what gets stored as a memory. Raw text from conversations enters a waiting room (a temporary holding area where candidate memories wait for a confirming signal before being stored). Only information that passes the gate threshold (receives enough independent signals of importance) becomes a permanent memory.

Why

Without a gate, every sentence would become a memory — flooding the system with noise. The pipeline ensures selectivity: only information that is novel, repeated, explicitly requested, or otherwise important makes it through. This is the organism's quality control.

How to use

Monitor the waiting room size. If it grows unbounded, the gate is too strict (information is stuck waiting for a second signal that never comes). If throughput is high but lifecycle shows lots of Probation failures, the gate is too loose. Pioneer mode (gate_signal_count=1, accepting any single signal) is good for new domains; Production mode (gate_signal_count=2+, requiring multiple confirming signals) is better for mature ones.

What you should see
Example 1 — Bootstrapping

Gate signal count is 1. Waiting room has 0 entries. 8 memories stored this session.

What this means: Pioneer mode is active — every piece of information that gets even one signal passes through immediately. The empty waiting room confirms nothing is stuck. 8 memories stored is aggressive but appropriate for a new domain that needs to build its initial knowledge base quickly.

Example 2 — Healthy Production

Gate signal count is 2. Waiting room has 3 entries (ages: 1 session, 2 sessions, 4 sessions). 2 memories stored this session.

What this means: Standard selectivity. 3 candidates are waiting for a second confirming signal. The 4-session-old entry will expire soon if it doesn't get reinforced — meaning it probably wasn't important enough. 2 stores per session is a healthy, selective rate.

Example 3 — Gate Too Strict

Gate signal count is 3. Waiting room has 28 entries. 0 memories stored in the last 5 sessions.

What this means: The gate requires 3 independent signals but most information only gets 1-2. Memories are piling up in the waiting room and expiring without ever being stored. Lower the gate_signal_count to 2 (or even 1 temporarily) in Config to allow learning.

Adaptation

Morphogens

Open page →
What

The organism's hormone system. Three continuously-measured signals — Information Richness (how dense the current conversation is with new facts), Retrieval Pressure (how often the user is querying memories), and Domain Density (how full and interconnected the domain is) — flow through 8 learnable sigmoid response curves (S-shaped mathematical functions that smoothly map an input signal to an output parameter, like a volume dial) that dynamically tune every system parameter.

Why

Fixed parameters can't work across all situations — a new domain needs different settings than a mature one, and a quiet session differs from a busy one. Morphogens solve this by continuously adapting parameters based on real conditions. This is how the system self-calibrates without manual tuning.

How to use

Check the convergence badges on each response curve. After ~30 sessions, all 8 should show "Converged" (the curve's shape has stabilized and stopped changing significantly). The trajectory chart shows signal history — flat lines mean stability. The system state badge shows the organism's current "mood".

What you should see
Example 1 — Early Learning

State shows CURIOSITY (cyan). All 8 convergence gauges show "Learning" in yellow. Trajectory chart shows volatile lines.

What this means: The system is in its initial exploration phase. CURIOSITY state means the domain is sparse and the organism is actively experimenting with different parameter settings. The curves haven't converged because they're still learning the optimal shape. This is expected for domains with fewer than 30 sessions.

Example 2 — Fully Converged

State shows FLOW (green). All 8 gauges show "Converged" in green. Trajectory lines are flat.

What this means: The organism has self-calibrated. All response curves have found stable shapes, meaning the system knows exactly how to translate activity signals into parameter adjustments. FLOW state means everything is balanced — no unusual stress or sparsity. This is the ideal state for a mature domain.

Example 3 — Stress Response

State shows STRESS (red). Retrieval pressure line has spiked. 2 curves show "Unstable". A convergence gauge just flipped from green to yellow.

What this means: Something changed — maybe the user is querying heavily with many misses, or making lots of corrections. STRESS state tightens the storage gate (to avoid storing more bad memories) and boosts retrieval aggressiveness (to try harder to find good matches). The curves de-converged because conditions shifted significantly. Check the Feedback page for what triggered the stress.

Organism Health

Open page →
What

A unified health report — the organism's self-model (an internal assessment of how well all subsystems are performing). Shows hit rate, domain maturity stage, parameter drift warnings, cascade predictions, and a full explanation of the last retrieval operation.

Why

Individual pages show subsystem details, but you need a single place that answers: "Is the memory system working well?" This page aggregates signals from all subsystems into one health dashboard. It's the doctor's checkup for your memory organism.

How to use

Start with Hit Rate (% of retrievals that returned actually useful memories) — below 40% means retrieval is struggling. Then check Domain Maturity to understand what features are available. Red Parameter Drift flags mean a morphogen curve is pushing a parameter far from its default.

What you should see
Example 1 — Pioneer Stage

Maturity: PIONEER. Hit rate: N/A. No drift warnings. "Not enough data yet" for cascade predictions.

What this means: Too early to measure health — the domain has fewer than 10 memories. Most subsystems (morphogens, bandits, niche construction) are not yet active. Focus on storing foundational memories first; health metrics become meaningful after ~20+ memories.

Example 2 — Healthy Mature System

Maturity: FOREST. Hit rate: 73% (green). 0 drift warnings. 0 cascade warnings. Last retrieval shows 3 memories retrieved with high scores.

What this means: The system is performing well. 73% of retrievals returned useful memories. No parameters are drifting abnormally and no subsystem failures are predicted. The last retrieval was clean — the right memories were found with high confidence scores.

Example 3 — Retrieval Struggling

Maturity: FOREST. Hit rate: 28% (red). 2 drift warnings: "gate_threshold" and "retrieval_top_l1". Cascade warning: "retrieval subsystem degraded, severity 0.7".

What this means: Only 28% of retrievals are useful — the system is returning wrong or irrelevant memories most of the time. The morphogen curves are over-compensating (pushing gate_threshold and retrieval parameters far from default). The cascade detector predicts potential retrieval failure. Check Feedback for correction patterns, and consider adding more precise memories to the domain.

System States

Open page →
What

The organism's mood. Three possible states — FLOW, STRESS, and CURIOSITY — each of which multiplies every system parameter differently. States are triggered by patterns of retrieval success, corrections, and domain sparsity.

Why

A one-size-fits-all approach fails. When things go wrong (many misses, corrections), the system needs to become more cautious. When exploring a new domain, it needs to be more adventurous. States provide coarse-grained behavioral adaptation on top of the fine-grained morphogen tuning.

How to use

Watch the counter bars showing consecutive misses vs. successes. Check the parameter multipliers table to see exactly how the active state is affecting each parameter. The transition history shows state changes over time — rapid oscillation suggests instability.

What you should see
Example 1 — Stable FLOW

State: FLOW. Miss counter: 0. Success counter: 7. All multipliers between 0.95 and 1.05. History shows solid green for the last 10 sessions.

What this means: Everything is working smoothly. 7 consecutive successful retrievals, no misses. All parameters are at their natural (unmultiplied) values. 10 sessions of continuous FLOW means the domain is stable and well-calibrated.

Example 2 — Triggered STRESS

State: STRESS. Miss counter: 4. Gate multiplier: 0.6. Retrieval aggression: 1.8. History shows: green, green, red, red.

What this means: 4 consecutive misses triggered STRESS. The gate multiplier of 0.6 means the gate threshold is reduced by 40% (harder to store new memories — the system is being cautious about adding more potentially bad information). Retrieval aggression at 1.8 means the system is trying 80% harder to find matching memories. This will resolve once retrievals start succeeding again.

Example 3 — CURIOSITY in New Domain

State: CURIOSITY. Domain maturity: PIONEER. Gate multiplier: 1.5. Exploration weight: 2.0. History shows all cyan.

What this means: The domain is new and sparse, so the system automatically entered CURIOSITY mode. Gate multiplier 1.5 means it's 50% easier to store memories (lowering the bar to build the initial knowledge base). Exploration weight 2.0 means the system is actively trying different retrieval strategies. This is healthy and expected — it will transition to FLOW as the domain matures.

Contextual Bandits

Open page →
What

Thompson Sampling (a decision-making algorithm that balances trying new options vs. exploiting known good ones) over 5 retrieval strategies, conditioned on 27 morphogen context bins (3 signal levels × 3 signals = 27 possible "situations" the system might be in). The system learns which retrieval strategy works best in each situation.

Why

No single retrieval strategy works best in all conditions. Sometimes conservative retrieval (returning only high-confidence matches) is best; other times aggressive retrieval (casting a wider net) works better. The bandit system automatically discovers the optimal strategy for each context, without manual tuning.

How to use

Watch the mean success rate per arm. After many sessions, arms should differentiate — one arm clearly winning in a context bin means the system has learned. The posterior distribution shows confidence: wider spread = less certain. Dreaming periodically resets (downscales) posteriors to prevent lock-in.

What you should see
Example 1 — Uniform Priors (No Data)

All 5 arms show ~50% success rate. Context bins are mostly empty. Alpha/Beta ratios are all near 1:1.

What this means: The system hasn't collected enough data to differentiate between strategies. All arms look equally promising (or equally uncertain). This is the starting state — after 10-20 sessions of active retrieval, the arms will begin to separate.

Example 2 — Clear Winner

"Precision" arm shows 78% win rate (green). "Aggressive" shows 42% (yellow). "Explorer" shows 35% (red). Current arm: Precision in context bin [medium, high, medium].

What this means: The system has learned that the "precision" strategy (returning fewer, higher-confidence results) works best when information richness is medium, retrieval pressure is high, and domain density is medium. It now preferentially selects this arm in similar contexts. The aggressive and explorer arms underperform in this situation.

Example 3 — Post-Dream Reset

All arms shifted closer to 50%. A "Downscaled" badge appears. Previously dominant "conservative" arm dropped from 82% to 65%.

What this means: Dreaming's slow-wave phase just downscaled the posteriors (reduced the influence of historical data to prevent over-commitment to one strategy). This is intentional — it prevents the system from being permanently locked into a strategy that was good in the past but might not be optimal now. The arms will re-differentiate as new data comes in.

Memory Care

Dreaming

Open page →
What

Offline consolidation — the system "sleeps" at the end of each session. Two phases: Slow Wave (like deep sleep — cleans up weak connections and dead weight) decays weak association edges and prunes them. REM (like dream sleep — creates new ideas from existing memories) recombines pairs of highly-resonant memories into new synthetic "insight" memories.

Why

Just like biological sleep consolidates learning, the system needs periodic offline processing. Without dreaming, weak associations would accumulate (noise), and valuable cross-connections between memories would never be discovered. Slow wave is garbage collection; REM is creative synthesis.

How to use

Check the REM efficiency donut: high stored/attempted ratio = productive dreaming. Monitor edges_pruned in slow wave — healthy cleanup each session. If syntheses_discarded is very high, lower rem_emergence_threshold in Config to allow more syntheses through.

What you should see
Example 1 — First Dream Cycle

Slow wave: 0 edges decayed (none exist yet). REM: 0 attempted (too few memories to pair). Dream history is empty.

What this means: The domain is too new for meaningful dreaming. No associations exist to decay, and not enough memory pairs meet the resonance threshold for REM synthesis. Dreaming becomes productive after ~15-20 memories with some association edges.

Example 2 — Productive Night

Slow wave: 12 edges decayed, 3 pruned. REM: 5 attempted, 3 stored, 2 discarded. Donut shows 60% green.

What this means: Good dream cycle. 12 weak edges were weakened further, and 3 were so weak they were removed entirely. REM found 5 promising memory pairs and successfully synthesized 3 new insight memories (2 didn't meet quality thresholds). 60% REM efficiency is healthy — the system is generating useful new knowledge from existing memories.

Example 3 — Inefficient REM

REM: 12 attempted, 1 stored, 11 discarded. Donut is mostly red (8% efficiency).

What this means: REM is finding many candidate pairs but almost all syntheses are being rejected. The rem_emergence_threshold (quality bar for a synthesized memory to be accepted) is probably too strict. Lower it in Config to allow more creative combinations through, or the domain's memories may be too dissimilar to combine meaningfully.

Consolidation

Open page →
What

End-of-session memory processing that runs alongside dreaming. Strengthens edges between co-retrieved memories (memories that were fetched together in the same query get a stronger link), merges near-duplicate memories, decays stale edges, expires old scars, and flags memories that may have drifted to the wrong domain.

Why

Without consolidation, the association graph would grow noisy with redundant memories and weak links. Merging near-duplicates prevents clutter. Strengthening co-retrieved edges encodes usage patterns. Domain drift detection catches memories that no longer belong where they were originally stored.

How to use

Runs automatically at session end. Check merge events to see what the system considered duplicates (if too many, raise merge threshold in Config). Domain drift suggestions are advisory — they show memories that would fit better in another domain but don't move them automatically.

What you should see
Example 1 — Routine Consolidation

Edges strengthened: 8. Merges: 0. Edges decayed: 3. Scars expired: 1. Freeloaders: 2.

What this means: Normal, healthy consolidation. 8 co-retrieval bonds were reinforced, 3 old weak edges were weakened further, 1 expired scar was cleaned up. 2 freeloaders detected — these memories are being surfaced via association links but never directly matched by queries.

Example 2 — Heavy Merging

Merges: 7. The merge events table shows pairs with 0.85-0.92 cosine similarity.

What this means: Too many near-duplicate memories were stored. 7 pairs were close enough to merge. This usually means the gate is accepting variations of the same information (e.g., "use async/await" and "always use async/await for I/O"). Consider raising gate selectivity or merge threshold.

Example 3 — Domain Drift Detected

Domain drift shows 3 memories in "work-project" that are closer to "personal" domain centroid.

What this means: 3 memories were stored in "work-project" but their content is actually more relevant to "personal". Maybe you discussed personal preferences during a work session. The suggestion is advisory — you can manually move them via the API, or let Niche Construction handle it automatically.

Apoptosis

Open page →
What

Controlled cell death — the system intentionally deletes memories that have drifted out of context, been contradicted too many times, or lost their vitality (a score combining retrieval frequency and recency — high vitality means the memory is actively used and recently accessed). Before deletion, important facts are extracted as fragments (small atomic facts salvaged from a dying memory).

Why

Accumulating stale, wrong, or irrelevant memories degrades retrieval quality. Apoptosis keeps the domain focused by removing noise. But unlike simple deletion, it's intelligent — it decomposes dying memories into fragments so valuable sub-facts survive. Think of it as composting: the whole plant dies, but nutrients return to the soil.

How to use

Monitor trigger distribution. High context_drift = domain topic is changing. High contradicted = conflicting information is being stored. High obsolescence = memories are sitting unused. Check fragments created — if >0, important sub-facts were saved before deletion.

What you should see
Example 1 — Healthy Pruning

3 memories pruned via obsolescence. Vitality scores: 0.02, 0.05, 0.01. Fragments: 1, 0, 2.

What this means: 3 memories with near-zero vitality (almost never retrieved, very old) were cleaned up. 3 fragments were salvaged — small atomic facts extracted before the full memories were deleted. This is completely healthy — the system is removing dead weight while preserving useful nuggets.

Example 2 — Topic Shift

8 memories pruned via context_drift in one session. All from "web design" sub-topic in a "fullstack" domain.

What this means: The domain's focus has shifted away from web design toward backend topics. Memories about CSS tricks, responsive layouts, etc. have drifted far from the current context centroid. If you still need these memories, consider creating a separate "web-design" domain.

Example 3 — Contradiction Cleanup

2 memories pruned via "contradicted". Scar count on both: 4+. Scars created: yes.

What this means: These memories were corrected 4+ times — they kept returning wrong information. The system finally removed them and created scar tissue (a pattern that suppresses similar future retrievals) so similar bad memories won't surface again. Check the Kintsugi page to see the new scars.

Niche Construction

Open page →
What

Self-organising domain management using Louvain community detection (an algorithm that automatically finds natural clusters in a network by maximizing how densely connected nodes are within groups vs. between groups). Analyzes the association graph and proposes domain splits, merges, or memory reassignments to improve modularity (a measure of how well-separated domains are from each other).

Why

Users don't always create the right domain boundaries upfront. As memories accumulate, natural clusters emerge that don't match the original domain structure. Niche construction detects these mismatches and suggests reorganization — like an automatic filing system that evolves with your content.

How to use

Look at cohesion vs. separation scatter. Domains in the top-right are well-organized (high internal cohesion + high external separation). Bottom-left domains need restructuring. Review cluster proposals — high-confidence proposals are worth acting on.

What you should see
Example 1 — Well-Organized

All domains in top-right quadrant. Cohesion: 0.82-0.91. Separation: 0.78-0.88. No proposals.

What this means: Domains are well-separated and internally coherent. Memories within each domain are strongly related to each other but distinct from other domains. No reorganization needed.

Example 2 — Split Proposal

"fullstack" domain at cohesion 0.42, separation 0.65. Proposal: split into "frontend" and "backend" with modularity delta +0.18, confidence 0.84.

What this means: The "fullstack" domain contains two distinct clusters that would work better as separate domains. The low cohesion (0.42) confirms that memories within the domain aren't strongly linked — there are two sub-groups talking past each other. Splitting would improve overall organization by 0.18 points.

Example 3 — Merge Proposal

"css-tricks" and "styling" domains both at low separation (0.31 and 0.28). Proposal: merge with modularity delta +0.12, confidence 0.76.

What this means: These two domains overlap heavily — memories in one are very similar to memories in the other (low separation). Merging them would consolidate related knowledge and strengthen association edges that currently span two domains.

Safety

Cascade Detector

Open page →
What

An early warning system using an Extended Kalman Filter (EKF) (a mathematical model that tracks multiple variables simultaneously and predicts their future values, like a weather forecast for system health) to monitor 5 subsystems (gate, retrieval, storage, associations, domains) and predict cascading failures before they happen.

Why

Subsystem failures don't happen in isolation — a degraded gate leads to bad memories, which leads to poor retrieval, which triggers STRESS, which over-tightens everything. By the time you notice, the cascade is already underway. The EKF catches early signals and warns you with enough lead time to intervene.

How to use

Watch the 5 gauge bars — all should stay green (≥0.7). Yellow (0.4-0.7) = degraded, investigate. Red (<0.4) = critical, act now. Warnings include recommended_action — a specific config parameter to tune.

What you should see
Example 1 — All Clear

All 5 gauges green (0.82-0.95). EKF Active badge. Covariance trace: 0.03. 0 warnings.

What this means: All subsystems are healthy and the EKF is confident in its estimates (low covariance). No cascading failures predicted. This is the ideal state.

Example 2 — Retrieval Degradation Warning

Retrieval gauge: yellow (0.52). Warning: "retrieval subsystem degraded, severity 0.6, recommended: increase retrieval_top_l1, impact in 3 sessions".

What this means: The EKF detects that retrieval quality is declining and predicts it will become critical in 3 sessions. The recommended action is to increase retrieval_top_l1 (the number of candidate memories pulled in the first retrieval pass), which widens the search net to find better matches. Act now to prevent a cascade into STRESS state.

Example 3 — Circuit Breaker Fallback

Badge shows "Circuit Breaker" (yellow). No EKF gauges visible. Simple counter: "3 consecutive low hit rate sessions".

What this means: The EKF couldn't be initialized (not enough session history, or dependencies missing). The system fell back to a simpler circuit breaker (just counts consecutive bad sessions and triggers an alert at a threshold). 3 consecutive low hit rate sessions have been detected — this is equivalent to a STRESS trigger. The system will auto-adapt, but EKF would provide more precise guidance.

Dimensional Folding

Open page →
What

Operational complexity management. As the system matures, it "folds" (deactivates while keeping a cached summary stat) inactive subsystems to reduce compute overhead. When a folded subsystem shows anomalous behavior (its metric deviates more than 2 standard deviations from its mean), it force-unfolds automatically.

Why

Running all subsystems continuously is expensive and unnecessary. A mature domain doesn't need to re-learn bandit posteriors every session. Folding intelligently reduces overhead while maintaining the ability to detect and respond to anomalies. It's like the organism putting non-essential systems on standby.

How to use

The regime badge tells you the current maturation stage. Watch for unexpected forced unfold events — these indicate something unusual happened that required a dormant subsystem to wake up. Folding is fully automatic; you don't need to manage it.

What you should see
Example 1 — Bootstrap

Regime: BOOTSTRAP. Only 3 subsystems active (green): gate, retrieval, storage. 8 subsystems folded (grey).

What this means: The domain is very new. Only the essential subsystems (store, retrieve, basic gate) are active. Advanced features like morphogens, bandits, niche construction, and dreaming are folded — they'd produce meaningless results with so little data. They'll activate automatically as the domain grows.

Example 2 — Mature with All Active

Regime: MATURE. All 11 subsystems active (green). 0 forced unfolds in last 10 sessions.

What this means: Full capability unlocked. The domain has enough data and converged morphogens to run every subsystem. No anomalies detected recently. This is the target state for a well-established domain.

Example 3 — Forced Unfold

Regime: MATURE. "Apoptosis" was folded but just force-unfolded. Anomaly: vitality scores dropped 2.3 standard deviations below mean.

What this means: The apoptosis subsystem was on standby (the domain was stable, no pruning needed). But a sudden drop in vitality scores across many memories triggered an anomaly — something changed, and the system woke up apoptosis to investigate and potentially prune affected memories. Check what caused the vitality drop (maybe a large topic shift).

Intelligence

Feedback & Danger Theory

Open page →
What

The organism's sensory nervous system. Every user message is scanned for danger signals (indicators that something went wrong: corrections, re-asks, rejections, contradictions) and safety signals (indicators that things went right: confirmations, engagement, acceptance). These signals drive morphogen updates, state transitions, and LLM judge evaluations.

Why

The system can't improve without feedback. Danger signals tell it when retrieval failed or information was wrong. Safety signals confirm what's working. Together they form a continuous learning loop: detect signal → update morphogens → adjust parameters → measure result → repeat.

How to use

Watch the signal stream for patterns. Frequent CORRECTION = wrong memories being retrieved. Frequent RE_ASK = queries not being answered. Check Judge Ratings — the LLM rates each retrieved memory 0 (unused), 1 (unclear), 2 (clearly used). Information Richness gauge shows how information-dense the current conversation is.

What you should see
Example 1 — Healthy Session

Signal stream: 8 green (CONFIRMATION, ENGAGEMENT), 1 yellow (RE_ASK). Distribution donut: 89% safety. Info richness: 0.72.

What this means: Great session. The system retrieved useful memories 8 times and the user confirmed or engaged positively. Only 1 re-ask means one query wasn't fully answered on the first try. High information richness means the conversation was dense with new facts — the gate should be receptive to storing new memories.

Example 2 — Struggling Session

Signal stream: 4 red (2 CORRECTION, 2 RE_ASK), 2 green. Distribution: 33% safety. Info richness: 0.45.

What this means: The system is struggling. 2 corrections mean wrong memories were surfaced. 2 re-asks mean the user had to repeat themselves. The system will likely transition to STRESS state (see States page). The morphogens will adjust parameters to be more cautious. Consider storing more accurate, specific memories in this domain.

Example 3 — Learning Explosion

Store triggers show 6 SURPRISE, 3 RESOLUTION, 2 PATTERN in one session. Info richness: 0.91.

What this means: Extremely information-dense session. The system detected 6 pieces of novel information (SURPRISE), resolved 3 pending questions, and noticed 2 recurring patterns. With 0.91 info richness, the morphogens will lower the gate threshold to capture more of this valuable content. Expect the lifecycle page to show many new Probation entries after this session.

Working Memory Buffer

Open page →
What

The organism's short-term memory — a prioritized buffer of memory IDs that are injected into every retrieval context. Contains four tiers: PINNED (manually marked "always include"), AUTO-PROMOTED (accessed frequently enough to auto-include), JUST WRITTEN (last 3 stored memories), and RECENT (last N accessed memories). Includes a habituation system (suppression of memories that appear too often, forcing diversity).

Why

Without a working buffer, the system would need to search the entire memory space from scratch every time. The buffer provides "priming" — recently relevant memories are immediately available, improving response time and contextual coherence. Habituation prevents a single dominant memory from monopolizing every response.

How to use

Monitor buffer composition — if RECENT dominates and PINNED is empty, consider pinning important memories. The access heatmap shows which memories are being retrieved most. High habituation count means the system is actively suppressing overused memories to force diversity.

What you should see
Example 1 — Minimal Buffer

Buffer: 0 pinned, 0 auto-promoted, 2 just written, 3 recent. Total: 5 entries.

What this means: Small working buffer — the session just started. No memories have been pinned or used enough to auto-promote. The 2 "just written" are from the current session's stores, and the 3 "recent" are from the last few retrievals. As the session progresses, the buffer will grow.

Example 2 — Well-Managed Buffer

Buffer: 3 pinned, 5 auto-promoted, 1 just written, 8 recent. Access heatmap shows one memory with 14 accesses.

What this means: 3 manually pinned memories are always in context (likely core domain facts). 5 memories have been accessed often enough to auto-promote. The memory with 14 accesses is clearly important — it's been used heavily. This is a healthy, well-structured buffer.

Example 3 — Habituation Active

One memory shows "habituated (4/4 consecutive turns)". It's crossed out in the buffer list. A different memory now appears in its place.

What this means: A memory was retrieved 4 turns in a row, hitting the habituation window. It's temporarily suppressed to force the system to surface other relevant memories. This prevents a single "sticky" memory from dominating every response. The suppression is temporary — it resets if the memory isn't queried for a few turns.

System

Maintenance Scheduler

Open page →
What

A tiered background maintenance system that keeps the organism healthy between sessions. Five tiers run at different frequencies: INTRA-SESSION (every ~15 min during long sessions), SESSION-END (always when a session closes), DAILY, WEEKLY, and MONTHLY.

Why

The organism needs periodic upkeep — dreaming, consolidation, apoptosis, niche construction, and more all run during maintenance windows. Without a scheduler, these processes would never trigger (or trigger unpredictably). The tiered approach ensures light tasks run often while heavy tasks run infrequently.

How to use

Check tier cards for OVERDUE status — maintenance that hasn't run when expected. The last report shows exactly what was done and how long it took. SESSION-END is the most important tier (runs dreaming + consolidation).

What you should see
Example 1 — Healthy Schedule

All 5 tiers show "ON TIME" (green). SESSION-END ran 2 hours ago. DAILY ran this morning. Last report: 8 actions, 120ms.

What this means: Everything is on schedule. Maintenance is running at expected intervals, completing quickly (120ms is fast), and performing routine cleanup. No intervention needed.

Example 2 — OVERDUE Daily

DAILY shows "OVERDUE" (red). Last ran 3 days ago. SESSION-END still shows "ON TIME".

What this means: Daily maintenance hasn't run in 3 days. This often happens if the MCP server was restarted frequently (resets the schedule) or if no sessions ran for a few days. SESSION-END still working means dreaming and consolidation are healthy. The daily tasks (deeper cleanup, weekly summaries) are delayed but not critical.

Example 3 — Heavy Maintenance

Last WEEKLY report: 47 actions, 3.2s. Actions: 18 edges pruned, 12 scars expired, 8 apoptosis events, 5 niche proposals, 4 merges.

What this means: Heavy weekly cleanup. 18 weak edges were removed, 12 old scars expired, 8 memories were pruned, and the niche system generated 5 domain reorganization proposals. 3.2s is longer than usual — this domain accumulated a lot of debt. Check Apoptosis and Niche pages for details on what was cleaned up.

Configuration

Open page →
What

All 68+ live configuration parameters with categories, current values, and morphogen sensitivity ratings (how much the morphogen system dynamically adjusts each parameter: H=high/actively tuned, M=moderate, L=low/static). Includes feature flags, threshold gauges, and a search filter.

Why

Transparency. Every decision the system makes is based on these parameters. When something goes wrong (or right), you can trace it back to a specific parameter value. The sensitivity rating tells you which parameters are being actively pushed by the morphogen system — these are the ones most likely to change between sessions.

How to use

Use the search bar to find any parameter instantly. Check feature flags to see which subsystems are enabled. Key threshold gauges show the 8 most critical decision boundaries at a glance. Parameters are read-only in the dashboard — change them via FractalConfig or environment variables.

What you should see
Example 1 — Default Configuration

All parameters at default values. All thresholds centered. 3 feature flags ON (spreading_activation, scar_penalty, llm_judge).

What this means: Fresh system with no morphogen adjustments yet. All parameters are at their baseline values. Core features (association spreading, scar penalties, LLM-based quality judging) are enabled. As sessions accumulate, morphogens will begin shifting H-sensitivity parameters away from defaults.

Example 2 — Morphogen-Tuned

gate_threshold (H) shows current value 0.35 vs default 0.50. retrieval_top_l1 (H) shows 15 vs default 10. Both marked with drift indicator.

What this means: Morphogens have actively tuned two high-sensitivity parameters. The gate threshold was lowered from 0.50 to 0.35 (making it easier to store memories — probably a CURIOSITY or early-stage response). retrieval_top_l1 was increased from 10 to 15 (casting a wider net during retrieval — probably responding to low hit rate). These adjustments are automatic and data-driven.

Example 3 — Troubleshooting

You search "merge" and find merge_similarity_threshold = 0.80. You notice the Consolidation page shows too many merges.

What this means: The merge threshold of 0.80 means any two memories with 80%+ cosine similarity get merged. If too many merges are happening, raise this to 0.85 or 0.90 to be more selective about what counts as a "duplicate". This is a manual configuration change you'd make by modifying FractalConfig.

{% endblock %}