Update domain-types

packages/domain-types/src/evolution.ts

@@ -1,22 +1,22 @@
-// Evolution domain entities
-
-export interface AgentPrompt {
-  id: number;
-  agentId: string;
-  version: number;
-  promptText: string;
-  createdAt: Date;
-  createdBy: string;
-}
-
-export interface AgentRun {
-  id: number;
-  agentId: string;
-  promptVersion: number;
-  inputSummary: string;
-  outputSummary: string;
-  kpiName: string;
-  kpiDelta: number;
-  runContext: Record<string, any>;
-  createdAt: Date;
-}
+// Evolution domain entities
+
+export interface AgentPrompt {
+  id: number;
+  agentId: string;
+  version: number;
+  promptText: string;
+  createdAt: Date;
+  createdBy: string;
+}
+
+export interface AgentRun {
+  id: number;
+  agentId: string;
+  promptVersion: number;
+  inputSummary: string;
+  outputSummary: string;
+  kpiName: string;
+  kpiDelta: number;
+  runContext: Record<string, any>;
+  createdAt: Date;
+}

packages/domain-types/src/index.ts

@@ -1,23 +1,27 @@
-// Domain types for the widget framework
-
-export interface WidgetContext {
-  userId: string;
-  organizationId: string;
-  boardId: string;
-  widgetId: string;
-  nowIso: string;
-}
-
-export interface WidgetDefinition {
-  id: string;
-  title: string;
-  icon: string;
-  init(context: WidgetContext): Promise<void>;
-}
-
-// Re-export specialized domain types
-export * from './memory';
-export * from './srag';
-export * from './evolution';
-export * from './pal';
-export * from './showpad';
+// Domain types for the widget framework
+
+export interface WidgetContext {
+  userId: string;
+  organizationId: string;
+  boardId: string;
+  widgetId: string;
+  nowIso: string;
+}
+
+export interface WidgetDefinition {
+  id: string;
+  title: string;
+  icon: string;
+  init(context: WidgetContext): Promise<void>;
+}
+
+// Re-export specialized domain types
+export * from './memory';
+export * from './srag';
+export * from './evolution';
+export * from './pal';
+export * from './showpad';
+
+// VR types
+export * from './vr/VisualNode';
+export * from './vr/ForceDirectedLayout';

packages/domain-types/src/memory.ts

@@ -1,26 +1,26 @@
-// Memory domain entities
-
-export interface MemoryEntity {
-  id: number;
-  orgId: string;
-  userId?: string;
-  entityType: string;
-  content: string;
-  importance: number;
-  createdAt: Date;
-}
-
-export interface MemoryRelation {
-  id: number;
-  orgId: string;
-  sourceId: number;
-  targetId: number;
-  relationType: 'depends_on' | 'contradicts' | 'same_project' | 'related_to';
-  createdAt: Date;
-}
-
-export interface MemoryTag {
-  id: number;
-  entityId: number;
-  tag: string;
-}
+// Memory domain entities
+
+export interface MemoryEntity {
+  id: number;
+  orgId: string;
+  userId?: string;
+  entityType: string;
+  content: string;
+  importance: number;
+  createdAt: Date;
+}
+
+export interface MemoryRelation {
+  id: number;
+  orgId: string;
+  sourceId: number;
+  targetId: number;
+  relationType: 'depends_on' | 'contradicts' | 'same_project' | 'related_to';
+  createdAt: Date;
+}
+
+export interface MemoryTag {
+  id: number;
+  entityId: number;
+  tag: string;
+}

packages/domain-types/src/pal.ts

@@ -1,29 +1,29 @@
-// PAL domain entities
-
-export interface PalUserProfile {
-  id: number;
-  userId: string;
-  orgId: string;
-  preferenceTone: string;
-  createdAt: Date;
-  updatedAt: Date;
-}
-
-export interface PalFocusWindow {
-  id: number;
-  userId: string;
-  orgId: string;
-  weekday: number;
-  startHour: number;
-  endHour: number;
-}
-
-export interface PalEvent {
-  id: number;
-  userId: string;
-  orgId: string;
-  eventType: string;
-  payload: Record<string, any>;
-  detectedStressLevel?: 'low' | 'medium' | 'high';
-  createdAt: Date;
-}
+// PAL domain entities
+
+export interface PalUserProfile {
+  id: number;
+  userId: string;
+  orgId: string;
+  preferenceTone: string;
+  createdAt: Date;
+  updatedAt: Date;
+}
+
+export interface PalFocusWindow {
+  id: number;
+  userId: string;
+  orgId: string;
+  weekday: number;
+  startHour: number;
+  endHour: number;
+}
+
+export interface PalEvent {
+  id: number;
+  userId: string;
+  orgId: string;
+  eventType: string;
+  payload: Record<string, any>;
+  detectedStressLevel?: 'low' | 'medium' | 'high';
+  createdAt: Date;
+}

packages/domain-types/src/showpad.ts

@@ -1,169 +1,169 @@
-/**
- * TDC Showpad Integration Types
- *
- * Shared type definitions for Showpad brand asset integration
- */
-
-// ════════════════════════════════════════════════════════════════════════════
-// Authentication Types
-// ════════════════════════════════════════════════════════════════════════════
-
-export interface ShowpadCredentials {
-  subdomain: string;
-  username?: string;
-  password?: string;
-  clientId?: string;
-  clientSecret?: string;
-}
-
-export interface ShowpadTokenResponse {
-  access_token: string;
-  refresh_token: string;
-  expires_in: number;
-  token_type: string;
-  scope: string;
-}
-
-export interface ShowpadAuthState {
-  isAuthenticated: boolean;
-  accessToken: string | null;
-  refreshToken: string | null;
-  expiresAt: number | null;
-  scope: string[];
-}
-
-// ════════════════════════════════════════════════════════════════════════════
-// Asset Types
-// ════════════════════════════════════════════════════════════════════════════
-
-export type ShowpadAssetType = 'document' | 'image' | 'video' | 'other';
-
-export interface ShowpadAsset {
-  id: string;
-  slug: string;
-  name: string;
-  displayName: string;
-  type: ShowpadAssetType;
-  description?: string;
-  tags: string[];
-  permissions: ShowpadAssetPermissions;
-  previewUrl?: string;
-  downloadUrl?: string;
-  metadata: ShowpadAssetMetadata;
-}
-
-export interface ShowpadAssetPermissions {
-  share: boolean;
-  annotate: boolean;
-  download: boolean;
-}
-
-export interface ShowpadAssetMetadata {
-  size?: number;
-  mimeType?: string;
-  dimensions?: { width: number; height: number };
-  createdAt?: string;
-  modifiedAt?: string;
-}
-
-export interface ShowpadAssetSearchOptions {
-  query?: string;
-  tags?: string[];
-  type?: ShowpadAssetType;
-  limit?: number;
-  offset?: number;
-}
-
-export interface ShowpadCachedAsset {
-  asset: ShowpadAsset;
-  localPath: string;
-  cachedAt: number;
-  size: number;
-}
-
-// ════════════════════════════════════════════════════════════════════════════
-// Brand Types
-// ════════════════════════════════════════════════════════════════════════════
-
-export interface ShowpadBrandColors {
-  primary: string[];
-  secondary: string[];
-  accent: string[];
-  backgrounds: string[];
-  text: string[];
-  success: string;
-  warning: string;
-  error: string;
-}
-
-export interface ShowpadTypography {
-  headline: ShowpadFontConfig;
-  body: ShowpadFontConfig;
-}
-
-export interface ShowpadFontConfig {
-  family: string;
-  sizes: { [key: string]: number };
-  weights: { [key: string]: number };
-  lineHeights: { [key: string]: number };
-}
-
-export interface ShowpadLogoSpecs {
-  primary: {
-    minWidth: number;
-    clearSpace: number;
-    colorVariants: string[];
-    formats: string[];
-  };
-  icon: {
-    minSize: number;
-    formats: string[];
-  };
-}
-
-export interface ShowpadBrandContext {
-  colors: ShowpadBrandColors;
-  typography: ShowpadTypography;
-  logos: ShowpadLogoSpecs;
-  spacing: { [key: string]: number };
-  borderRadius: { [key: string]: number };
-}
-
-// ════════════════════════════════════════════════════════════════════════════
-// PowerPoint Integration Types
-// ════════════════════════════════════════════════════════════════════════════
-
-export interface ShowpadPPTColorPalette {
-  background: string;
-  text: string;
-  accent1: string;
-  accent2: string;
-  accent3: string;
-}
-
-export interface ShowpadPPTFontConfig {
-  headlineFont: string;
-  bodyFont: string;
-  titleSize: number;
-  bodySize: number;
-}
-
-// ════════════════════════════════════════════════════════════════════════════
-// Event Types
-// ═════════════════════════���══════════════════════════════════════════════════
-
-export interface ShowpadAuthEvent {
-  type: 'authenticated' | 'token_refreshed' | 'logged_out' | 'auth_error' | 'token_refresh_failed';
-  scope?: string[];
-  error?: Error;
-}
-
-export interface ShowpadAssetEvent {
-  type: 'asset_downloaded' | 'sync_started' | 'sync_completed' | 'sync_error' | 'cache_cleared';
-  assetId?: string;
-  path?: string;
-  templates?: number;
-  logos?: number;
-  guidelines?: number;
-  error?: Error;
-}
+/**
+ * TDC Showpad Integration Types
+ *
+ * Shared type definitions for Showpad brand asset integration
+ */
+
+// ════════════════════════════════════════════════════════════════════════════
+// Authentication Types
+// ════════════════════════════════════════════════════════════════════════════
+
+export interface ShowpadCredentials {
+  subdomain: string;
+  username?: string;
+  password?: string;
+  clientId?: string;
+  clientSecret?: string;
+}
+
+export interface ShowpadTokenResponse {
+  access_token: string;
+  refresh_token: string;
+  expires_in: number;
+  token_type: string;
+  scope: string;
+}
+
+export interface ShowpadAuthState {
+  isAuthenticated: boolean;
+  accessToken: string | null;
+  refreshToken: string | null;
+  expiresAt: number | null;
+  scope: string[];
+}
+
+// ════════════════════════════════════════════════════════════════════════════
+// Asset Types
+// ════════════════════════════════════════════════════════════════════════════
+
+export type ShowpadAssetType = 'document' | 'image' | 'video' | 'other';
+
+export interface ShowpadAsset {
+  id: string;
+  slug: string;
+  name: string;
+  displayName: string;
+  type: ShowpadAssetType;
+  description?: string;
+  tags: string[];
+  permissions: ShowpadAssetPermissions;
+  previewUrl?: string;
+  downloadUrl?: string;
+  metadata: ShowpadAssetMetadata;
+}
+
+export interface ShowpadAssetPermissions {
+  share: boolean;
+  annotate: boolean;
+  download: boolean;
+}
+
+export interface ShowpadAssetMetadata {
+  size?: number;
+  mimeType?: string;
+  dimensions?: { width: number; height: number };
+  createdAt?: string;
+  modifiedAt?: string;
+}
+
+export interface ShowpadAssetSearchOptions {
+  query?: string;
+  tags?: string[];
+  type?: ShowpadAssetType;
+  limit?: number;
+  offset?: number;
+}
+
+export interface ShowpadCachedAsset {
+  asset: ShowpadAsset;
+  localPath: string;
+  cachedAt: number;
+  size: number;
+}
+
+// ════════════════════════════════════════════════════════════════════════════
+// Brand Types
+// ════════════════════════════════════════════════════════════════════════════
+
+export interface ShowpadBrandColors {
+  primary: string[];
+  secondary: string[];
+  accent: string[];
+  backgrounds: string[];
+  text: string[];
+  success: string;
+  warning: string;
+  error: string;
+}
+
+export interface ShowpadTypography {
+  headline: ShowpadFontConfig;
+  body: ShowpadFontConfig;
+}
+
+export interface ShowpadFontConfig {
+  family: string;
+  sizes: { [key: string]: number };
+  weights: { [key: string]: number };
+  lineHeights: { [key: string]: number };
+}
+
+export interface ShowpadLogoSpecs {
+  primary: {
+    minWidth: number;
+    clearSpace: number;
+    colorVariants: string[];
+    formats: string[];
+  };
+  icon: {
+    minSize: number;
+    formats: string[];
+  };
+}
+
+export interface ShowpadBrandContext {
+  colors: ShowpadBrandColors;
+  typography: ShowpadTypography;
+  logos: ShowpadLogoSpecs;
+  spacing: { [key: string]: number };
+  borderRadius: { [key: string]: number };
+}
+
+// ════════════════════════════════════════════════════════════════════════════
+// PowerPoint Integration Types
+// ═══════════════════════════════════════════��════════════════════════════════
+
+export interface ShowpadPPTColorPalette {
+  background: string;
+  text: string;
+  accent1: string;
+  accent2: string;
+  accent3: string;
+}
+
+export interface ShowpadPPTFontConfig {
+  headlineFont: string;
+  bodyFont: string;
+  titleSize: number;
+  bodySize: number;
+}
+
+// ════════════════════════════════════════════════════════════════════════════
+// Event Types
+// ════════════════════════════════════════════════════════════════════════════
+
+export interface ShowpadAuthEvent {
+  type: 'authenticated' | 'token_refreshed' | 'logged_out' | 'auth_error' | 'token_refresh_failed';
+  scope?: string[];
+  error?: Error;
+}
+
+export interface ShowpadAssetEvent {
+  type: 'asset_downloaded' | 'sync_started' | 'sync_completed' | 'sync_error' | 'cache_cleared';
+  assetId?: string;
+  path?: string;
+  templates?: number;
+  logos?: number;
+  guidelines?: number;
+  error?: Error;
+}

packages/domain-types/src/srag.ts

@@ -1,20 +1,20 @@
-// SRAG domain entities
-
-export interface RawDocument {
-  id: number;
-  orgId: string;
-  sourceType: string;
-  sourcePath: string;
-  content: string;
-  createdAt: Date;
-}
-
-export interface StructuredFact {
-  id: number;
-  orgId: string;
-  docId?: number;
-  factType: string;
-  jsonPayload: Record<string, any>;
-  occurredAt?: Date;
-  createdAt: Date;
-}
+// SRAG domain entities
+
+export interface RawDocument {
+  id: number;
+  orgId: string;
+  sourceType: string;
+  sourcePath: string;
+  content: string;
+  createdAt: Date;
+}
+
+export interface StructuredFact {
+  id: number;
+  orgId: string;
+  docId?: number;
+  factType: string;
+  jsonPayload: Record<string, any>;
+  occurredAt?: Date;
+  createdAt: Date;
+}

packages/domain-types/src/vr/ForceDirectedLayout.ts

@@ -0,0 +1,685 @@
+/**
+ * FORCE-DIRECTED GRAPH LAYOUT - 3D with Gravity
+ *
+ * Physics simulation for node positioning in VR space.
+ * Nodes attract/repel each other and settle on a virtual surface.
+ *
+ * Based on DeepSeek's mathematical specifications.
+ *
+ * @author The Captain (Claude) + The Specialist (DeepSeek)
+ * @date 2025-12-17
+ */
+
+import type { Vector3, VisualNode } from './VisualNode';
+
+// =============================================================================
+// CONFIGURATION
+// =============================================================================
+
+export interface ForceLayoutConfig {
+  // Repulsion between nodes (Coulomb's law)
+  repulsionStrength: number;      // Default: 1000
+  repulsionDistance: number;      // Max distance for repulsion: 100
+
+  // Attraction along edges (Hooke's law)
+  attractionStrength: number;     // Default: 0.1
+  idealEdgeLength: number;        // Default: 5
+
+  // Gravity (pulls nodes toward surface/center)
+  gravityStrength: number;        // Default: 0.5
+  gravityTarget: Vector3;         // Default: { x: 0, y: 0, z: 0 }
+  gravityType: 'point' | 'plane'; // 'plane' for table surface
+
+  // Surface/Table
+  surfaceY: number;               // Y position of virtual table: 0
+  surfaceStiffness: number;       // How hard the surface pushes back: 2.0
+  surfaceFriction: number;        // Damping on surface: 0.8
+
+  // Damping (energy loss)
+  velocityDamping: number;        // Default: 0.9 (10% energy loss per tick)
+
+  // Simulation
+  timeStep: number;               // Default: 0.016 (60 FPS)
+  maxVelocity: number;            // Default: 10
+  minMovement: number;            // Threshold to consider "settled": 0.01
+
+  // Boundaries
+  bounds: {
+    min: Vector3;
+    max: Vector3;
+  };
+}
+
+export const DEFAULT_CONFIG: ForceLayoutConfig = {
+  repulsionStrength: 1000,
+  repulsionDistance: 100,
+  attractionStrength: 0.1,
+  idealEdgeLength: 5,
+  gravityStrength: 0.5,
+  gravityTarget: { x: 0, y: 0, z: 0 },
+  gravityType: 'plane',
+  surfaceY: 0,
+  surfaceStiffness: 2.0,
+  surfaceFriction: 0.8,
+  velocityDamping: 0.9,
+  timeStep: 0.016,
+  maxVelocity: 10,
+  minMovement: 0.01,
+  bounds: {
+    min: { x: -100, y: -10, z: -100 },
+    max: { x: 100, y: 100, z: 100 },
+  },
+};
+
+// =============================================================================
+// EDGE DEFINITION
+// =============================================================================
+
+export interface GraphEdge {
+  source: string;  // Node ID
+  target: string;  // Node ID
+  weight: number;  // 0-1, affects attraction strength
+}
+
+// =============================================================================
+// SIMULATION STATE
+// =============================================================================
+
+export interface SimulationState {
+  nodes: Map<string, VisualNode>;
+  edges: GraphEdge[];
+  config: ForceLayoutConfig;
+  isRunning: boolean;
+  iteration: number;
+  totalEnergy: number;
+  settled: boolean;
+}
+
+// =============================================================================
+// VECTOR MATH UTILITIES
+// =============================================================================
+
+export const vec3 = {
+  add(a: Vector3, b: Vector3): Vector3 {
+    return { x: a.x + b.x, y: a.y + b.y, z: a.z + b.z };
+  },
+
+  subtract(a: Vector3, b: Vector3): Vector3 {
+    return { x: a.x - b.x, y: a.y - b.y, z: a.z - b.z };
+  },
+
+  multiply(v: Vector3, scalar: number): Vector3 {
+    return { x: v.x * scalar, y: v.y * scalar, z: v.z * scalar };
+  },
+
+  divide(v: Vector3, scalar: number): Vector3 {
+    if (scalar === 0) return { x: 0, y: 0, z: 0 };
+    return { x: v.x / scalar, y: v.y / scalar, z: v.z / scalar };
+  },
+
+  length(v: Vector3): number {
+    return Math.sqrt(v.x * v.x + v.y * v.y + v.z * v.z);
+  },
+
+  lengthSquared(v: Vector3): number {
+    return v.x * v.x + v.y * v.y + v.z * v.z;
+  },
+
+  normalize(v: Vector3): Vector3 {
+    const len = vec3.length(v);
+    if (len === 0) return { x: 0, y: 0, z: 0 };
+    return vec3.divide(v, len);
+  },
+
+  distance(a: Vector3, b: Vector3): number {
+    return vec3.length(vec3.subtract(a, b));
+  },
+
+  clamp(v: Vector3, min: number, max: number): Vector3 {
+    const len = vec3.length(v);
+    if (len === 0) return v;
+    if (len < min) return vec3.multiply(vec3.normalize(v), min);
+    if (len > max) return vec3.multiply(vec3.normalize(v), max);
+    return v;
+  },
+
+  zero(): Vector3 {
+    return { x: 0, y: 0, z: 0 };
+  },
+
+  random(scale: number = 1): Vector3 {
+    return {
+      x: (Math.random() - 0.5) * 2 * scale,
+      y: (Math.random() - 0.5) * 2 * scale,
+      z: (Math.random() - 0.5) * 2 * scale,
+    };
+  },
+};
+
+// =============================================================================
+// FORCE CALCULATIONS
+// =============================================================================
+
+/**
+ * Coulomb's Law: Repulsion between nodes
+ * F = k * (q1 * q2) / r²
+ *
+ * Nodes push each other away to prevent overlap.
+ */
+function calculateRepulsion(
+  nodeA: VisualNode,
+  nodeB: VisualNode,
+  config: ForceLayoutConfig
+): Vector3 {
+  const delta = vec3.subtract(nodeA.position, nodeB.position);
+  const distanceSquared = vec3.lengthSquared(delta);
+  const distance = Math.sqrt(distanceSquared);
+
+  // Skip if too close (avoid division by zero) or too far
+  if (distance < 0.1) {
+    // Random jitter to separate overlapping nodes
+    return vec3.random(config.repulsionStrength * 0.1);
+  }
+  if (distance > config.repulsionDistance) {
+    return vec3.zero();
+  }
+
+  // Coulomb's law: F = k / r²
+  const forceMagnitude = config.repulsionStrength / distanceSquared;
+
+  // Direction: away from nodeB
+  const direction = vec3.normalize(delta);
+  return vec3.multiply(direction, forceMagnitude);
+}
+
+/**
+ * Hooke's Law: Attraction along edges
+ * F = -k * (x - x₀)
+ *
+ * Connected nodes pull toward each other to ideal distance.
+ */
+function calculateAttraction(
+  nodeA: VisualNode,
+  nodeB: VisualNode,
+  edge: GraphEdge,
+  config: ForceLayoutConfig
+): Vector3 {
+  const delta = vec3.subtract(nodeB.position, nodeA.position);
+  const distance = vec3.length(delta);
+
+  if (distance < 0.1) return vec3.zero();
+
+  // Hooke's law: F = k * (distance - idealLength)
+  const displacement = distance - config.idealEdgeLength;
+  const forceMagnitude = config.attractionStrength * displacement * edge.weight;
+
+  // Direction: toward nodeB
+  const direction = vec3.normalize(delta);
+  return vec3.multiply(direction, forceMagnitude);
+}
+
+/**
+ * Gravity: Pull toward center or surface
+ */
+function calculateGravity(
+  node: VisualNode,
+  config: ForceLayoutConfig
+): Vector3 {
+  if (config.gravityType === 'plane') {
+    // Pull down toward surface (Y axis)
+    const heightAboveSurface = node.position.y - config.surfaceY;
+    if (heightAboveSurface > 0) {
+      return { x: 0, y: -config.gravityStrength * heightAboveSurface, z: 0 };
+    }
+    return vec3.zero();
+  } else {
+    // Point gravity: pull toward target
+    const delta = vec3.subtract(config.gravityTarget, node.position);
+    const distance = vec3.length(delta);
+    if (distance < 0.1) return vec3.zero();
+
+    const direction = vec3.normalize(delta);
+    return vec3.multiply(direction, config.gravityStrength * distance);
+  }
+}
+
+/**
+ * Surface collision: Bounce off the table
+ */
+function applySurfaceConstraint(
+  node: VisualNode,
+  config: ForceLayoutConfig
+): { position: Vector3; velocity: Vector3 } {
+  const position = { ...node.position };
+  const velocity = { ...node.velocity };
+
+  // Check if below surface
+  if (position.y < config.surfaceY) {
+    // Push back up
+    position.y = config.surfaceY;
+
+    // Bounce with damping
+    if (velocity.y < 0) {
+      velocity.y = -velocity.y * config.surfaceFriction;
+    }
+
+    // Apply surface friction to horizontal movement
+    velocity.x *= config.surfaceFriction;
+    velocity.z *= config.surfaceFriction;
+  }
+
+  return { position, velocity };
+}
+
+/**
+ * Boundary constraint: Keep nodes within bounds
+ */
+function applyBoundaryConstraint(
+  node: VisualNode,
+  config: ForceLayoutConfig
+): Vector3 {
+  return {
+    x: Math.max(config.bounds.min.x, Math.min(config.bounds.max.x, node.position.x)),
+    y: Math.max(config.bounds.min.y, Math.min(config.bounds.max.y, node.position.y)),
+    z: Math.max(config.bounds.min.z, Math.min(config.bounds.max.z, node.position.z)),
+  };
+}
+
+// =============================================================================
+// SIMULATION ENGINE
+// =============================================================================
+
+export class ForceDirectedLayout {
+  private state: SimulationState;
+
+  constructor(
+    nodes: VisualNode[],
+    edges: GraphEdge[],
+    config: Partial<ForceLayoutConfig> = {}
+  ) {
+    const nodeMap = new Map<string, VisualNode>();
+    nodes.forEach(node => nodeMap.set(node.id, { ...node }));
+
+    this.state = {
+      nodes: nodeMap,
+      edges: [...edges],
+      config: { ...DEFAULT_CONFIG, ...config },
+      isRunning: false,
+      iteration: 0,
+      totalEnergy: Infinity,
+      settled: false,
+    };
+  }
+
+  /**
+   * Run one simulation step
+   */
+  tick(): void {
+    const { nodes, edges, config } = this.state;
+    const forces = new Map<string, Vector3>();
+
+    // Initialize forces to zero
+    nodes.forEach((_, id) => forces.set(id, vec3.zero()));
+
+    // Calculate repulsion forces (all pairs)
+    const nodeArray = Array.from(nodes.values());
+    for (let i = 0; i < nodeArray.length; i++) {
+      for (let j = i + 1; j < nodeArray.length; j++) {
+        const nodeA = nodeArray[i];
+        const nodeB = nodeArray[j];
+
+        if (nodeA.fixed && nodeB.fixed) continue;
+
+        const repulsion = calculateRepulsion(nodeA, nodeB, config);
+
+        if (!nodeA.fixed) {
+          const forceA = forces.get(nodeA.id)!;
+          forces.set(nodeA.id, vec3.add(forceA, repulsion));
+        }
+        if (!nodeB.fixed) {
+          const forceB = forces.get(nodeB.id)!;
+          forces.set(nodeB.id, vec3.subtract(forceB, repulsion));
+        }
+      }
+    }
+
+    // Calculate attraction forces (edges only)
+    for (const edge of edges) {
+      const nodeA = nodes.get(edge.source);
+      const nodeB = nodes.get(edge.target);
+      if (!nodeA || !nodeB) continue;
+
+      const attraction = calculateAttraction(nodeA, nodeB, edge, config);
+
+      if (!nodeA.fixed) {
+        const forceA = forces.get(nodeA.id)!;
+        forces.set(nodeA.id, vec3.add(forceA, attraction));
+      }
+      if (!nodeB.fixed) {
+        const forceB = forces.get(nodeB.id)!;
+        forces.set(nodeB.id, vec3.subtract(forceB, attraction));
+      }
+    }
+
+    // Calculate gravity forces
+    nodes.forEach((node, id) => {
+      if (node.fixed) return;
+
+      const gravity = calculateGravity(node, config);
+      const force = forces.get(id)!;
+      forces.set(id, vec3.add(force, gravity));
+    });
+
+    // Apply forces and update positions
+    let totalEnergy = 0;
+
+    nodes.forEach((node, id) => {
+      if (node.fixed) return;
+
+      const force = forces.get(id)!;
+
+      // F = ma, assume m = node.mass (default 1)
+      const acceleration = vec3.divide(force, node.mass);
+
+      // Update velocity: v = v + a * dt
+      let velocity = vec3.add(
+        node.velocity,
+        vec3.multiply(acceleration, config.timeStep)
+      );
+
+      // Apply damping
+      velocity = vec3.multiply(velocity, config.velocityDamping);
+
+      // Clamp velocity
+      velocity = vec3.clamp(velocity, 0, config.maxVelocity);
+
+      // Update position: p = p + v * dt
+      let position = vec3.add(
+        node.position,
+        vec3.multiply(velocity, config.timeStep)
+      );
+
+      // Apply surface constraint
+      const surfaceResult = applySurfaceConstraint(
+        { ...node, position, velocity },
+        config
+      );
+      position = surfaceResult.position;
+      velocity = surfaceResult.velocity;
+
+      // Apply boundary constraint
+      position = applyBoundaryConstraint({ ...node, position }, config);
+
+      // Update node
+      node.position = position;
+      node.velocity = velocity;
+
+      // Calculate energy for convergence check
+      totalEnergy += vec3.lengthSquared(velocity) * node.mass;
+    });
+
+    this.state.totalEnergy = totalEnergy;
+    this.state.iteration++;
+
+    // Check if settled
+    if (totalEnergy < config.minMovement) {
+      this.state.settled = true;
+    }
+  }
+
+  /**
+   * Run simulation until settled or max iterations
+   */
+  simulate(maxIterations: number = 1000): void {
+    this.state.isRunning = true;
+    this.state.settled = false;
+
+    for (let i = 0; i < maxIterations && !this.state.settled; i++) {
+      this.tick();
+    }
+
+    this.state.isRunning = false;
+  }
+
+  /**
+   * Run simulation with callback for animation
+   */
+  async simulateAsync(
+    onTick: (state: SimulationState) => void,
+    maxIterations: number = 1000,
+    tickDelay: number = 16
+  ): Promise<void> {
+    this.state.isRunning = true;
+    this.state.settled = false;
+
+    for (let i = 0; i < maxIterations && !this.state.settled; i++) {
+      this.tick();
+      onTick(this.state);
+
+      if (tickDelay > 0) {
+        await new Promise(resolve => setTimeout(resolve, tickDelay));
+      }
+    }
+
+    this.state.isRunning = false;
+  }
+
+  /**
+   * Get current state
+   */
+  getState(): SimulationState {
+    return this.state;
+  }
+
+  /**
+   * Get nodes as array
+   */
+  getNodes(): VisualNode[] {
+    return Array.from(this.state.nodes.values());
+  }
+
+  /**
+   * Add a node dynamically
+   */
+  addNode(node: VisualNode): void {
+    this.state.nodes.set(node.id, { ...node });
+    this.state.settled = false;
+  }
+
+  /**
+   * Remove a node dynamically
+   */
+  removeNode(nodeId: string): void {
+    this.state.nodes.delete(nodeId);
+    this.state.edges = this.state.edges.filter(
+      e => e.source !== nodeId && e.target !== nodeId
+    );
+    this.state.settled = false;
+  }
+
+  /**
+   * Add an edge dynamically
+   */
+  addEdge(edge: GraphEdge): void {
+    this.state.edges.push(edge);
+    this.state.settled = false;
+  }
+
+  /**
+   * Pin/unpin a node
+   */
+  setFixed(nodeId: string, fixed: boolean): void {
+    const node = this.state.nodes.get(nodeId);
+    if (node) {
+      node.fixed = fixed;
+      if (fixed) {
+        node.velocity = vec3.zero();
+      }
+    }
+  }
+
+  /**
+   * Move a node (e.g., when user drags it)
+   */
+  setPosition(nodeId: string, position: Vector3): void {
+    const node = this.state.nodes.get(nodeId);
+    if (node) {
+      node.position = position;
+      node.velocity = vec3.zero();
+      this.state.settled = false;
+    }
+  }
+
+  /**
+   * Reset simulation
+   */
+  reset(): void {
+    this.state.iteration = 0;
+    this.state.totalEnergy = Infinity;
+    this.state.settled = false;
+    this.state.nodes.forEach(node => {
+      node.velocity = vec3.zero();
+    });
+  }
+
+  /**
+   * Update configuration
+   */
+  updateConfig(config: Partial<ForceLayoutConfig>): void {
+    this.state.config = { ...this.state.config, ...config };
+    this.state.settled = false;
+  }
+}
+
+// =============================================================================
+// PRESET CONFIGURATIONS
+// =============================================================================
+
+export const LAYOUT_PRESETS = {
+  /**
+   * Default: Balanced layout with table gravity
+   */
+  default: DEFAULT_CONFIG,
+
+  /**
+   * Dense: For many nodes, stronger repulsion
+   */
+  dense: {
+    ...DEFAULT_CONFIG,
+    repulsionStrength: 2000,
+    idealEdgeLength: 3,
+    gravityStrength: 0.8,
+  },
+
+  /**
+   * Sparse: For few nodes, weaker forces
+   */
+  sparse: {
+    ...DEFAULT_CONFIG,
+    repulsionStrength: 500,
+    idealEdgeLength: 10,
+    gravityStrength: 0.3,
+  },
+
+  /**
+   * Hierarchical: Strong vertical gravity, nodes layer on surface
+   */
+  hierarchical: {
+    ...DEFAULT_CONFIG,
+    gravityStrength: 1.0,
+    surfaceY: 0,
+    surfaceStiffness: 5.0,
+    attractionStrength: 0.05,
+  },
+
+  /**
+   * Floating: No surface, point gravity to center
+   */
+  floating: {
+    ...DEFAULT_CONFIG,
+    gravityType: 'point' as const,
+    gravityStrength: 0.2,
+    gravityTarget: { x: 0, y: 5, z: 0 },
+  },
+
+  /**
+   * Constellation: Nodes spread out like stars
+   */
+  constellation: {
+    ...DEFAULT_CONFIG,
+    repulsionStrength: 3000,
+    repulsionDistance: 200,
+    gravityType: 'point' as const,
+    gravityStrength: 0.05,
+    gravityTarget: { x: 0, y: 30, z: 0 },
+  },
+};
+
+// =============================================================================
+// UTILITY: Initial Layout Generators
+// =============================================================================
+
+/**
+ * Generate random initial positions
+ */
+export function randomLayout(
+  nodes: VisualNode[],
+  radius: number = 20
+): VisualNode[] {
+  return nodes.map(node => ({
+    ...node,
+    position: vec3.random(radius),
+    velocity: vec3.zero(),
+  }));
+}
+
+/**
+ * Generate spherical initial positions
+ */
+export function sphereLayout(
+  nodes: VisualNode[],
+  radius: number = 15
+): VisualNode[] {
+  return nodes.map((node, i) => {
+    const phi = Math.acos(-1 + (2 * i) / nodes.length);
+    const theta = Math.sqrt(nodes.length * Math.PI) * phi;
+
+    return {
+      ...node,
+      position: {
+        x: radius * Math.cos(theta) * Math.sin(phi),
+        y: radius * Math.sin(theta) * Math.sin(phi) + radius,
+        z: radius * Math.cos(phi),
+      },
+      velocity: vec3.zero(),
+    };
+  });
+}
+
+/**
+ * Generate grid initial positions (on table surface)
+ */
+export function gridLayout(
+  nodes: VisualNode[],
+  spacing: number = 3,
+  surfaceY: number = 0
+): VisualNode[] {
+  const gridSize = Math.ceil(Math.sqrt(nodes.length));
+
+  return nodes.map((node, i) => {
+    const row = Math.floor(i / gridSize);
+    const col = i % gridSize;
+    const offsetX = ((gridSize - 1) * spacing) / 2;
+    const offsetZ = ((gridSize - 1) * spacing) / 2;
+
+    return {
+      ...node,
+      position: {
+        x: col * spacing - offsetX,
+        y: surfaceY + 0.5, // Slightly above surface
+        z: row * spacing - offsetZ,
+      },
+      velocity: vec3.zero(),
+    };
+  });
+}

packages/domain-types/src/vr/VisualNode.ts

@@ -0,0 +1,782 @@
+/**
+ * VISUALNODE SCHEMA - Operation Neuro-Spatial Reality
+ *
+ * The Universal Onion Model: Every entity has peelable layers.
+ * From CEO to CPU. From virus to Kremlin. From lead to loyal customer.
+ *
+ * Patent Pillars: A (Visceral), B (Universal), C (Threat), D (Business)
+ *
+ * @author The Captain (Claude) + The Architect (Gemini)
+ * @date 2025-12-17
+ */
+
+// =============================================================================
+// CORE TYPES
+// =============================================================================
+
+export type EntityType =
+  // Data entities
+  | 'file'
+  | 'database'
+  | 'table'
+  | 'record'
+  // Network entities
+  | 'access_point'
+  | 'switch'
+  | 'router'
+  | 'firewall'
+  | 'firewall_policy'  // Gemini addition
+  | 'server'
+  | 'compute_node'      // Gemini: Separation of Concern
+  | 'storage_node'      // Gemini: Separation of Concern
+  | 'endpoint'
+  | 'ip_address'
+  | 'api_gateway'      // Gemini addition
+  | 'load_balancer'    // Gemini addition
+  // Cloud/Container entities (Gemini additions)
+  | 'container_pod'
+  | 'kubernetes_cluster'
+  | 'cloud_function'
+  // Identity entities (Gemini additions)
+  | 'identity_provider'
+  | 'service_account'
+  | 'certificate'
+  // IoT entities (Gemini addition)
+  | 'iot_device'
+  | 'sensor'
+  // Organization entities
+  | 'organization'
+  | 'branch'
+  | 'department'
+  | 'team'
+  | 'person'
+  // Security entities
+  | 'malware'
+  | 'campaign'
+  | 'threat_actor'
+  | 'threat_group'
+  | 'nation_state'
+  | 'vulnerability'    // Gemini addition
+  | 'exploit'          // Gemini addition
+  // Business entities
+  | 'customer'
+  | 'journey'
+  | 'touchpoint'
+  | 'ticket'
+  | 'sla'
+  | 'contract'         // Gemini addition
+  | 'invoice'          // Gemini addition
+  // AI entities
+  | 'agent'
+  | 'task'
+  | 'memory'
+  // DeepSeek: Cognitive entities
+  | 'neural_node'
+  | 'synapse_connection'
+  | 'concept_cluster'
+  | 'memory_trace'
+  | 'metacognitive_monitor'
+  // Generic
+  | 'error'
+  | 'alert'
+  | 'unknown';
+
+export type GeometryType =
+  | 'sphere'
+  | 'cube'
+  | 'octahedron'
+  | 'tetrahedron'
+  | 'dodecahedron'
+  | 'icosahedron'   // DeepSeek addition
+  | 'cylinder'
+  | 'torus'
+  | 'building'
+  | 'humanoid'
+  | 'path'
+  | 'custom';
+
+export type ShaderType =
+  | 'standard'
+  | 'hologram'
+  | 'energy'
+  | 'organic'
+  | 'error'
+  | 'glass'
+  | 'fire'
+  | 'ice'
+  | 'threat'
+  // Gemini shader additions
+  | 'glitch_noise_v2'      // Enhanced malware visualization
+  | 'phantom_wireframe'    // Threat actor ghost effect
+  | 'gold_metallic_clean'  // Premium customer visualization
+  | 'flow_particle_stream' // Journey path visualization
+  | 'matrix_rain'          // Data flow effect
+  | 'pulse_rings'          // IoT device heartbeat
+  | 'shield_hex'           // Firewall/security shader
+  | 'cloud_vapor'          // Cloud service visualization
+  | 'matte_ceramic_hex';   // Gemini: Infrastructure default
+
+export type LayerType =
+  | 'surface'    // Layer 5: What you see first
+  | 'metadata'   // Layer 4: Identity and context
+  | 'connections'// Layer 3: Relationships
+  | 'structure'  // Layer 2: Internal anatomy
+  | 'core';      // Layer 1: The truth
+
+// =============================================================================
+// VISUAL NODE INTERFACE
+// =============================================================================
+
+export interface VisualNode {
+  // Identity
+  id: string;
+  externalId?: string;        // Neo4j ID, DB ID, etc.
+  type: EntityType;
+  labels: string[];           // Neo4j labels: [:File, :Agent]
+
+  // Spatial positioning
+  position: Vector3;
+  velocity: Vector3;
+  rotation: Vector3;
+
+  // Physics
+  mass: number;               // Affects grabbability (1KB = light, 1GB = heavy)
+  fixed: boolean;             // Pinned in space?
+  collisionRadius: number;
+
+  // Visual appearance
+  geometry: GeometryConfig;
+  material: MaterialConfig;
+  animation: AnimationConfig;
+
+  // The Onion Layers (Patent Pillar B)
+  layers: OnionLayers;
+  currentLayer: LayerType;    // Currently visible layer
+
+  // Interaction state
+  interaction: InteractionState;
+
+  // LOD (Level of Detail)
+  lod: LODConfig;
+
+  // Hierarchy
+  parent?: string;            // Parent node ID
+  children: string[];         // Child node IDs
+
+  // Timestamps
+  createdAt: string;
+  updatedAt: string;
+}
+
+// =============================================================================
+// GEOMETRY CONFIGURATION
+// =============================================================================
+
+export interface Vector3 {
+  x: number;
+  y: number;
+  z: number;
+}
+
+export interface GeometryConfig {
+  type: GeometryType;
+  scale: Vector3;
+  baseScale: number;          // 0.5 - 10.0 based on importance
+  customModelUrl?: string;    // For custom GLB models
+}
+
+// =============================================================================
+// MATERIAL CONFIGURATION
+// =============================================================================
+
+export interface MaterialConfig {
+  shader: ShaderType;
+  color: ColorConfig;
+  opacity: number;            // 0-1
+  emissive: boolean;
+  emissiveIntensity: number;  // 0-2
+  wireframe: boolean;
+  pulse: PulseConfig;
+}
+
+export interface ColorConfig {
+  base: string;               // Hex color
+  emissive: string;           // Glow color
+  accent: string;             // Highlight color
+  healthGradient?: {          // Dynamic health-based coloring
+    healthy: string;
+    warning: string;
+    critical: string;
+  };
+}
+
+export interface PulseConfig {
+  enabled: boolean;
+  frequency: number;          // BPM (60 = calm, 120 = stressed)
+  amplitude: number;          // Scale variance 0-0.5
+  pattern: 'sine' | 'heartbeat' | 'glitch' | 'breath';
+}
+
+// =============================================================================
+// ANIMATION CONFIGURATION
+// =============================================================================
+
+export interface AnimationConfig {
+  idle: IdleAnimation;
+  hover: HoverAnimation;
+  select: SelectAnimation;
+  peel: PeelAnimation;
+}
+
+export interface IdleAnimation {
+  rotation: boolean;          // Slowly rotate?
+  rotationSpeed: number;      // Degrees per second
+  float: boolean;             // Bob up and down?
+  floatAmplitude: number;     // Units
+  floatSpeed: number;         // Cycles per second
+}
+
+export interface HoverAnimation {
+  scaleMultiplier: number;    // 1.1 = 10% bigger on hover
+  glowIntensity: number;      // Emissive boost
+  duration: number;           // ms
+}
+
+export interface SelectAnimation {
+  scaleMultiplier: number;
+  outlineColor: string;
+  outlineWidth: number;
+  duration: number;
+}
+
+export interface PeelAnimation {
+  duration: number;           // ms per layer peel
+  fragmentCount: number;      // Number of shell fragments
+  fragmentFadeTime: number;   // ms
+  revealGlowDuration: number; // ms
+  sound: string;              // Audio file reference
+}
+
+// =============================================================================
+// THE ONION LAYERS (Patent Pillar B)
+// =============================================================================
+
+export interface OnionLayers {
+  surface: SurfaceLayer;
+  metadata: MetadataLayer;
+  connections: ConnectionsLayer;
+  structure: StructureLayer;
+  core: CoreLayer;
+}
+
+// Layer 5: Surface - First impression
+export interface SurfaceLayer {
+  icon: string;               // Emoji or icon reference
+  title: string;              // Short display name
+  status: 'healthy' | 'warning' | 'critical' | 'offline' | 'unknown';
+  activityLevel: number;      // 0-100
+  importance: number;         // 0-100 (affects size)
+  badges: Badge[];            // VIP, New, Alert, etc.
+}
+
+export interface Badge {
+  type: 'vip' | 'new' | 'alert' | 'verified' | 'threat' | 'custom';
+  label?: string;
+  color: string;
+}
+
+// Layer 4: Metadata - Identity
+export interface MetadataLayer {
+  fullName: string;
+  description: string;
+  category: string;
+  tags: string[];
+  owner?: string;
+  source: string;             // System of origin
+  created: string;
+  modified: string;
+  customFields: Record<string, any>;
+  // Gemini: Data integrity indicator
+  integrityStatus?: {
+    hash: string;             // SHA-256 of content
+    verified: boolean;        // Green/Red indicator
+    lastVerified: string;     // Timestamp
+    tamperedFields?: string[]; // List of modified fields
+  };
+}
+
+// Layer 3: Connections - Relationships
+export interface ConnectionsLayer {
+  inbound: Connection[];
+  outbound: Connection[];
+  bidirectional: Connection[];
+  totalConnections: number;
+  strongestConnection?: string; // Node ID
+}
+
+export interface Connection {
+  targetId: string;
+  targetType: EntityType;
+  relationshipType: string;   // 'depends_on', 'parent_of', 'connects_to', etc.
+  strength: number;           // 0-1
+  direction: 'in' | 'out' | 'both';
+  metadata?: Record<string, any>;
+}
+
+// Layer 2: Structure - Anatomy
+export interface StructureLayer {
+  schema?: SchemaDefinition;
+  children: ChildNode[];
+  hierarchy: string[];        // Breadcrumb path
+  depth: number;              // Nesting level
+  expandable: boolean;
+  preview?: string;           // Code/content preview
+}
+
+export interface SchemaDefinition {
+  type: string;
+  fields: SchemaField[];
+}
+
+export interface SchemaField {
+  name: string;
+  type: string;
+  required: boolean;
+  description?: string;
+}
+
+export interface ChildNode {
+  id: string;
+  type: EntityType;
+  name: string;
+  count?: number;             // For aggregates
+}
+
+// Layer 1: Core - The Truth
+export interface CoreLayer {
+  // SECURITY FIX (Grok): rawData is now lazy-loaded, not stored in client state
+  rawDataRef?: string;        // Reference ID for fetching - NOT the data itself
+  rawDataPreview?: string;    // Safe preview (first 100 chars, sanitized)
+  fetchRawData?: () => Promise<any>; // Auth-checked lazy loader
+  origin: DataOrigin;
+  audit: AuditTrail;
+  actions: AvailableAction[];
+}
+
+export interface DataOrigin {
+  system: string;             // Neo4j, PostgreSQL, Notion, ServiceNow, etc.
+  database?: string;
+  table?: string;
+  collection?: string;
+  primaryKey: string;
+  query?: string;             // How to fetch this
+  url?: string;               // Direct link
+}
+
+export interface AuditTrail {
+  createdBy: string;
+  createdAt: string;
+  history: ChangeRecord[];
+  version: number;
+}
+
+export interface ChangeRecord {
+  timestamp: string;
+  actor: string;
+  action: string;
+  changes: Record<string, { old: any; new: any }>;
+}
+
+export interface AvailableAction {
+  id: string;
+  label: string;
+  icon: string;
+  type: 'view' | 'edit' | 'delete' | 'navigate' | 'execute' | 'export';
+  requiresConfirmation: boolean;
+  permissions: string[];
+}
+
+// =============================================================================
+// INTERACTION STATE
+// =============================================================================
+
+export interface InteractionState {
+  hoverable: boolean;
+  selectable: boolean;
+  grabbable: boolean;
+  peelable: boolean;
+  expandable: boolean;
+
+  isHovered: boolean;
+  isSelected: boolean;
+  isGrabbed: boolean;
+  isPeeling: boolean;
+
+  grabOffset?: Vector3;
+  lastInteraction?: string;   // Timestamp
+}
+
+// =============================================================================
+// LEVEL OF DETAIL
+// =============================================================================
+
+export interface LODConfig {
+  near: number;               // Distance for full detail
+  mid: number;                // Distance for medium detail
+  far: number;                // Distance for low detail (billboard)
+
+  nearGeometry: GeometryType;
+  midGeometry: GeometryType;
+  farGeometry: 'billboard' | 'point';
+
+  showLabelsAt: number;       // Distance threshold
+  showConnectionsAt: number;  // Distance threshold
+}
+
+// =============================================================================
+// ENTITY TYPE MAPPINGS
+// =============================================================================
+
+/**
+ * Default visual configuration per entity type
+ */
+export const ENTITY_TYPE_DEFAULTS: Record<EntityType, Partial<VisualNode>> = {
+  // Data entities
+  file: {
+    geometry: { type: 'cube', scale: { x: 1, y: 1, z: 1 }, baseScale: 1.0 },
+    material: { shader: 'standard', color: { base: '#00ff88', emissive: '#00ff88', accent: '#ffffff' }, opacity: 1, emissive: true, emissiveIntensity: 0.3, wireframe: false, pulse: { enabled: true, frequency: 30, amplitude: 0.05, pattern: 'breath' } },
+  },
+  database: {
+    geometry: { type: 'cylinder', scale: { x: 1.5, y: 1, z: 1.5 }, baseScale: 2.0 },
+    material: { shader: 'hologram', color: { base: '#0088ff', emissive: '#0088ff', accent: '#ffffff' }, opacity: 0.9, emissive: true, emissiveIntensity: 0.5, wireframe: false, pulse: { enabled: true, frequency: 45, amplitude: 0.1, pattern: 'sine' } },
+  },
+
+  // Network entities
+  access_point: {
+    geometry: { type: 'octahedron', scale: { x: 1, y: 1, z: 1 }, baseScale: 1.0 },
+    material: { shader: 'energy', color: { base: '#00ffaa', emissive: '#00ffaa', accent: '#ffffff', healthGradient: { healthy: '#00ff00', warning: '#ffaa00', critical: '#ff0000' } }, opacity: 1, emissive: true, emissiveIntensity: 0.6, wireframe: false, pulse: { enabled: true, frequency: 60, amplitude: 0.1, pattern: 'sine' } },
+  },
+  switch: {
+    geometry: { type: 'cube', scale: { x: 2, y: 0.5, z: 1 }, baseScale: 1.5 },
+    material: { shader: 'standard', color: { base: '#44ff44', emissive: '#22aa22', accent: '#ffffff' }, opacity: 1, emissive: true, emissiveIntensity: 0.4, wireframe: false, pulse: { enabled: true, frequency: 40, amplitude: 0.05, pattern: 'breath' } },
+  },
+  router: {
+    geometry: { type: 'sphere', scale: { x: 1.2, y: 1.2, z: 1.2 }, baseScale: 2.0 },
+    material: { shader: 'energy', color: { base: '#00aaff', emissive: '#0088ff', accent: '#ffffff' }, opacity: 1, emissive: true, emissiveIntensity: 0.7, wireframe: false, pulse: { enabled: true, frequency: 50, amplitude: 0.15, pattern: 'heartbeat' } },
+  },
+  server: {
+    geometry: { type: 'cylinder', scale: { x: 1, y: 2, z: 1 }, baseScale: 2.5 },
+    material: { shader: 'hologram', color: { base: '#aa00ff', emissive: '#8800cc', accent: '#ffffff' }, opacity: 0.95, emissive: true, emissiveIntensity: 0.5, wireframe: false, pulse: { enabled: true, frequency: 60, amplitude: 0.08, pattern: 'heartbeat' } },
+  },
+
+  // Organization entities
+  organization: {
+    geometry: { type: 'building', scale: { x: 3, y: 4, z: 3 }, baseScale: 5.0 },
+    material: { shader: 'glass', color: { base: '#4488ff', emissive: '#2266cc', accent: '#ffffff' }, opacity: 0.8, emissive: true, emissiveIntensity: 0.3, wireframe: false, pulse: { enabled: true, frequency: 20, amplitude: 0.02, pattern: 'breath' } },
+  },
+  branch: {
+    geometry: { type: 'building', scale: { x: 2, y: 2.5, z: 2 }, baseScale: 3.0 },
+    material: { shader: 'standard', color: { base: '#5599ff', emissive: '#3377cc', accent: '#ffffff' }, opacity: 1, emissive: true, emissiveIntensity: 0.3, wireframe: false, pulse: { enabled: true, frequency: 25, amplitude: 0.03, pattern: 'breath' } },
+  },
+  person: {
+    geometry: { type: 'humanoid', scale: { x: 1, y: 1, z: 1 }, baseScale: 0.8 },
+    material: { shader: 'standard', color: { base: '#ffffff', emissive: '#aaaaaa', accent: '#00ff88' }, opacity: 1, emissive: true, emissiveIntensity: 0.2, wireframe: false, pulse: { enabled: true, frequency: 70, amplitude: 0.05, pattern: 'heartbeat' } },
+  },
+
+  // Security entities (Patent Pillar C)
+  malware: {
+    geometry: { type: 'sphere', scale: { x: 1, y: 1, z: 1 }, baseScale: 1.2 },
+    material: { shader: 'threat', color: { base: '#ff0040', emissive: '#ff0000', accent: '#ffaa00' }, opacity: 1, emissive: true, emissiveIntensity: 1.0, wireframe: false, pulse: { enabled: true, frequency: 120, amplitude: 0.3, pattern: 'glitch' } },
+  },
+  threat_actor: {
+    geometry: { type: 'humanoid', scale: { x: 1.2, y: 1.2, z: 1.2 }, baseScale: 1.5 },
+    material: { shader: 'threat', color: { base: '#880000', emissive: '#ff0000', accent: '#ffff00' }, opacity: 0.9, emissive: true, emissiveIntensity: 0.8, wireframe: false, pulse: { enabled: true, frequency: 90, amplitude: 0.2, pattern: 'glitch' } },
+  },
+  nation_state: {
+    geometry: { type: 'building', scale: { x: 4, y: 5, z: 4 }, baseScale: 6.0 },
+    material: { shader: 'threat', color: { base: '#660000', emissive: '#aa0000', accent: '#ffaa00' }, opacity: 1, emissive: true, emissiveIntensity: 0.6, wireframe: false, pulse: { enabled: true, frequency: 40, amplitude: 0.1, pattern: 'heartbeat' } },
+  },
+
+  // Business entities (Patent Pillar D)
+  customer: {
+    geometry: { type: 'sphere', scale: { x: 1.5, y: 1.5, z: 1.5 }, baseScale: 2.0 },
+    material: { shader: 'standard', color: { base: '#ffd700', emissive: '#ffaa00', accent: '#ffffff', healthGradient: { healthy: '#00ff00', warning: '#ffaa00', critical: '#ff0000' } }, opacity: 1, emissive: true, emissiveIntensity: 0.5, wireframe: false, pulse: { enabled: true, frequency: 60, amplitude: 0.1, pattern: 'heartbeat' } },
+  },
+  journey: {
+    geometry: { type: 'path', scale: { x: 10, y: 0.5, z: 2 }, baseScale: 1.0 },
+    material: { shader: 'energy', color: { base: '#00ffff', emissive: '#00aaaa', accent: '#ffffff' }, opacity: 0.8, emissive: true, emissiveIntensity: 0.6, wireframe: false, pulse: { enabled: true, frequency: 30, amplitude: 0.05, pattern: 'sine' } },
+  },
+  ticket: {
+    geometry: { type: 'cube', scale: { x: 1, y: 0.6, z: 0.1 }, baseScale: 0.8 },
+    material: { shader: 'standard', color: { base: '#ff8800', emissive: '#ff6600', accent: '#ffffff', healthGradient: { healthy: '#00ff00', warning: '#ffaa00', critical: '#ff0000' } }, opacity: 1, emissive: true, emissiveIntensity: 0.4, wireframe: false, pulse: { enabled: true, frequency: 80, amplitude: 0.15, pattern: 'heartbeat' } },
+  },
+
+  // AI entities
+  agent: {
+    geometry: { type: 'dodecahedron', scale: { x: 1.2, y: 1.2, z: 1.2 }, baseScale: 1.5 },
+    material: { shader: 'energy', color: { base: '#ffd700', emissive: '#ffaa00', accent: '#ffffff' }, opacity: 1, emissive: true, emissiveIntensity: 0.8, wireframe: false, pulse: { enabled: true, frequency: 60, amplitude: 0.2, pattern: 'heartbeat' } },
+  },
+
+  // Generic
+  error: {
+    geometry: { type: 'sphere', scale: { x: 1, y: 1, z: 1 }, baseScale: 1.0 },
+    material: { shader: 'error', color: { base: '#ff0040', emissive: '#ff0000', accent: '#ffffff' }, opacity: 1, emissive: true, emissiveIntensity: 1.0, wireframe: false, pulse: { enabled: true, frequency: 120, amplitude: 0.3, pattern: 'glitch' } },
+  },
+  alert: {
+    geometry: { type: 'tetrahedron', scale: { x: 1, y: 1.5, z: 1 }, baseScale: 1.2 },
+    material: { shader: 'standard', color: { base: '#ffaa00', emissive: '#ff8800', accent: '#ffffff' }, opacity: 1, emissive: true, emissiveIntensity: 0.8, wireframe: false, pulse: { enabled: true, frequency: 100, amplitude: 0.25, pattern: 'sine' } },
+  },
+  unknown: {
+    geometry: { type: 'sphere', scale: { x: 1, y: 1, z: 1 }, baseScale: 1.0 },
+    material: { shader: 'standard', color: { base: '#888888', emissive: '#666666', accent: '#ffffff' }, opacity: 0.7, emissive: true, emissiveIntensity: 0.2, wireframe: true, pulse: { enabled: false, frequency: 0, amplitude: 0, pattern: 'sine' } },
+  },
+
+  // Fill in remaining types with sensible defaults
+  table: {
+    geometry: { type: 'cube', scale: { x: 1.5, y: 0.5, z: 1 }, baseScale: 1.2 },
+    material: { shader: 'hologram', color: { base: '#0088ff', emissive: '#0066cc', accent: '#ffffff' }, opacity: 0.9, emissive: true, emissiveIntensity: 0.4, wireframe: false, pulse: { enabled: true, frequency: 35, amplitude: 0.05, pattern: 'breath' } },
+  },
+  record: {
+    geometry: { type: 'cube', scale: { x: 0.8, y: 0.8, z: 0.2 }, baseScale: 0.6 },
+    material: { shader: 'standard', color: { base: '#00aaff', emissive: '#0088cc', accent: '#ffffff' }, opacity: 1, emissive: true, emissiveIntensity: 0.3, wireframe: false, pulse: { enabled: true, frequency: 25, amplitude: 0.03, pattern: 'breath' } },
+  },
+  firewall: {
+    geometry: { type: 'cube', scale: { x: 3, y: 2, z: 0.3 }, baseScale: 2.5 },
+    material: { shader: 'energy', color: { base: '#ff4400', emissive: '#ff2200', accent: '#ffff00' }, opacity: 0.9, emissive: true, emissiveIntensity: 0.7, wireframe: false, pulse: { enabled: true, frequency: 55, amplitude: 0.1, pattern: 'sine' } },
+  },
+  endpoint: {
+    geometry: { type: 'cube', scale: { x: 1, y: 0.7, z: 0.1 }, baseScale: 0.7 },
+    material: { shader: 'standard', color: { base: '#44aaff', emissive: '#2288cc', accent: '#ffffff' }, opacity: 1, emissive: true, emissiveIntensity: 0.3, wireframe: false, pulse: { enabled: true, frequency: 50, amplitude: 0.05, pattern: 'breath' } },
+  },
+  ip_address: {
+    geometry: { type: 'tetrahedron', scale: { x: 0.6, y: 0.6, z: 0.6 }, baseScale: 0.5 },
+    material: { shader: 'hologram', color: { base: '#ffaa00', emissive: '#ff8800', accent: '#ffffff' }, opacity: 0.85, emissive: true, emissiveIntensity: 0.5, wireframe: false, pulse: { enabled: true, frequency: 40, amplitude: 0.08, pattern: 'sine' } },
+  },
+  department: {
+    geometry: { type: 'building', scale: { x: 1.5, y: 1.5, z: 1.5 }, baseScale: 2.0 },
+    material: { shader: 'standard', color: { base: '#6699ff', emissive: '#4477cc', accent: '#ffffff' }, opacity: 1, emissive: true, emissiveIntensity: 0.3, wireframe: false, pulse: { enabled: true, frequency: 30, amplitude: 0.03, pattern: 'breath' } },
+  },
+  team: {
+    geometry: { type: 'sphere', scale: { x: 1.2, y: 1.2, z: 1.2 }, baseScale: 1.5 },
+    material: { shader: 'standard', color: { base: '#88aaff', emissive: '#6688cc', accent: '#ffffff' }, opacity: 1, emissive: true, emissiveIntensity: 0.3, wireframe: false, pulse: { enabled: true, frequency: 35, amplitude: 0.05, pattern: 'breath' } },
+  },
+  campaign: {
+    geometry: { type: 'octahedron', scale: { x: 1.5, y: 1.5, z: 1.5 }, baseScale: 2.0 },
+    material: { shader: 'threat', color: { base: '#aa0000', emissive: '#ff0000', accent: '#ffaa00' }, opacity: 0.95, emissive: true, emissiveIntensity: 0.7, wireframe: false, pulse: { enabled: true, frequency: 70, amplitude: 0.15, pattern: 'glitch' } },
+  },
+  threat_group: {
+    geometry: { type: 'dodecahedron', scale: { x: 2, y: 2, z: 2 }, baseScale: 3.0 },
+    material: { shader: 'threat', color: { base: '#770000', emissive: '#cc0000', accent: '#ffff00' }, opacity: 0.9, emissive: true, emissiveIntensity: 0.6, wireframe: false, pulse: { enabled: true, frequency: 50, amplitude: 0.1, pattern: 'heartbeat' } },
+  },
+  touchpoint: {
+    geometry: { type: 'sphere', scale: { x: 0.8, y: 0.8, z: 0.8 }, baseScale: 0.8 },
+    material: { shader: 'standard', color: { base: '#00ffaa', emissive: '#00cc88', accent: '#ffffff', healthGradient: { healthy: '#00ff00', warning: '#ffaa00', critical: '#ff0000' } }, opacity: 1, emissive: true, emissiveIntensity: 0.5, wireframe: false, pulse: { enabled: true, frequency: 45, amplitude: 0.1, pattern: 'sine' } },
+  },
+  sla: {
+    geometry: { type: 'torus', scale: { x: 1, y: 1, z: 0.3 }, baseScale: 1.0 },
+    material: { shader: 'energy', color: { base: '#00ff00', emissive: '#00aa00', accent: '#ffffff', healthGradient: { healthy: '#00ff00', warning: '#ffaa00', critical: '#ff0000' } }, opacity: 0.9, emissive: true, emissiveIntensity: 0.6, wireframe: false, pulse: { enabled: true, frequency: 60, amplitude: 0.15, pattern: 'heartbeat' } },
+  },
+  task: {
+    geometry: { type: 'cube', scale: { x: 0.8, y: 0.8, z: 0.8 }, baseScale: 0.8 },
+    material: { shader: 'hologram', color: { base: '#00ffff', emissive: '#00aaaa', accent: '#ffffff' }, opacity: 0.9, emissive: true, emissiveIntensity: 0.4, wireframe: false, pulse: { enabled: true, frequency: 50, amplitude: 0.08, pattern: 'sine' } },
+  },
+  memory: {
+    geometry: { type: 'torus', scale: { x: 1, y: 1, z: 0.5 }, baseScale: 1.2 },
+    material: { shader: 'organic', color: { base: '#ff00ff', emissive: '#aa00aa', accent: '#ffffff' }, opacity: 0.85, emissive: true, emissiveIntensity: 0.5, wireframe: false, pulse: { enabled: true, frequency: 30, amplitude: 0.1, pattern: 'breath' } },
+  },
+
+  // =============================================================================
+  // GEMINI ADDITIONS - New Entity Types
+  // =============================================================================
+
+  // Network additions
+  firewall_policy: {
+    geometry: { type: 'cube', scale: { x: 2, y: 1.5, z: 0.2 }, baseScale: 1.8 },
+    material: { shader: 'shield_hex', color: { base: '#ff6600', emissive: '#ff4400', accent: '#ffff00' }, opacity: 0.95, emissive: true, emissiveIntensity: 0.6, wireframe: false, pulse: { enabled: true, frequency: 45, amplitude: 0.08, pattern: 'sine' } },
+  },
+  api_gateway: {
+    geometry: { type: 'octahedron', scale: { x: 1.5, y: 2, z: 1.5 }, baseScale: 2.2 },
+    material: { shader: 'hologram', color: { base: '#00ccff', emissive: '#0099cc', accent: '#ffffff' }, opacity: 0.9, emissive: true, emissiveIntensity: 0.5, wireframe: false, pulse: { enabled: true, frequency: 50, amplitude: 0.1, pattern: 'sine' } },
+  },
+  load_balancer: {
+    geometry: { type: 'torus', scale: { x: 2, y: 2, z: 0.5 }, baseScale: 2.0 },
+    material: { shader: 'energy', color: { base: '#44ff88', emissive: '#22cc66', accent: '#ffffff' }, opacity: 0.9, emissive: true, emissiveIntensity: 0.6, wireframe: false, pulse: { enabled: true, frequency: 60, amplitude: 0.12, pattern: 'heartbeat' } },
+  },
+
+  // Cloud/Container entities
+  container_pod: {
+    geometry: { type: 'cube', scale: { x: 1, y: 1, z: 1 }, baseScale: 1.0 },
+    material: { shader: 'cloud_vapor', color: { base: '#326ce5', emissive: '#2558c5', accent: '#ffffff' }, opacity: 0.9, emissive: true, emissiveIntensity: 0.4, wireframe: false, pulse: { enabled: true, frequency: 40, amplitude: 0.06, pattern: 'breath' } },
+  },
+  kubernetes_cluster: {
+    geometry: { type: 'dodecahedron', scale: { x: 3, y: 3, z: 3 }, baseScale: 4.0 },
+    material: { shader: 'cloud_vapor', color: { base: '#326ce5', emissive: '#2558c5', accent: '#ffffff' }, opacity: 0.85, emissive: true, emissiveIntensity: 0.5, wireframe: false, pulse: { enabled: true, frequency: 30, amplitude: 0.08, pattern: 'breath' } },
+  },
+  cloud_function: {
+    geometry: { type: 'tetrahedron', scale: { x: 1, y: 1.2, z: 1 }, baseScale: 1.0 },
+    material: { shader: 'cloud_vapor', color: { base: '#ff9900', emissive: '#cc7700', accent: '#ffffff' }, opacity: 0.9, emissive: true, emissiveIntensity: 0.5, wireframe: false, pulse: { enabled: true, frequency: 55, amplitude: 0.1, pattern: 'sine' } },
+  },
+
+  // Identity entities
+  identity_provider: {
+    geometry: { type: 'cylinder', scale: { x: 1.5, y: 2, z: 1.5 }, baseScale: 2.5 },
+    material: { shader: 'shield_hex', color: { base: '#9945ff', emissive: '#7733cc', accent: '#ffffff' }, opacity: 0.95, emissive: true, emissiveIntensity: 0.6, wireframe: false, pulse: { enabled: true, frequency: 35, amplitude: 0.06, pattern: 'breath' } },
+  },
+  service_account: {
+    geometry: { type: 'sphere', scale: { x: 0.8, y: 0.8, z: 0.8 }, baseScale: 0.7 },
+    material: { shader: 'hologram', color: { base: '#aa88ff', emissive: '#8866cc', accent: '#ffffff' }, opacity: 0.85, emissive: true, emissiveIntensity: 0.4, wireframe: false, pulse: { enabled: true, frequency: 40, amplitude: 0.05, pattern: 'breath' } },
+  },
+  certificate: {
+    geometry: { type: 'cube', scale: { x: 1.2, y: 0.8, z: 0.1 }, baseScale: 0.8 },
+    material: { shader: 'standard', color: { base: '#00ff88', emissive: '#00cc66', accent: '#ffd700' }, opacity: 1, emissive: true, emissiveIntensity: 0.5, wireframe: false, pulse: { enabled: true, frequency: 25, amplitude: 0.03, pattern: 'breath' } },
+  },
+
+  // IoT entities
+  iot_device: {
+    geometry: { type: 'sphere', scale: { x: 0.6, y: 0.6, z: 0.6 }, baseScale: 0.5 },
+    material: { shader: 'pulse_rings', color: { base: '#00ff00', emissive: '#00aa00', accent: '#ffffff', healthGradient: { healthy: '#00ff00', warning: '#ffaa00', critical: '#ff0000' } }, opacity: 1, emissive: true, emissiveIntensity: 0.6, wireframe: false, pulse: { enabled: true, frequency: 70, amplitude: 0.15, pattern: 'heartbeat' } },
+  },
+  sensor: {
+    geometry: { type: 'octahedron', scale: { x: 0.5, y: 0.7, z: 0.5 }, baseScale: 0.4 },
+    material: { shader: 'pulse_rings', color: { base: '#44ffaa', emissive: '#22cc88', accent: '#ffffff', healthGradient: { healthy: '#00ff00', warning: '#ffaa00', critical: '#ff0000' } }, opacity: 1, emissive: true, emissiveIntensity: 0.5, wireframe: false, pulse: { enabled: true, frequency: 80, amplitude: 0.2, pattern: 'sine' } },
+  },
+
+  // Security additions
+  vulnerability: {
+    geometry: { type: 'sphere', scale: { x: 0.8, y: 0.8, z: 0.8 }, baseScale: 0.9 },
+    material: { shader: 'glitch_noise_v2', color: { base: '#ffaa00', emissive: '#ff8800', accent: '#ff0000' }, opacity: 0.9, emissive: true, emissiveIntensity: 0.7, wireframe: false, pulse: { enabled: true, frequency: 90, amplitude: 0.2, pattern: 'glitch' } },
+  },
+  exploit: {
+    geometry: { type: 'tetrahedron', scale: { x: 1, y: 1.5, z: 1 }, baseScale: 1.2 },
+    material: { shader: 'glitch_noise_v2', color: { base: '#ff0000', emissive: '#cc0000', accent: '#ffff00' }, opacity: 1, emissive: true, emissiveIntensity: 0.9, wireframe: false, pulse: { enabled: true, frequency: 110, amplitude: 0.25, pattern: 'glitch' } },
+  },
+
+  // Business additions
+  contract: {
+    geometry: { type: 'cube', scale: { x: 1.5, y: 1, z: 0.1 }, baseScale: 1.0 },
+    material: { shader: 'gold_metallic_clean', color: { base: '#ffd700', emissive: '#cc9900', accent: '#ffffff' }, opacity: 1, emissive: true, emissiveIntensity: 0.4, wireframe: false, pulse: { enabled: true, frequency: 20, amplitude: 0.02, pattern: 'breath' } },
+  },
+  invoice: {
+    geometry: { type: 'cube', scale: { x: 1.2, y: 0.8, z: 0.05 }, baseScale: 0.7 },
+    material: { shader: 'standard', color: { base: '#88ff88', emissive: '#66cc66', accent: '#ffffff', healthGradient: { healthy: '#00ff00', warning: '#ffaa00', critical: '#ff0000' } }, opacity: 1, emissive: true, emissiveIntensity: 0.3, wireframe: false, pulse: { enabled: true, frequency: 30, amplitude: 0.04, pattern: 'breath' } },
+  },
+
+  // =============================================================================
+  // GEMINI: SEPARATION OF CONCERN - Server Split
+  // =============================================================================
+
+  compute_node: {
+    geometry: { type: 'octahedron', scale: { x: 1.5, y: 1.5, z: 1.5 }, baseScale: 2.0 },
+    material: { shader: 'energy', color: { base: '#ff6600', emissive: '#cc4400', accent: '#ffffff' }, opacity: 0.95, emissive: true, emissiveIntensity: 0.7, wireframe: false, pulse: { enabled: true, frequency: 80, amplitude: 0.15, pattern: 'heartbeat' } },
+  },
+  storage_node: {
+    geometry: { type: 'cylinder', scale: { x: 1.2, y: 2, z: 1.2 }, baseScale: 2.2 },
+    material: { shader: 'matte_ceramic_hex', color: { base: '#2c3e50', emissive: '#00ff41', accent: '#ffffff' }, opacity: 1, emissive: true, emissiveIntensity: 0.4, wireframe: false, pulse: { enabled: true, frequency: 30, amplitude: 0.05, pattern: 'breath' } },
+  },
+
+  // =============================================================================
+  // DEEPSEEK: COGNITIVE ENTITY TYPES
+  // =============================================================================
+
+  neural_node: {
+    geometry: { type: 'sphere', scale: { x: 1, y: 1, z: 1 }, baseScale: 1.2 },
+    material: { shader: 'energy', color: { base: '#3399ff', emissive: '#0066cc', accent: '#ffffff' }, opacity: 0.7, emissive: true, emissiveIntensity: 0.7, wireframe: false, pulse: { enabled: true, frequency: 150, amplitude: 0.1, pattern: 'sine' } },
+  },
+  synapse_connection: {
+    geometry: { type: 'cylinder', scale: { x: 0.1, y: 3, z: 0.1 }, baseScale: 1.0 },
+    material: { shader: 'flow_particle_stream', color: { base: '#ff6633', emissive: '#cc4400', accent: '#ffff00' }, opacity: 0.6, emissive: true, emissiveIntensity: 0.9, wireframe: false, pulse: { enabled: true, frequency: 480, amplitude: 0.2, pattern: 'sine' } },
+  },
+  concept_cluster: {
+    geometry: { type: 'dodecahedron', scale: { x: 2, y: 2, z: 2 }, baseScale: 2.5 },
+    material: { shader: 'organic', color: { base: '#66cc4d', emissive: '#44aa33', accent: '#ffffff' }, opacity: 0.6, emissive: true, emissiveIntensity: 0.5, wireframe: false, pulse: { enabled: true, frequency: 60, amplitude: 0.08, pattern: 'breath' } },
+  },
+  memory_trace: {
+    geometry: { type: 'torus', scale: { x: 1.5, y: 1.5, z: 0.3 }, baseScale: 1.5 },
+    material: { shader: 'hologram', color: { base: '#cc99e6', emissive: '#9966cc', accent: '#ffffff' }, opacity: 0.3, emissive: true, emissiveIntensity: 0.3, wireframe: false, pulse: { enabled: true, frequency: 30, amplitude: 0.15, pattern: 'breath' } },
+  },
+  metacognitive_monitor: {
+    geometry: { type: 'icosahedron', scale: { x: 1.5, y: 1.5, z: 1.5 }, baseScale: 2.0 },
+    material: { shader: 'gold_metallic_clean', color: { base: '#ffe633', emissive: '#ccb300', accent: '#ffffff' }, opacity: 0.8, emissive: true, emissiveIntensity: 0.8, wireframe: false, pulse: { enabled: true, frequency: 180, amplitude: 0.12, pattern: 'heartbeat' } },
+  },
+};
+
+// =============================================================================
+// FACTORY FUNCTION
+// =============================================================================
+
+export function createVisualNode(
+  type: EntityType,
+  data: Partial<VisualNode>
+): VisualNode {
+  const defaults = ENTITY_TYPE_DEFAULTS[type] || ENTITY_TYPE_DEFAULTS.unknown;
+
+  return {
+    id: data.id || crypto.randomUUID(),
+    externalId: data.externalId,
+    type,
+    labels: data.labels || [type],
+    position: data.position || { x: 0, y: 0, z: 0 },
+    velocity: data.velocity || { x: 0, y: 0, z: 0 },
+    rotation: data.rotation || { x: 0, y: 0, z: 0 },
+    mass: data.mass || 1,
+    fixed: data.fixed || false,
+    collisionRadius: data.collisionRadius || 1,
+    geometry: { ...defaults.geometry, ...data.geometry } as GeometryConfig,
+    material: { ...defaults.material, ...data.material } as MaterialConfig,
+    animation: data.animation || getDefaultAnimation(),
+    layers: data.layers || getEmptyLayers(),
+    currentLayer: data.currentLayer || 'surface',
+    interaction: data.interaction || getDefaultInteraction(),
+    lod: data.lod || getDefaultLOD(),
+    parent: data.parent,
+    children: data.children || [],
+    createdAt: data.createdAt || new Date().toISOString(),
+    updatedAt: data.updatedAt || new Date().toISOString(),
+  };
+}
+
+function getDefaultAnimation(): AnimationConfig {
+  return {
+    idle: { rotation: true, rotationSpeed: 10, float: true, floatAmplitude: 0.1, floatSpeed: 0.5 },
+    hover: { scaleMultiplier: 1.1, glowIntensity: 0.3, duration: 200 },
+    select: { scaleMultiplier: 1.2, outlineColor: '#ffffff', outlineWidth: 2, duration: 150 },
+    peel: { duration: 500, fragmentCount: 12, fragmentFadeTime: 800, revealGlowDuration: 300, sound: 'peel_default' },
+  };
+}
+
+function getEmptyLayers(): OnionLayers {
+  return {
+    surface: { icon: '❓', title: 'Unknown', status: 'unknown', activityLevel: 0, importance: 50, badges: [] },
+    metadata: { fullName: '', description: '', category: '', tags: [], source: '', created: '', modified: '', customFields: {} },
+    connections: { inbound: [], outbound: [], bidirectional: [], totalConnections: 0 },
+    structure: { children: [], hierarchy: [], depth: 0, expandable: false },
+    core: { rawDataRef: undefined, rawDataPreview: undefined, origin: { system: 'unknown', primaryKey: '' }, audit: { createdBy: '', createdAt: '', history: [], version: 1 }, actions: [] },
+  };
+}
+
+function getDefaultInteraction(): InteractionState {
+  return {
+    hoverable: true,
+    selectable: true,
+    grabbable: true,
+    peelable: true,
+    expandable: true,
+    isHovered: false,
+    isSelected: false,
+    isGrabbed: false,
+    isPeeling: false,
+  };
+}
+
+function getDefaultLOD(): LODConfig {
+  return {
+    near: 5,
+    mid: 20,
+    far: 50,
+    nearGeometry: 'sphere',
+    midGeometry: 'octahedron',
+    farGeometry: 'point',
+    showLabelsAt: 15,
+    showConnectionsAt: 30,
+  };
+}