@rubytech/create-maxy-code 0.1.125 → 0.1.126

package/dist/index.js

@@ -1171,7 +1171,17 @@ function installNeo4j() {
         const neo4jDataDir = resolve(process.env.HOME ?? "/root", BRAND.configDir, "neo4j-data");
         mkdirSync(neo4jDataDir, { recursive: true });
         shell("neo4j-admin", ["dbms", "set-initial-password", "--", password], { redact: true });
-        console.log("  Neo4j installed via Homebrew. Password stored securely.");
+        // Start Neo4j under brew's launchd supervision. Linux path starts the
+        // service via systemd a few lines below; without this start the darwin
+        // brand server binds successfully but every Cypher write fails with
+        // "Failed to connect to server" because nothing is listening on 7687.
+        // `brew services start` is idempotent — if already running it no-ops,
+        // and the LaunchAgent persists across reboots.
+        const brewStart = spawnSync("brew", ["services", "start", "neo4j"], { stdio: "inherit" });
+        if (brewStart.status !== 0) {
+            throw new Error(`brew services start neo4j failed (exit ${brewStart.status}) — Neo4j must be running before the brand server starts or all graph writes will fail`);
+        }
+        console.log("  Neo4j installed and started via Homebrew launchd. Password stored securely.");
         return;
     }
     // Neo4j 5.x supports Java 17 and 21. Debian Bookworm ships 17, Trixie ships 21.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rubytech/create-maxy-code",
-  "version": "0.1.125",
+  "version": "0.1.126",
   "description": "Install Maxy — AI for Productive People",
   "bin": {
     "create-maxy-code": "./dist/index.js"
@@ -13,7 +13,7 @@
     "build": "tsc",
     "bundle": "node scripts/bundle.js",
     "test": "npm run build && node --test 'dist/__tests__/*.test.js'",
-    "prepublishOnly": "bash ../../platform/scripts/verify-skill-tool-surface.sh && node ../../platform/scripts/check-no-task-id-leaks.mjs && node ../../platform/scripts/check-no-esm-require.mjs && node ../../platform/scripts/check-skill-load-coverage.mjs && node ../../platform/ui/scripts/check-route-wiring.mjs && node ../../platform/ui/scripts/check-edge-admin-routes.mjs && npm run build && node --test 'dist/__tests__/*.test.js' && chmod +x dist/index.js && npm run bundle && bash ../../platform/scripts/smoke-boot-services.sh && node ../../platform/ui/scripts/check-bundle-node-imports.mjs --dir=./payload/server/public/assets"
+    "prepublishOnly": "bash ../../platform/scripts/verify-skill-tool-surface.sh && node ../../platform/scripts/check-plugin-tools-mcp-consistency.mjs && node ../../platform/scripts/check-no-task-id-leaks.mjs && node ../../platform/scripts/check-no-esm-require.mjs && node ../../platform/scripts/check-skill-load-coverage.mjs && node ../../platform/ui/scripts/check-route-wiring.mjs && node ../../platform/ui/scripts/check-edge-admin-routes.mjs && npm run build && node --test 'dist/__tests__/*.test.js' && chmod +x dist/index.js && npm run bundle && bash ../../platform/scripts/smoke-boot-services.sh && node ../../platform/ui/scripts/check-bundle-node-imports.mjs --dir=./payload/server/public/assets"
   },
   "files": [
     "dist",

package/payload/platform/lib/graph-style/dist/index.d.ts

@@ -0,0 +1,78 @@
+/**
+ * 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 declare const GRAPH_LABEL_COLOURS: Record<string, string>;
+export declare const FALLBACK_LABEL_COLOUR = "#94A3B8";
+export declare const ALL_GRAPH_LABELS: readonly string[];
+/**
+ * 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 declare function pickDisplayLabel(labels: readonly string[]): string | null;
+export declare function colourForLabel(label: string): string;
+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 declare function resolveNodeColour(labels: readonly string[]): ResolvedNodeColour;
+/**
+ * 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>;
+}
+/**
+ * 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 declare function formatRunTimestamp(iso: string): string | null;
+/** HH:mm:ss from an ISO 8601 prefix. Same tz-stable contract. */
+export declare function formatMessageTimestamp(iso: string): string | null;
+/**
+ * 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 declare function pickShortLabel(node: GraphNodeLike): string;
+/**
+ * Untruncated sibling of pickShortLabel. Used by side-panel headings and
+ * tooltips where the 24-char canvas-overlap cap does not apply.
+ */
+export declare function pickDisplayName(node: GraphNodeLike): string;
+//# sourceMappingURL=index.d.ts.map

package/payload/platform/lib/graph-style/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CA4EtD,CAAA;AAED,eAAO,MAAM,qBAAqB,YAAY,CAAA;AAE9C,eAAO,MAAM,gBAAgB,EAAE,SAAS,MAAM,EAE7C,CAAA;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,GAAG,IAAI,CAOzE;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED,MAAM,WAAW,kBAAkB;IACjC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,MAAM,EAAE,MAAM,CAAA;IACd,eAAe,EAAE,MAAM,CAAA;CACxB;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,GAAG,kBAAkB,CAU/E;AASD;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAA;IACV,MAAM,EAAE,MAAM,EAAE,CAAA;IAChB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACpC;AAKD;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAI7D;AAED,iEAAiE;AACjE,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAIjE;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,aAAa,GAAG,MAAM,CAgE1D;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,aAAa,GAAG,MAAM,CAuC3D"}

package/payload/platform/lib/graph-style/dist/index.js

@@ -0,0 +1,296 @@
+"use strict";
+/**
+ * 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)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ALL_GRAPH_LABELS = exports.FALLBACK_LABEL_COLOUR = exports.GRAPH_LABEL_COLOURS = void 0;
+exports.pickDisplayLabel = pickDisplayLabel;
+exports.colourForLabel = colourForLabel;
+exports.resolveNodeColour = resolveNodeColour;
+exports.formatRunTimestamp = formatRunTimestamp;
+exports.formatMessageTimestamp = formatMessageTimestamp;
+exports.pickShortLabel = pickShortLabel;
+exports.pickDisplayName = pickDisplayName;
+/**
+ * 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.
+ */
+exports.GRAPH_LABEL_COLOURS = {
+    // 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',
+};
+exports.FALLBACK_LABEL_COLOUR = '#94A3B8';
+exports.ALL_GRAPH_LABELS = Object.freeze(Object.keys(exports.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.
+ */
+function pickDisplayLabel(labels) {
+    for (let i = 1; i < labels.length; i++) {
+        if (Object.prototype.hasOwnProperty.call(exports.GRAPH_LABEL_COLOURS, labels[i])) {
+            return labels[i];
+        }
+    }
+    return labels[0] ?? null;
+}
+function colourForLabel(label) {
+    return exports.GRAPH_LABEL_COLOURS[label] ?? exports.FALLBACK_LABEL_COLOUR;
+}
+/**
+ * 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.
+ */
+function resolveNodeColour(labels) {
+    const displayLabel = pickDisplayLabel(labels);
+    const colour = displayLabel ? colourForLabel(displayLabel) : exports.FALLBACK_LABEL_COLOUR;
+    let driftCandidates = 0;
+    for (let i = 1; i < labels.length; i++) {
+        if (Object.prototype.hasOwnProperty.call(exports.GRAPH_LABEL_COLOURS, labels[i])) {
+            driftCandidates++;
+        }
+    }
+    return { displayLabel, colour, driftCandidates };
+}
+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.
+ */
+function formatRunTimestamp(iso) {
+    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. */
+function formatMessageTimestamp(iso) {
+    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.
+ */
+function pickShortLabel(node) {
+    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.
+ */
+function pickDisplayName(node) {
+    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 ?? '…';
+}
+//# sourceMappingURL=index.js.map

package/payload/platform/lib/graph-style/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/payload/platform/lib/graph-style/src/__tests__/parity.test.ts

@@ -0,0 +1,114 @@
+/**
+ * Parity gate for the shared graph-style lib. Asserts the small set of
+ * load-bearing fixtures every UI and plugin caller relies on. Richer
+ * coverage lives in the UI's existing tests under
+ * platform/ui/app/lib/__tests__/graph-labels.test.ts and
+ * platform/ui/app/graph/__tests__/*; those tests now exercise the
+ * re-exported symbols and pass unchanged if extraction was faithful.
+ */
+
+import { describe, it, expect } from "vitest";
+import {
+  GRAPH_LABEL_COLOURS,
+  FALLBACK_LABEL_COLOUR,
+  pickDisplayLabel,
+  resolveNodeColour,
+  pickShortLabel,
+  pickDisplayName,
+} from "../index.js";
+
+describe("palette invariants", () => {
+  it("registers every label family with a hex colour", () => {
+    for (const [label, colour] of Object.entries(GRAPH_LABEL_COLOURS)) {
+      expect(colour, `${label} colour`).toMatch(/^#[0-9A-Fa-f]{6}$/);
+    }
+  });
+
+  it("FALLBACK_LABEL_COLOUR is a hex", () => {
+    expect(FALLBACK_LABEL_COLOUR).toMatch(/^#[0-9A-Fa-f]{6}$/);
+  });
+
+  it("UserMessage and Preference deliberately share a hue (Person-family cue)", () => {
+    expect(GRAPH_LABEL_COLOURS.UserMessage).toBe(GRAPH_LABEL_COLOURS.Preference);
+  });
+});
+
+describe("pickDisplayLabel", () => {
+  it("returns the first registered sublabel", () => {
+    expect(pickDisplayLabel(["Conversation", "AdminConversation"])).toBe(
+      "AdminConversation",
+    );
+  });
+
+  it("falls back to labels[0] when no sublabel is registered", () => {
+    expect(pickDisplayLabel(["Person", "UnregisteredSublabel"])).toBe("Person");
+  });
+
+  it("returns null on empty labels", () => {
+    expect(pickDisplayLabel([])).toBeNull();
+  });
+});
+
+describe("resolveNodeColour", () => {
+  it("counts drift candidates", () => {
+    const r = resolveNodeColour(["Conversation", "PublicConversation", "AssistantMessage"]);
+    expect(r.driftCandidates).toBe(2);
+    expect(r.colour).toBe(GRAPH_LABEL_COLOURS.PublicConversation);
+  });
+});
+
+describe("pickShortLabel", () => {
+  it("Person composes from given+family", () => {
+    expect(
+      pickShortLabel({
+        id: "x",
+        labels: ["Person"],
+        properties: { givenName: "Dan", familyName: "Brett" },
+      }),
+    ).toBe("Dan Brett");
+  });
+
+  it("Message renders role + HH:mm:ss", () => {
+    expect(
+      pickShortLabel({
+        id: "x",
+        labels: ["Message"],
+        properties: { role: "user", createdAt: "2026-05-25T14:33:42Z" },
+      }),
+    ).toBe("user 14:33:42");
+  });
+
+  it("Conversation falls back to Conv <id8>", () => {
+    expect(
+      pickShortLabel({
+        id: "x",
+        labels: ["Conversation"],
+        properties: { conversationId: "abcdef0123456789" },
+      }),
+    ).toBe("Conv abcdef01");
+  });
+
+  it("truncates over-cap labels to 24 chars + ellipsis", () => {
+    const longName = "This is a very long string that exceeds twenty-four chars";
+    const out = pickShortLabel({
+      id: "x",
+      labels: ["LocalBusiness"],
+      properties: { name: longName },
+    });
+    expect(out.length).toBeLessThanOrEqual(25); // 24 + '…'
+    expect(out.endsWith("…")).toBe(true);
+  });
+});
+
+describe("pickDisplayName", () => {
+  it("untruncated counterpart to pickShortLabel", () => {
+    const longName = "This is a very long string that exceeds twenty-four chars";
+    expect(
+      pickDisplayName({
+        id: "x",
+        labels: ["LocalBusiness"],
+        properties: { name: longName },
+      }),
+    ).toBe(longName);
+  });
+});