Memory Constellation
Explore your living knowledge graph in real time. Every memory renders as a salience-weighted node arranged across concentric thermodynamic rings, connected by typed semantic, corroboration, lineage, and conflict edges.
Thermodynamic Ring Layout
Both the WebGL canvas in Sulcus Studio (/dashboard/memories) and the built-in Control Panel Memory Web tab (/panel) project salience directly into radial distance and node radius.
Active Working Memory
Heat >= 0.70. Newly stored, pinned, or frequently recalled nodes orbit the center and win PreInvocation context budgets.
Warm Associative Ring
Heat 0.20 to 0.69. Established domain context that cools between tasks and pulses back into the core on semantic or resonance hits.
Consolidation Zone
Heat < 0.20. Quiet episodic details drift outward toward their floor until queried or distilled into synthesis nodes.
Pinned Halo Constellations
is_pinned = true render with a persistent gold halo ring and are exempt from thermodynamic decay. High-degree hub nodes anchor local constellations so related procedures, facts, and syntheses stay visually grouped during force relaxation.Archetype Color Coding
Node fill and glow colors map directly to the six canonical Sulcus memory archetypes defined in sulcus-theme.
| Archetype | Canvas Color | Retention Half Life | Heat Floor | Topology Role |
|---|---|---|---|---|
| Preference | Gold (#D4AF37) | 90d / 1,000 ops | 0.10 | Durable operator rules, coding conventions, and architectural invariants. |
| Semantic | Cyan (#00F0FF) | 30d / 500 ops | 0.05 | Domain concepts, module relationships, and system design mental models. |
| Fact | Emerald (#22c55e) | 365d / 5,000 ops | 0.15 | Grounded verifiable facts, endpoints, ports, and environment topology. |
| Procedural | Purple (#a855f7) | 180d / 2,000 ops | 0.08 | Repeatable build recipes, deployment runbooks, and surgical rewind lessons. |
| Episodic | Amber (#f59e0b) | 24h / 50 ops | 0.01 | Recent session events, debugging turns, and short-horizon working context. |
| Synthesis | Pink (#ec4899) | 60d / 800 ops | 0.05 | Consolidated higher-order insights distilled from resonant memory clusters. |
Resonance Edge Conduits
Line thickness and opacity reflect edge weight (0.0 to 1.0), while stroke hue encodes the semantic relationship between endpoints.
Semantic Link
Type semantic: Vector cosine similarity link created during capture or explicit graph relation.
Corroboration Edge
Type corroborates: Independent memories or separate agents confirming the same underlying claim.
Contradiction Edge
Type contradicts: Active semantic collision flagged by local high-cosine conflict detection for operator or agent resolution.
Supersedes Edge
Type supersedes: Authoritative replacement pointer from a newer verified node to deprecated prior state.
Namespace Bridge
Type cross_namespace_coref: Inter-namespace entity bridge connecting authorized linked namespaces across teams or agents.
Shared Entity
Type co_reference / entity_shared: Nodes referencing the same canonical Knowledge Graph entity or AST symbol within a namespace.
Synthesis Lineage
Type consolidated_from: Provenance lineage connecting a synthesis node back to the source memories it distilled.
Temporal Window
Type temporal_proximity: Memories captured within the same operational window or debugging sequence.
During recall, spreading activation (Edge Resonance) propagates thermal energy across these exact conduits proportional to weight * damping, warming connected procedures and facts before the agent faults.
Lenses And Filters
Slice multi-thousand-node graphs down to exact operational signal without leaving the canvas.
Topology Lenses
Activate specialized graph overlays in Sulcus Studio to isolate structural relationships:
- Cross NamespaceHighlights
cross_namespacebridges across linked workspaces. - Corroborated ClustersIsolates multi-source verified
corroboratesconstellations. - Active ConflictsSurfaces unresolved
contradictscollisions needing operator review. - Entity CoreferenceGroups nodes sharing canonical Knowledge Graph entities or AST symbols.
Filter Dimensions
Filter controls stay synchronized across Graph, Split, and Table views:
- Archetype PillsToggle any subset of the 6 archetypes or epistemic confidence tiers.
- Wildcard GlobsSelect namespace pills or enter comma-separated globs like
eng-*, incident-*. - Salience SliderSweep
min_heatfrom0.00to1.00to peel away cold outer rings.
Graph Snapshot API
Both Sulcus Studio and the embedded Control Panel render their canvases from the same single-roundtrip snapshot endpoint.
/api/v1/agent/graph/snapshot?limit=250&min_heat=0.10&namespace=eng-corecurl -sS "https://api.sulcus.ca/api/v1/agent/graph/snapshot?limit=250&min_heat=0.10&namespace=eng-core" \
-H "Authorization: Bearer $SULCUS_API_KEY"{
"nodes": [
{
"id": "0195f8c2-7b41-7e30-9f1a-84c0219e4b10",
"label": "Enterprise OIDC issues RS256 JWTs for every tenant realm",
"memory_type": "fact",
"current_heat": 0.94,
"is_pinned": true,
"namespace": "eng-core",
"confidence": "verified"
},
{
"id": "0195f8c4-1102-7a91-b310-62a9d0041c88",
"label": "Always run migrations via sqlx before traffic cutover",
"memory_type": "procedural",
"current_heat": 0.78,
"is_pinned": false,
"namespace": "eng-core",
"confidence": "observed"
}
],
"edges": [
{
"source_id": "0195f8c2-7b41-7e30-9f1a-84c0219e4b10",
"target_id": "0195f8c4-1102-7a91-b310-62a9d0041c88",
"edge_type": "corroborates",
"weight": 0.86
}
]
}