@rubytech/create-maxy-code 0.1.125 → 0.1.127

package/payload/platform/lib/graph-style/src/index.ts

@@ -0,0 +1,307 @@
+/**
+ * Shared palette + display-string primitives for any surface that renders
+ * the Neo4j graph. Both the live `/graph` page in platform/ui and the
+ * graph-viewer MCP plugin's PNG renderer import from here so a node looks
+ * the same wherever it appears: same colour family per label, same short
+ * canvas label per node.
+ *
+ * UI-only constants (filter-popover sets, zoom-tier wrap helpers,
+ * agent-action label sets) stay in platform/ui/app/lib/graph-labels.ts and
+ * platform/ui/app/graph/display-helpers.ts — they re-export the symbols
+ * defined here. The two parity tests (this lib's __tests__ and the UI's
+ * unchanged colour-stability tests) keep the surfaces in lockstep.
+ *
+ * Sources of truth:
+ *   - Label list: .docs/neo4j.md "Schema (Phase 0)" + "Standards Compliance"
+ *   - Brand colour for LocalBusiness: brand.json defaultColors.primary
+ *     (resolved at runtime; this module supplies the schema-default fallback)
+ */
+
+/**
+ * Label → display colour mapping. Closed list of node labels written by
+ * the Maxy MCP write paths. A new label without an entry here renders in
+ * FALLBACK_LABEL_COLOUR and is omitted from the legend.
+ */
+export const GRAPH_LABEL_COLOURS: Record<string, string> = {
+  // Business identity — slate-blue family
+  LocalBusiness: '#4F6B8A',
+  Service: '#6B85A0',
+  PriceSpecification: '#8AA0B8',
+  OpeningHoursSpecification: '#A8BACE',
+
+  // Estate-agent ontology. Listing/Property share the business slate-blue
+  // family; Viewing/Offer are transactional events placed in a warm amber
+  // family distinct from Agent and from the dusty-rose Task/Project/Event
+  // hues so the legend reads them as a separate band.
+  Listing: '#3F5670',
+  Property: '#5C7A99',
+  Viewing: '#D4A574',
+  Offer: '#B08850',
+
+  // External business entity — schema:Organization, written by memory-write
+  // as the Supplier label. Warm tobacco — distinct hue from internal-business
+  // slates so external entities are scannable at a glance.
+  Organization: '#8A6B47',
+
+  // People — terracotta family (warm, human)
+  Person: '#B86E4A',
+  UserProfile: '#D08960',
+  Preference: '#DFA67A',
+  AdminUser: '#8C5230',
+  AccessGrant: '#66381F',
+
+  // Knowledge — moss family (organic)
+  KnowledgeDocument: '#6E8A5A',
+  // chunked WhatsApp/messaging archive parent. Sits in the
+  // knowledge moss family because it's structurally a document parent
+  // (HAS_SECTION → :Section:Conversation chunks); the conversational
+  // plum family is reserved for the live Conversation/Message labels.
+  ConversationArchive: '#82A06A',
+  Section: '#8AA876',
+  Chunk: '#A6C194',
+  DigitalDocument: '#5A7548',
+  CreativeWork: '#B5C9A2',
+  Question: '#C7D6B5',
+  FAQPage: '#95B385',
+  DefinedTerm: '#76906A',
+  Review: '#3F5A2E',
+  ImageObject: '#A0BB8C',
+
+  // Conversational — muted plum/lavender family.
+  // Pairwise-distinctness invariants enforced by the UI test
+  // graph-labels.test.ts; UserMessage matches Preference (Person/family cue,
+  // the one intentional duplicate in the registry).
+  Conversation: '#6B5A85',
+  AdminConversation: '#4F4070',
+  PublicConversation: '#8A75A8',
+  Message: '#6B7280',
+  UserMessage: '#DFA67A',
+  AssistantMessage: '#C9A876',
+  ToolCall: '#B5ABCB',
+
+  // Tasks / projects / events — dusty rose family
+  Task: '#B0617A',
+  Project: '#8E4A60',
+  Event: '#C68095',
+
+  // Workflows — muted teal
+  Workflow: '#3A6F77',
+  WorkflowStep: '#5A8E96',
+  WorkflowRun: '#7AAAB2',
+  StepResult: '#9CC4CB',
+
+  // Email — muted moss, hue-adjacent to Knowledge but lower-saturation
+  // and warmer; never co-rendered with KnowledgeDocument.
+  Email: '#6F7F4A',
+  EmailAccount: '#91A063',
+
+  // Public-agent projection — burnished bronze sits between
+  // people-terracotta and email-moss but shares neither hue.
+  Agent: '#B8893D',
+}
+
+export const FALLBACK_LABEL_COLOUR = '#94A3B8'
+
+export const ALL_GRAPH_LABELS: readonly string[] = Object.freeze(
+  Object.keys(GRAPH_LABEL_COLOURS)
+)
+
+/**
+ * Select the sublabel whose colour should drive the node hue. Walks the
+ * label array from index 1 (skipping the base label at index 0) and
+ * returns the first sublabel that has a registered colour; falls back to
+ * labels[0]. Pure — drift-counting lives in resolveNodeColour.
+ */
+export function pickDisplayLabel(labels: readonly string[]): string | null {
+  for (let i = 1; i < labels.length; i++) {
+    if (Object.prototype.hasOwnProperty.call(GRAPH_LABEL_COLOURS, labels[i])) {
+      return labels[i]
+    }
+  }
+  return labels[0] ?? null
+}
+
+export function colourForLabel(label: string): string {
+  return GRAPH_LABEL_COLOURS[label] ?? FALLBACK_LABEL_COLOUR
+}
+
+export interface ResolvedNodeColour {
+  displayLabel: string | null
+  colour: string
+  driftCandidates: number
+}
+
+/**
+ * Single-source colour resolver. driftCandidates counts registered
+ * sublabels in labels[1..]; a node with two registered sublabels has
+ * driftCandidates = 2 and its rendered hue is order-dependent.
+ */
+export function resolveNodeColour(labels: readonly string[]): ResolvedNodeColour {
+  const displayLabel = pickDisplayLabel(labels)
+  const colour = displayLabel ? colourForLabel(displayLabel) : FALLBACK_LABEL_COLOUR
+  let driftCandidates = 0
+  for (let i = 1; i < labels.length; i++) {
+    if (Object.prototype.hasOwnProperty.call(GRAPH_LABEL_COLOURS, labels[i])) {
+      driftCandidates++
+    }
+  }
+  return { displayLabel, colour, driftCandidates }
+}
+
+// ---------------------------------------------------------------------------
+// Display strings — short canvas label + untruncated display name.
+// Verbatim from platform/ui/app/graph/display-helpers.ts at extraction time.
+// UI helpers that wrap on zoom tier, pack into multi-line canvas labels,
+// or compose tooltips stay in display-helpers.ts and call into these.
+// ---------------------------------------------------------------------------
+
+/**
+ * Structural type used by display-string helpers. Mirrors the shape of
+ * GraphNode without coupling to it.
+ */
+export interface GraphNodeLike {
+  id: string
+  labels: string[]
+  properties: Record<string, unknown>
+}
+
+const ISO_MINUTE_RE = /^(\d{4}-\d{2}-\d{2})T(\d{2}:\d{2})/
+const ISO_SECOND_RE = /^\d{4}-\d{2}-\d{2}T(\d{2}:\d{2}:\d{2})/
+
+/**
+ * YYYY-MM-DD HH:mm from an ISO 8601 prefix. Reads the prefix directly so
+ * timezone-stored UTC timestamps render identically across operator
+ * timezones; parsing to Date + reformatting would flip the day.
+ */
+export function formatRunTimestamp(iso: string): string | null {
+  const m = iso.match(ISO_MINUTE_RE)
+  if (!m) return null
+  return `${m[1]} ${m[2]}`
+}
+
+/** HH:mm:ss from an ISO 8601 prefix. Same tz-stable contract. */
+export function formatMessageTimestamp(iso: string): string | null {
+  const m = iso.match(ISO_SECOND_RE)
+  if (!m) return null
+  return m[1]
+}
+
+/**
+ * 24-char canvas label for a node. Label precedence per label family
+ * (ToolCall.toolName, WorkflowRun startedAt formatted, WorkflowStep.label,
+ * Person givenName+familyName compose, Agent displayName/slug, Message
+ * role+timestamp, ConversationArchive.title), then a generic fallthrough
+ * across curated keys (name, title, summary, givenName, subject, text),
+ * then a Conversation-specific `Conv <id8>` fallback so unpopulated
+ * conversations don't render as the literal label.
+ */
+export function pickShortLabel(node: GraphNodeLike): string {
+  const props = node.properties
+  const primaryLabel = node.labels[0]
+  if (primaryLabel === 'ToolCall') {
+    const v = props.toolName
+    if (typeof v === 'string' && v.length > 0) {
+      return v.length > 24 ? v.slice(0, 24) + '…' : v
+    }
+  } else if (primaryLabel === 'WorkflowRun') {
+    const v = props.startedAt
+    if (typeof v === 'string' && v.length > 0) {
+      const ts = formatRunTimestamp(v)
+      if (ts) return ts
+    }
+  } else if (primaryLabel === 'WorkflowStep') {
+    const v = props.label
+    if (typeof v === 'string' && v.length > 0) {
+      return v.length > 24 ? v.slice(0, 24) + '…' : v
+    }
+  } else if (primaryLabel === 'Person') {
+    const given = typeof props.givenName === 'string' ? props.givenName : ''
+    const family = typeof props.familyName === 'string' ? props.familyName : ''
+    const full = [given, family].filter((s) => s.length > 0).join(' ')
+    if (full.length > 0) {
+      return full.length > 24 ? full.slice(0, 24) + '…' : full
+    }
+  } else if (primaryLabel === 'Agent') {
+    const dn = typeof props.displayName === 'string' ? props.displayName : ''
+    const slug = typeof props.slug === 'string' ? props.slug : ''
+    const v = dn.length > 0 ? dn : slug
+    if (v.length > 0) {
+      return v.length > 24 ? v.slice(0, 24) + '…' : v
+    }
+  } else if (primaryLabel === 'Message') {
+    const role = typeof props.role === 'string' ? props.role : ''
+    const roleShort =
+      role === 'user' ? 'user'
+      : role === 'assistant' ? 'asst'
+      : role === 'system' ? 'sys'
+      : role === 'tool' ? 'tool'
+      : null
+    const createdAt = typeof props.createdAt === 'string' ? props.createdAt : ''
+    if (roleShort && createdAt) {
+      const ts = formatMessageTimestamp(createdAt)
+      if (ts) return `${roleShort} ${ts}`
+    }
+  } else if (primaryLabel === 'ConversationArchive') {
+    const t = typeof props.title === 'string' ? props.title : ''
+    if (t.length > 0) {
+      return t.length > 24 ? t.slice(0, 24) + '…' : t
+    }
+    return primaryLabel
+  }
+  for (const k of ['name', 'title', 'summary', 'givenName', 'subject', 'text']) {
+    const v = props[k]
+    if (typeof v === 'string' && v.length > 0) {
+      return v.length > 24 ? v.slice(0, 24) + '…' : v
+    }
+  }
+  if (primaryLabel === 'Conversation') {
+    const id = typeof props.conversationId === 'string' ? props.conversationId : null
+    if (id) return `Conv ${id.slice(0, 8)}`
+  }
+  return primaryLabel ?? '…'
+}
+
+/**
+ * Untruncated sibling of pickShortLabel. Used by side-panel headings and
+ * tooltips where the 24-char canvas-overlap cap does not apply.
+ */
+export function pickDisplayName(node: GraphNodeLike): string {
+  const props = node.properties
+  const primaryLabel = node.labels[0]
+  if (primaryLabel === 'ToolCall') {
+    const v = props.toolName
+    if (typeof v === 'string' && v.length > 0) return v
+  } else if (primaryLabel === 'WorkflowRun') {
+    const v = props.startedAt
+    if (typeof v === 'string' && v.length > 0) {
+      const ts = formatRunTimestamp(v)
+      if (ts) return ts
+    }
+  } else if (primaryLabel === 'WorkflowStep') {
+    const v = props.label
+    if (typeof v === 'string' && v.length > 0) return v
+  } else if (primaryLabel === 'Person') {
+    const given = typeof props.givenName === 'string' ? props.givenName : ''
+    const family = typeof props.familyName === 'string' ? props.familyName : ''
+    const full = [given, family].filter((s) => s.length > 0).join(' ')
+    if (full.length > 0) return full
+  } else if (primaryLabel === 'Agent') {
+    const dn = typeof props.displayName === 'string' ? props.displayName : ''
+    const slug = typeof props.slug === 'string' ? props.slug : ''
+    const v = dn.length > 0 ? dn : slug
+    if (v.length > 0) return v
+  } else if (primaryLabel === 'ConversationArchive') {
+    const t = typeof props.title === 'string' ? props.title : ''
+    if (t.length > 0) return t
+    return primaryLabel
+  }
+  for (const k of ['name', 'title', 'summary', 'givenName', 'subject', 'text']) {
+    const v = props[k]
+    if (typeof v === 'string' && v.length > 0) return v
+  }
+  if (primaryLabel === 'Conversation') {
+    const id = typeof props.conversationId === 'string' ? props.conversationId : null
+    if (id) return `Conv ${id.slice(0, 8)}`
+  }
+  return primaryLabel ?? '…'
+}

package/payload/platform/lib/graph-style/tsconfig.json

@@ -0,0 +1,9 @@
+{
+  "extends": "../../tsconfig.base.json",
+  "compilerOptions": {
+    "outDir": "dist",
+    "rootDir": "src"
+  },
+  "include": ["src"],
+  "exclude": ["src/__tests__"]
+}

package/payload/platform/lib/graph-style/vitest.config.ts

@@ -0,0 +1,9 @@
+import { defineConfig } from "vitest/config";
+
+export default defineConfig({
+  test: {
+    environment: "node",
+    globals: false,
+    include: ["src/__tests__/**/*.test.ts"],
+  },
+});

package/payload/platform/package-lock.json

@@ -97,6 +97,10 @@
       "resolved": "plugins/email/mcp",
       "link": true
     },
+    "node_modules/@maxy/graph-viewer": {
+      "resolved": "plugins/graph-viewer/mcp",
+      "link": true
+    },
     "node_modules/@maxy/memory": {
       "resolved": "plugins/memory/mcp",
       "link": true
@@ -196,6 +200,255 @@
         }
       }
     },
+    "node_modules/@napi-rs/canvas": {
+      "version": "0.1.100",
+      "resolved": "https://registry.npmjs.org/@napi-rs/canvas/-/canvas-0.1.100.tgz",
+      "integrity": "sha512-xglYA6q3XO5P3BNJYxVZ1IV7DLVjp1Py6nwag88YntrS+3vKHyYcMqXVS4ZztJmwz2uGvz1FWhI/4LgbR5uQDA==",
+      "license": "MIT",
+      "workspaces": [
+        "e2e/*"
+      ],
+      "engines": {
+        "node": ">= 10"
+      },
+      "funding": {
+        "type": "github",
+        "url": "https://github.com/sponsors/Brooooooklyn"
+      },
+      "optionalDependencies": {
+        "@napi-rs/canvas-android-arm64": "0.1.100",
+        "@napi-rs/canvas-darwin-arm64": "0.1.100",
+        "@napi-rs/canvas-darwin-x64": "0.1.100",
+        "@napi-rs/canvas-linux-arm-gnueabihf": "0.1.100",
+        "@napi-rs/canvas-linux-arm64-gnu": "0.1.100",
+        "@napi-rs/canvas-linux-arm64-musl": "0.1.100",
+        "@napi-rs/canvas-linux-riscv64-gnu": "0.1.100",
+        "@napi-rs/canvas-linux-x64-gnu": "0.1.100",
+        "@napi-rs/canvas-linux-x64-musl": "0.1.100",
+        "@napi-rs/canvas-win32-arm64-msvc": "0.1.100",
+        "@napi-rs/canvas-win32-x64-msvc": "0.1.100"
+      }
+    },
+    "node_modules/@napi-rs/canvas-android-arm64": {
+      "version": "0.1.100",
+      "resolved": "https://registry.npmjs.org/@napi-rs/canvas-android-arm64/-/canvas-android-arm64-0.1.100.tgz",
+      "integrity": "sha512-hjhCKhntPv9+t4ckHymdx0phYNcVW+GKQR6Lzw2zE+pOVjOplSmtx9nNNknTjbEDLcuLZqA1y8ufKg1XfgftzQ==",
+      "cpu": [
+        "arm64"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "android"
+      ],
+      "engines": {
+        "node": ">= 10"
+      },
+      "funding": {
+        "type": "github",
+        "url": "https://github.com/sponsors/Brooooooklyn"
+      }
+    },
+    "node_modules/@napi-rs/canvas-darwin-arm64": {
+      "version": "0.1.100",
+      "resolved": "https://registry.npmjs.org/@napi-rs/canvas-darwin-arm64/-/canvas-darwin-arm64-0.1.100.tgz",
+      "integrity": "sha512-2PcswRaC7Ly645DGt88///zuFDhJxJYdKAs1uU3mfk1atYkXufgcgLfBpk6Tm12nCQBaNt1wpybuPZ4qOhTo8A==",
+      "cpu": [
+        "arm64"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "darwin"
+      ],
+      "engines": {
+        "node": ">= 10"
+      },
+      "funding": {
+        "type": "github",
+        "url": "https://github.com/sponsors/Brooooooklyn"
+      }
+    },
+    "node_modules/@napi-rs/canvas-darwin-x64": {
+      "version": "0.1.100",
+      "resolved": "https://registry.npmjs.org/@napi-rs/canvas-darwin-x64/-/canvas-darwin-x64-0.1.100.tgz",
+      "integrity": "sha512-ePNZtj7pNIva/siZMg+HmbeozkIjqUIYdoymH8HaA3qK7LfzFN4WMBM8G6HQ9ZC+H3+Dnn5pqtiXpgLykaPOhw==",
+      "cpu": [
+        "x64"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "darwin"
+      ],
+      "engines": {
+        "node": ">= 10"
+      },
+      "funding": {
+        "type": "github",
+        "url": "https://github.com/sponsors/Brooooooklyn"
+      }
+    },
+    "node_modules/@napi-rs/canvas-linux-arm-gnueabihf": {
+      "version": "0.1.100",
+      "resolved": "https://registry.npmjs.org/@napi-rs/canvas-linux-arm-gnueabihf/-/canvas-linux-arm-gnueabihf-0.1.100.tgz",
+      "integrity": "sha512-d5cDB48oWFGU8/XPhUOFAlySgb/VAu7D+s8fi55K1Pcfg8aPplHWqMgibhVLU8ky7Pyg/fuiVLz4Nf3JrSTuUA==",
+      "cpu": [
+        "arm"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">= 10"
+      },
+      "funding": {
+        "type": "github",
+        "url": "https://github.com/sponsors/Brooooooklyn"
+      }
+    },
+    "node_modules/@napi-rs/canvas-linux-arm64-gnu": {
+      "version": "0.1.100",
+      "resolved": "https://registry.npmjs.org/@napi-rs/canvas-linux-arm64-gnu/-/canvas-linux-arm64-gnu-0.1.100.tgz",
+      "integrity": "sha512-rDxgxRu69RvDlX/bh9o22DxLsGr8EqsNgotL9+RwQE1S0b0cqeatqsw6aW45mukm0B42DIAaAacKaYQ8cqS1nw==",
+      "cpu": [
+        "arm64"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">= 10"
+      },
+      "funding": {
+        "type": "github",
+        "url": "https://github.com/sponsors/Brooooooklyn"
+      }
+    },
+    "node_modules/@napi-rs/canvas-linux-arm64-musl": {
+      "version": "0.1.100",
+      "resolved": "https://registry.npmjs.org/@napi-rs/canvas-linux-arm64-musl/-/canvas-linux-arm64-musl-0.1.100.tgz",
+      "integrity": "sha512-K3mDW66N+xT2/V439u1alFANiBUjdEx2gLiNYnCmUsva5jZMxWTjafBYwTzYK+EMFMHrUoabuU+T1BIP5CgbYQ==",
+      "cpu": [
+        "arm64"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">= 10"
+      },
+      "funding": {
+        "type": "github",
+        "url": "https://github.com/sponsors/Brooooooklyn"
+      }
+    },
+    "node_modules/@napi-rs/canvas-linux-riscv64-gnu": {
+      "version": "0.1.100",
+      "resolved": "https://registry.npmjs.org/@napi-rs/canvas-linux-riscv64-gnu/-/canvas-linux-riscv64-gnu-0.1.100.tgz",
+      "integrity": "sha512-mooqUBTIsccZpnoQC4NgrC1v6C1vof39etLNMnBwCY+p0gajWJvAHLGQ6g/gGyS5YrpDW+GefSN4+Cvcr08UWw==",
+      "cpu": [
+        "riscv64"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">= 10"
+      },
+      "funding": {
+        "type": "github",
+        "url": "https://github.com/sponsors/Brooooooklyn"
+      }
+    },
+    "node_modules/@napi-rs/canvas-linux-x64-gnu": {
+      "version": "0.1.100",
+      "resolved": "https://registry.npmjs.org/@napi-rs/canvas-linux-x64-gnu/-/canvas-linux-x64-gnu-0.1.100.tgz",
+      "integrity": "sha512-1eCvkDCazm7FFhsT7DfGOdSaHgZVK3bt/dSBl5EWHOWmnz+I7j8tPseJqqD81NF+MH21jKUK4wQSDjN0mdhnTg==",
+      "cpu": [
+        "x64"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">= 10"
+      },
+      "funding": {
+        "type": "github",
+        "url": "https://github.com/sponsors/Brooooooklyn"
+      }
+    },
+    "node_modules/@napi-rs/canvas-linux-x64-musl": {
+      "version": "0.1.100",
+      "resolved": "https://registry.npmjs.org/@napi-rs/canvas-linux-x64-musl/-/canvas-linux-x64-musl-0.1.100.tgz",
+      "integrity": "sha512-20arT6lnI19S68qNlii73TSEDbECNgzMz2EpldC1V3mZFuRkeujXkcebRk0LRJe9SEUAooYiLokfMViY8IX7yA==",
+      "cpu": [
+        "x64"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "linux"
+      ],
+      "engines": {
+        "node": ">= 10"
+      },
+      "funding": {
+        "type": "github",
+        "url": "https://github.com/sponsors/Brooooooklyn"
+      }
+    },
+    "node_modules/@napi-rs/canvas-win32-arm64-msvc": {
+      "version": "0.1.100",
+      "resolved": "https://registry.npmjs.org/@napi-rs/canvas-win32-arm64-msvc/-/canvas-win32-arm64-msvc-0.1.100.tgz",
+      "integrity": "sha512-DZFFT1wIAg37LJw37yhMRFfjATd3vTQzjZ1Yki8u2vhO6Hi5VE6BVaGQ1aaDu7xb4iMErz+9EOwjpS7xcxFeBw==",
+      "cpu": [
+        "arm64"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "win32"
+      ],
+      "engines": {
+        "node": ">= 10"
+      },
+      "funding": {
+        "type": "github",
+        "url": "https://github.com/sponsors/Brooooooklyn"
+      }
+    },
+    "node_modules/@napi-rs/canvas-win32-x64-msvc": {
+      "version": "0.1.100",
+      "resolved": "https://registry.npmjs.org/@napi-rs/canvas-win32-x64-msvc/-/canvas-win32-x64-msvc-0.1.100.tgz",
+      "integrity": "sha512-MyT1j3mHC2+Lu4pBi9mKyMJhtP6U7k7EldY7sj/uS5gJA65gTXt8MefJQXLJo5d/vZbuWmfxzkEUNc/urV3pHA==",
+      "cpu": [
+        "x64"
+      ],
+      "license": "MIT",
+      "optional": true,
+      "os": [
+        "win32"
+      ],
+      "engines": {
+        "node": ">= 10"
+      },
+      "funding": {
+        "type": "github",
+        "url": "https://github.com/sponsors/Brooooooklyn"
+      }
+    },
     "node_modules/@napi-rs/wasm-runtime": {
       "version": "1.1.4",
       "resolved": "https://registry.npmjs.org/@napi-rs/wasm-runtime/-/wasm-runtime-1.1.4.tgz",
@@ -524,6 +777,13 @@
         "assertion-error": "^2.0.1"
       }
     },
+    "node_modules/@types/d3-force": {
+      "version": "3.0.10",
+      "resolved": "https://registry.npmjs.org/@types/d3-force/-/d3-force-3.0.10.tgz",
+      "integrity": "sha512-ZYeSaCF3p73RdOKcjj+swRlZfnYpK1EbaDiYICEEp5Q6sUiqFaFQ9qgoshp5CzIyyb/yD09kD9o2zEltCexlgw==",
+      "dev": true,
+      "license": "MIT"
+    },
     "node_modules/@types/deep-eql": {
       "version": "4.0.2",
       "resolved": "https://registry.npmjs.org/@types/deep-eql/-/deep-eql-4.0.2.tgz",
@@ -1038,6 +1298,47 @@
         "node": ">= 8"
       }
     },
+    "node_modules/d3-dispatch": {
+      "version": "3.0.1",
+      "resolved": "https://registry.npmjs.org/d3-dispatch/-/d3-dispatch-3.0.1.tgz",
+      "integrity": "sha512-rzUyPU/S7rwUflMyLc1ETDeBj0NRuHKKAcvukozwhshr6g6c5d8zh4c2gQjY2bZ0dXeGLWc1PF174P2tVvKhfg==",
+      "license": "ISC",
+      "engines": {
+        "node": ">=12"
+      }
+    },
+    "node_modules/d3-force": {
+      "version": "3.0.0",
+      "resolved": "https://registry.npmjs.org/d3-force/-/d3-force-3.0.0.tgz",
+      "integrity": "sha512-zxV/SsA+U4yte8051P4ECydjD/S+qeYtnaIyAs9tgHCqfguma/aAQDjo85A9Z6EKhBirHRJHXIgJUlffT4wdLg==",
+      "license": "ISC",
+      "dependencies": {
+        "d3-dispatch": "1 - 3",
+        "d3-quadtree": "1 - 3",
+        "d3-timer": "1 - 3"
+      },
+      "engines": {
+        "node": ">=12"
+      }
+    },
+    "node_modules/d3-quadtree": {
+      "version": "3.0.1",
+      "resolved": "https://registry.npmjs.org/d3-quadtree/-/d3-quadtree-3.0.1.tgz",
+      "integrity": "sha512-04xDrxQTDTCFwP5H6hRhsRcb9xxv2RzkcsygFzmkSIOJy3PeRJP7sNk3VRIbKXcog561P9oU0/rVH6vDROAgUw==",
+      "license": "ISC",
+      "engines": {
+        "node": ">=12"
+      }
+    },
+    "node_modules/d3-timer": {
+      "version": "3.0.1",
+      "resolved": "https://registry.npmjs.org/d3-timer/-/d3-timer-3.0.1.tgz",
+      "integrity": "sha512-ndfJ/JxxMd3nw31uyKoY2naivF+r29V+Lc0svZxe1JvvIRmi8hUsrMvdOwgS1o6uBHmiz91geQ0ylPP0aj1VUA==",
+      "license": "ISC",
+      "engines": {
+        "node": ">=12"
+      }
+    },
     "node_modules/debug": {
       "version": "4.4.3",
       "resolved": "https://registry.npmjs.org/debug/-/debug-4.4.3.tgz",
@@ -3410,6 +3711,23 @@
         "typescript": "^5.7.0"
       }
     },
+    "plugins/graph-viewer/mcp": {
+      "name": "@maxy/graph-viewer",
+      "version": "0.1.0",
+      "dependencies": {
+        "@modelcontextprotocol/sdk": "^1.12.1",
+        "@napi-rs/canvas": "^0.1.56",
+        "d3-force": "^3.0.0",
+        "neo4j-driver": "^5.28.1",
+        "zod": "^3.23.0"
+      },
+      "devDependencies": {
+        "@types/d3-force": "^3.0.10",
+        "@types/node": "^22.0.0",
+        "typescript": "^5.7.0",
+        "vitest": "^4.1.2"
+      }
+    },
     "plugins/memory/mcp": {
       "name": "@maxy/memory",
       "version": "0.1.0",