Visual Topology

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.

Studio WebGL CanvasControl Panel CanvasSix Archetype RingsTopology Lenses
Spatial Encoding

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.

Inner Core

Active Working Memory

Heat >= 0.70. Newly stored, pinned, or frequently recalled nodes orbit the center and win PreInvocation context budgets.

Mid Orbit

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.

Outer Rim

Consolidation Zone

Heat < 0.20. Quiet episodic details drift outward toward their floor until queried or distilled into synthesis nodes.

Pinned Halo Constellations

Nodes with 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.
Node Classification

Archetype Color Coding

Node fill and glow colors map directly to the six canonical Sulcus memory archetypes defined in sulcus-theme.

ArchetypeCanvas ColorRetention Half LifeHeat FloorTopology Role
PreferenceGold (#D4AF37)90d / 1,000 ops0.10Durable operator rules, coding conventions, and architectural invariants.
SemanticCyan (#00F0FF)30d / 500 ops0.05Domain concepts, module relationships, and system design mental models.
FactEmerald (#22c55e)365d / 5,000 ops0.15Grounded verifiable facts, endpoints, ports, and environment topology.
ProceduralPurple (#a855f7)180d / 2,000 ops0.08Repeatable build recipes, deployment runbooks, and surgical rewind lessons.
EpisodicAmber (#f59e0b)24h / 50 ops0.01Recent session events, debugging turns, and short-horizon working context.
SynthesisPink (#ec4899)60d / 800 ops0.05Consolidated higher-order insights distilled from resonant memory clusters.
Associative Links

Resonance Edge Conduits

Line thickness and opacity reflect edge weight (0.0 to 1.0), while stroke hue encodes the semantic relationship between endpoints.

Edge ChannelGold

Semantic Link

Type semantic: Vector cosine similarity link created during capture or explicit graph relation.

Edge ChannelEmerald

Corroboration Edge

Type corroborates: Independent memories or separate agents confirming the same underlying claim.

Edge ChannelCrimson

Contradiction Edge

Type contradicts: Active semantic collision flagged by local high-cosine conflict detection for operator or agent resolution.

Edge ChannelBright Gold

Supersedes Edge

Type supersedes: Authoritative replacement pointer from a newer verified node to deprecated prior state.

Edge ChannelBright Cyan

Namespace Bridge

Type cross_namespace_coref: Inter-namespace entity bridge connecting authorized linked namespaces across teams or agents.

Edge ChannelSky Cyan

Shared Entity

Type co_reference / entity_shared: Nodes referencing the same canonical Knowledge Graph entity or AST symbol within a namespace.

Edge ChannelViolet

Synthesis Lineage

Type consolidated_from: Provenance lineage connecting a synthesis node back to the source memories it distilled.

Edge ChannelAmber

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.

Interactive Lenses

Lenses And Filters

Slice multi-thousand-node graphs down to exact operational signal without leaving the canvas.

Structural Overlays

Topology Lenses

Activate specialized graph overlays in Sulcus Studio to isolate structural relationships:

  • Cross NamespaceHighlights cross_namespace bridges across linked workspaces.
  • Corroborated ClustersIsolates multi-source verified corroborates constellations.
  • Active ConflictsSurfaces unresolved contradicts collisions needing operator review.
  • Entity CoreferenceGroups nodes sharing canonical Knowledge Graph entities or AST symbols.
Synchronized State

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_heat from 0.00 to 1.00 to peel away cold outer rings.
Snapshot Protocol

Graph Snapshot API

Both Sulcus Studio and the embedded Control Panel render their canvases from the same single-roundtrip snapshot endpoint.

GET/api/v1/agent/graph/snapshot?limit=250&min_heat=0.10&namespace=eng-core
bashSnapshot Query
curl -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"
jsonSnapshot Payload
{
  "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
    }
  ]
}
Engineering Dispatches

Architecture Release Notes

Receive technical deep dives on thermodynamic context engineering, System 1 VCR cartridge updates, SulcusBench evaluations, and signed v3.1 engine releases directly from Digital Forge Studios.