@swarmvaultai/engine 1.1.0 → 1.3.0

package/dist/index.js

@@ -7073,6 +7073,322 @@ function enrichGraph(graph, manifests, analyses, extraSimilarityEdges = [], opti
   };
 }
 
+// src/graph-share.ts
+function displayVaultName(value) {
+  const trimmed = value?.trim();
+  return trimmed ? trimmed : "this vault";
+}
+function sortedFallbackHubs(graph) {
+  return graph.nodes.filter((node) => node.type !== "source").sort(
+    (left, right) => (right.degree ?? 0) - (left.degree ?? 0) || (right.bridgeScore ?? 0) - (left.bridgeScore ?? 0) || left.label.localeCompare(right.label)
+  ).slice(0, 5);
+}
+function graphNodeMap(graph) {
+  return new Map(graph.nodes.map((node) => [node.id, node]));
+}
+function compactJoin(values, fallback) {
+  const filtered = values.filter(Boolean);
+  if (!filtered.length) {
+    return fallback;
+  }
+  if (filtered.length === 1) {
+    return filtered[0] ?? fallback;
+  }
+  if (filtered.length === 2) {
+    return `${filtered[0]} and ${filtered[1]}`;
+  }
+  return `${filtered.slice(0, -1).join(", ")}, and ${filtered[filtered.length - 1]}`;
+}
+function buildShortPost(input) {
+  const topHubLine = input.topHubs.length ? `Top hubs: ${compactJoin(
+    input.topHubs.slice(0, 3).map((node) => node.label),
+    "still emerging"
+  )}.` : "Top hubs are still emerging.";
+  const surprise = input.surprisingConnections[0];
+  const surpriseLine = surprise ? `Most surprising link: ${surprise.sourceLabel} ${surprise.relation} ${surprise.targetLabel}.` : "The graph is ready for its first surprising connection.";
+  return [
+    `I scanned ${input.vaultName} with SwarmVault: ${input.overview.sources} sources -> ${input.overview.pages} wiki pages, ${input.overview.nodes} graph nodes, ${input.overview.edges} edges.`,
+    topHubLine,
+    surpriseLine,
+    "Everything stays local. Try: npm install -g @swarmvaultai/cli && swarmvault scan ./your-repo"
+  ].join("\n");
+}
+function escapeXml(value) {
+  return String(value ?? "").replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll('"', "&quot;").replaceAll("'", "&apos;");
+}
+function clipText(value, maxLength) {
+  const normalized = value.replaceAll("\n", " ").replaceAll("\r", " ").trim();
+  if (normalized.length <= maxLength) {
+    return normalized;
+  }
+  return `${normalized.slice(0, Math.max(0, maxLength - 3)).trimEnd()}...`;
+}
+function svgText(input) {
+  const attrs = [
+    `x="${input.x}"`,
+    `y="${input.y}"`,
+    `font-size="${input.size}"`,
+    `fill="${input.fill ?? "#f8fafc"}"`,
+    `font-weight="${input.weight ?? 500}"`,
+    `text-anchor="${input.anchor ?? "start"}"`,
+    input.opacity === void 0 ? "" : `opacity="${input.opacity}"`
+  ].filter(Boolean);
+  return `  <text ${attrs.join(" ")}>${escapeXml(input.text)}</text>`;
+}
+function svgStatCard(input) {
+  return [
+    `  <rect x="${input.x}" y="${input.y}" width="168" height="92" rx="14" fill="#111827" stroke="#334155" />`,
+    svgText({ x: input.x + 20, y: input.y + 36, text: String(input.value), size: 30, fill: "#ecfeff", weight: 800 }),
+    svgText({ x: input.x + 20, y: input.y + 66, text: input.label, size: 16, fill: "#94a3b8", weight: 600 })
+  ];
+}
+function svgListLines(input) {
+  const items = input.items.length ? input.items.slice(0, input.maxItems) : [input.empty];
+  const lines = [svgText({ x: input.x, y: input.y, text: input.title, size: 19, fill: "#a7f3d0", weight: 800 })];
+  for (const [index, item] of items.entries()) {
+    lines.push(
+      svgText({ x: input.x, y: input.y + 38 + index * 30, text: `- ${clipText(item, 58)}`, size: 19, fill: "#e2e8f0", weight: 600 })
+    );
+  }
+  return lines;
+}
+function buildGraphShareArtifact(input) {
+  const { graph, report } = input;
+  const vaultName = displayVaultName(input.vaultName);
+  const nodesById = graphNodeMap(graph);
+  const fallbackHubs = sortedFallbackHubs(graph);
+  const reportHubs = report?.godNodes.map((node) => {
+    const graphNode = nodesById.get(node.nodeId);
+    return {
+      nodeId: node.nodeId,
+      label: node.label ?? graphNode?.label ?? node.nodeId,
+      degree: node.degree ?? graphNode?.degree
+    };
+  }) ?? [];
+  const fallbackHubHighlights = fallbackHubs.map((node) => ({
+    nodeId: node.id,
+    label: node.label,
+    degree: node.degree
+  }));
+  const topHubs = (reportHubs.length ? reportHubs : fallbackHubHighlights).slice(0, 5);
+  const reportBridgeNodes = report?.bridgeNodes.map((node) => {
+    const graphNode = nodesById.get(node.nodeId);
+    return {
+      nodeId: node.nodeId,
+      label: node.label ?? graphNode?.label ?? node.nodeId,
+      bridgeScore: node.bridgeScore ?? graphNode?.bridgeScore
+    };
+  }) ?? [];
+  const fallbackBridgeNodes = fallbackHubs.map((node) => ({
+    nodeId: node.id,
+    label: node.label,
+    bridgeScore: node.bridgeScore
+  }));
+  const bridgeNodes = (reportBridgeNodes.length ? reportBridgeNodes : fallbackBridgeNodes).slice(0, 3).filter((node) => node.label);
+  const surprisingConnections = (report?.surprisingConnections ?? []).slice(0, 3).map((connection) => {
+    const source = nodesById.get(connection.sourceNodeId);
+    const target = nodesById.get(connection.targetNodeId);
+    return {
+      sourceLabel: source?.label ?? connection.sourceNodeId,
+      targetLabel: target?.label ?? connection.targetNodeId,
+      relation: connection.relation,
+      why: truncate(connection.why || connection.explanation || "Cross-community connection", 180)
+    };
+  });
+  const overview = {
+    sources: graph.sources.length,
+    nodes: report?.overview.nodes ?? graph.nodes.length,
+    edges: report?.overview.edges ?? graph.edges.length,
+    pages: report?.overview.pages ?? graph.pages.length,
+    communities: report?.overview.communities ?? graph.communities?.length ?? 0
+  };
+  const firstPartyOverview = report?.firstPartyOverview ?? {
+    nodes: graph.nodes.filter((node) => node.sourceClass === "first_party").length,
+    edges: graph.edges.length,
+    pages: graph.pages.filter((page) => page.sourceClass === "first_party").length,
+    communities: graph.communities?.length ?? 0
+  };
+  const relatedNodeIds = uniqueBy([...topHubs.map((node) => node.nodeId), ...bridgeNodes.map((node) => node.nodeId)], (value) => value);
+  const relatedPageIds = uniqueBy(
+    relatedNodeIds.map((nodeId) => nodesById.get(nodeId)?.pageId).filter((pageId) => Boolean(pageId)),
+    (value) => value
+  );
+  const relatedSourceIds = uniqueBy(
+    [...graph.sources.map((source) => source.sourceId), ...relatedNodeIds.flatMap((nodeId) => nodesById.get(nodeId)?.sourceIds ?? [])],
+    (value) => value
+  );
+  const knowledgeGaps = report?.knowledgeGaps?.warnings?.length ? report.knowledgeGaps.warnings.slice(0, 3) : report?.warnings?.length ? report.warnings.slice(0, 3) : [];
+  const tagline = `A local-first map of ${vaultName}: ${overview.sources} sources compiled into ${overview.nodes} graph nodes and ${overview.pages} wiki pages.`;
+  const artifact = {
+    generatedAt: (/* @__PURE__ */ new Date()).toISOString(),
+    vaultName,
+    tagline,
+    overview,
+    firstPartyOverview,
+    highlights: {
+      topHubs,
+      bridgeNodes,
+      surprisingConnections,
+      suggestedQuestions: (report?.suggestedQuestions ?? []).slice(0, 5)
+    },
+    knowledgeGaps,
+    shortPost: "",
+    relatedNodeIds,
+    relatedPageIds,
+    relatedSourceIds
+  };
+  return {
+    ...artifact,
+    shortPost: buildShortPost({
+      vaultName,
+      overview,
+      topHubs,
+      surprisingConnections
+    })
+  };
+}
+function renderGraphShareMarkdown(artifact) {
+  const lines = [
+    "# SwarmVault Share Card",
+    "",
+    `> ${artifact.tagline}`,
+    "",
+    "## Snapshot",
+    "",
+    `- Sources: ${artifact.overview.sources}`,
+    `- Wiki pages: ${artifact.overview.pages}`,
+    `- Graph nodes: ${artifact.overview.nodes}`,
+    `- Graph edges: ${artifact.overview.edges}`,
+    `- Communities: ${artifact.overview.communities}`,
+    `- First-party focus: ${artifact.firstPartyOverview.nodes} nodes, ${artifact.firstPartyOverview.edges} edges, ${artifact.firstPartyOverview.pages} pages`,
+    "",
+    "## Highlights",
+    "",
+    artifact.highlights.topHubs.length ? `- Top hubs: ${compactJoin(
+      artifact.highlights.topHubs.slice(0, 5).map((node) => node.degree ? `${node.label} (${node.degree})` : node.label),
+      "none yet"
+    )}` : "- Top hubs: none yet",
+    artifact.highlights.bridgeNodes.length ? `- Bridge nodes: ${compactJoin(
+      artifact.highlights.bridgeNodes.slice(0, 3).map((node) => node.label),
+      "none yet"
+    )}` : "- Bridge nodes: none yet",
+    ...artifact.highlights.surprisingConnections.length ? artifact.highlights.surprisingConnections.map(
+      (connection) => `- Surprising link: ${connection.sourceLabel} ${connection.relation} ${connection.targetLabel}. ${connection.why}`
+    ) : ["- Surprising link: not enough cross-community evidence yet"],
+    "",
+    "## Ask Next",
+    "",
+    ...artifact.highlights.suggestedQuestions.length ? artifact.highlights.suggestedQuestions.map((question) => `- ${question}`) : ["- Add more sources, run `swarmvault compile`, then ask the graph what changed."],
+    "",
+    "## Share Post",
+    "",
+    "```text",
+    artifact.shortPost,
+    "```",
+    "",
+    "## Reproduce",
+    "",
+    "```bash",
+    "npm install -g @swarmvaultai/cli",
+    "swarmvault scan ./your-repo",
+    "swarmvault graph share --post",
+    "```",
+    ""
+  ];
+  if (artifact.knowledgeGaps.length) {
+    lines.splice(
+      lines.indexOf("## Ask Next"),
+      0,
+      "## Gaps To Strengthen",
+      "",
+      ...artifact.knowledgeGaps.map((warning) => `- ${warning}`),
+      ""
+    );
+  }
+  return `${lines.join("\n")}`;
+}
+function renderGraphShareSvg(artifact) {
+  const topHubs = artifact.highlights.topHubs.map((node) => node.degree ? `${node.label} (${node.degree})` : node.label);
+  const bridges = artifact.highlights.bridgeNodes.map((node) => node.label);
+  const surprise = artifact.highlights.surprisingConnections[0];
+  const surpriseLine = surprise ? `${surprise.sourceLabel} ${surprise.relation} ${surprise.targetLabel}` : "Add more sources to reveal the first surprising link";
+  const generated = new Date(artifact.generatedAt);
+  const generatedLabel = Number.isNaN(generated.getTime()) ? artifact.generatedAt : generated.toISOString().slice(0, 10);
+  const lines = [
+    '<?xml version="1.0" encoding="UTF-8"?>',
+    `<svg xmlns="http://www.w3.org/2000/svg" width="1200" height="630" viewBox="0 0 1200 630" role="img" aria-labelledby="title desc">`,
+    `  <title>SwarmVault share card for ${escapeXml(artifact.vaultName)}</title>`,
+    `  <desc>${escapeXml(artifact.tagline)}</desc>`,
+    "  <defs>",
+    '    <linearGradient id="background" x1="0" y1="0" x2="1" y2="1">',
+    '      <stop offset="0%" stop-color="#020617" />',
+    '      <stop offset="58%" stop-color="#0f172a" />',
+    '      <stop offset="100%" stop-color="#063f37" />',
+    "    </linearGradient>",
+    '    <linearGradient id="accent" x1="0" y1="0" x2="1" y2="0">',
+    '      <stop offset="0%" stop-color="#22c55e" />',
+    '      <stop offset="100%" stop-color="#06b6d4" />',
+    "    </linearGradient>",
+    "  </defs>",
+    '  <rect width="1200" height="630" fill="url(#background)" />',
+    '  <rect x="34" y="34" width="1132" height="562" rx="28" fill="#020617" opacity="0.72" stroke="#1f2937" />',
+    '  <path d="M92 512 C214 386 314 456 438 326 C540 218 648 284 746 194 C860 88 1004 152 1110 84" fill="none" stroke="#22c55e" stroke-width="4" opacity="0.35" />',
+    '  <circle cx="92" cy="512" r="9" fill="#22c55e" />',
+    '  <circle cx="438" cy="326" r="10" fill="#06b6d4" />',
+    '  <circle cx="746" cy="194" r="10" fill="#a7f3d0" />',
+    '  <circle cx="1110" cy="84" r="9" fill="#22c55e" />',
+    svgText({ x: 78, y: 96, text: "SwarmVault", size: 28, fill: "#86efac", weight: 900 }),
+    svgText({ x: 78, y: 152, text: clipText(artifact.vaultName, 42), size: 54, fill: "#f8fafc", weight: 900 }),
+    svgText({ x: 78, y: 196, text: clipText(artifact.tagline, 86), size: 22, fill: "#cbd5e1", weight: 600 }),
+    ...svgStatCard({ x: 78, y: 242, label: "Sources", value: artifact.overview.sources }),
+    ...svgStatCard({ x: 270, y: 242, label: "Wiki pages", value: artifact.overview.pages }),
+    ...svgStatCard({ x: 462, y: 242, label: "Graph nodes", value: artifact.overview.nodes }),
+    ...svgStatCard({ x: 654, y: 242, label: "Edges", value: artifact.overview.edges }),
+    `  <rect x="870" y="240" width="246" height="94" rx="18" fill="url(#accent)" opacity="0.95" />`,
+    svgText({ x: 993, y: 278, text: "Local-first", size: 22, fill: "#052e16", weight: 900, anchor: "middle" }),
+    svgText({ x: 993, y: 307, text: "no API keys required", size: 18, fill: "#064e3b", weight: 800, anchor: "middle" }),
+    ...svgListLines({
+      x: 82,
+      y: 398,
+      title: "Top hubs",
+      items: topHubs,
+      empty: "Still emerging",
+      maxItems: 3
+    }),
+    ...svgListLines({
+      x: 470,
+      y: 398,
+      title: "Bridge nodes",
+      items: bridges,
+      empty: "Still emerging",
+      maxItems: 3
+    }),
+    svgText({ x: 820, y: 398, text: "Surprising link", size: 19, fill: "#a7f3d0", weight: 800 }),
+    svgText({ x: 820, y: 436, text: clipText(surpriseLine, 40), size: 21, fill: "#e2e8f0", weight: 800 }),
+    svgText({
+      x: 820,
+      y: 470,
+      text: clipText(surprise?.why ?? "Run compile again after adding more sources.", 44),
+      size: 17,
+      fill: "#94a3b8",
+      weight: 600
+    }),
+    `  <rect x="78" y="536" width="744" height="42" rx="12" fill="#0f172a" stroke="#1e293b" />`,
+    svgText({
+      x: 100,
+      y: 564,
+      text: "npm install -g @swarmvaultai/cli && swarmvault scan ./your-repo",
+      size: 18,
+      fill: "#d1fae5",
+      weight: 800
+    }),
+    svgText({ x: 1116, y: 564, text: `Generated ${generatedLabel}`, size: 16, fill: "#94a3b8", weight: 600, anchor: "end" }),
+    "</svg>",
+    ""
+  ];
+  return lines.join("\n");
+}
+
 // src/graph-query-core.ts
 var NODE_TYPE_PRIORITY = {
   concept: 6,
@@ -8907,6 +9223,65 @@ function buildGraphReportPage(input) {
     content: matter2.stringify(body, frontmatter)
   };
 }
+function buildGraphSharePage(input) {
+  const pageId = "graph:share-card";
+  const pathValue = "graph/share-card.md";
+  const artifact = input.artifact ?? buildGraphShareArtifact({
+    graph: input.graph,
+    report: input.report,
+    vaultName: input.vaultName
+  });
+  const frontmatter = {
+    page_id: pageId,
+    kind: "graph_report",
+    cssclasses: cssclassesFor("graph_report"),
+    title: "Share Card",
+    tags: ["graph", "share"],
+    source_ids: artifact.relatedSourceIds,
+    project_ids: [],
+    node_ids: artifact.relatedNodeIds,
+    freshness: "fresh",
+    status: input.metadata.status,
+    confidence: input.metadata.confidence,
+    created_at: input.metadata.createdAt,
+    updated_at: input.metadata.updatedAt,
+    compiled_from: input.metadata.compiledFrom,
+    managed_by: input.metadata.managedBy,
+    backlinks: [],
+    schema_hash: input.schemaHash,
+    source_hashes: {},
+    source_semantic_hashes: {},
+    related_page_ids: artifact.relatedPageIds,
+    related_node_ids: artifact.relatedNodeIds,
+    related_source_ids: artifact.relatedSourceIds
+  };
+  return {
+    page: {
+      id: pageId,
+      path: pathValue,
+      title: "Share Card",
+      kind: "graph_report",
+      sourceIds: artifact.relatedSourceIds,
+      projectIds: [],
+      nodeIds: artifact.relatedNodeIds,
+      freshness: "fresh",
+      status: input.metadata.status,
+      confidence: input.metadata.confidence,
+      backlinks: [],
+      schemaHash: input.schemaHash,
+      sourceHashes: {},
+      sourceSemanticHashes: {},
+      relatedPageIds: artifact.relatedPageIds,
+      relatedNodeIds: artifact.relatedNodeIds,
+      relatedSourceIds: artifact.relatedSourceIds,
+      createdAt: input.metadata.createdAt,
+      updatedAt: input.metadata.updatedAt,
+      compiledFrom: input.metadata.compiledFrom,
+      managedBy: input.metadata.managedBy
+    },
+    content: matter2.stringify(renderGraphShareMarkdown(artifact), frontmatter)
+  };
+}
 function buildCommunitySummaryPage(input) {
   const pageId = `graph:${input.community.id}`;
   const pathValue = communityPagePath(input.community.id);
@@ -20099,7 +20474,7 @@ async function runDeepLint(rootDir, structuralFindings, options = {}) {
 
 // src/output-artifacts.ts
 import { z as z6 } from "zod";
-function escapeXml(value) {
+function escapeXml2(value) {
   return value.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&apos;");
 }
 function clampNumber(value, min, max) {
@@ -20170,7 +20545,7 @@ function renderChartSvg(spec) {
     const y = projectY(value);
     return [
       `<line x1="${margin.left}" y1="${y}" x2="${width - margin.right}" y2="${y}" stroke="#dbe4ec" stroke-width="1" />`,
-      `<text x="${margin.left - 16}" y="${y + 4}" text-anchor="end" font-size="14" fill="#475569">${escapeXml(value.toFixed(0))}</text>`
+      `<text x="${margin.left - 16}" y="${y + 4}" text-anchor="end" font-size="14" fill="#475569">${escapeXml2(value.toFixed(0))}</text>`
     ].join("");
   }).join("");
   const bars = spec.kind === "bar" ? points.map((point) => {
@@ -20178,7 +20553,7 @@ function renderChartSvg(spec) {
     const barHeight = Math.max(8, Math.abs(zeroY - point.y));
     return [
       `<rect x="${point.centerX - barWidth / 2}" y="${top}" width="${barWidth}" height="${barHeight}" rx="12" fill="#0ea5e9" opacity="0.92" />`,
-      `<text x="${point.centerX}" y="${top - 10}" text-anchor="middle" font-size="13" fill="#0f172a">${escapeXml(
+      `<text x="${point.centerX}" y="${top - 10}" text-anchor="middle" font-size="13" fill="#0f172a">${escapeXml2(
         point.value.toFixed(0)
       )}</text>`
     ].join("");
@@ -20188,33 +20563,33 @@ function renderChartSvg(spec) {
     `<path d="${linePath}" fill="none" stroke="#0ea5e9" stroke-width="5" stroke-linecap="round" stroke-linejoin="round" />`,
     ...points.map(
       (point) => `<circle cx="${point.centerX}" cy="${point.y}" r="8" fill="#f8fafc" stroke="#0ea5e9" stroke-width="4" />
-               <text x="${point.centerX}" y="${point.y - 18}" text-anchor="middle" font-size="13" fill="#0f172a">${escapeXml(
+               <text x="${point.centerX}" y="${point.y - 18}" text-anchor="middle" font-size="13" fill="#0f172a">${escapeXml2(
         point.value.toFixed(0)
       )}</text>`
     )
   ].join("") : "";
   const labels = points.map(
-    (point) => `<text x="${point.centerX}" y="${height - margin.bottom + 28}" text-anchor="middle" font-size="14" fill="#334155">${escapeXml(
+    (point) => `<text x="${point.centerX}" y="${height - margin.bottom + 28}" text-anchor="middle" font-size="14" fill="#334155">${escapeXml2(
       point.label
     )}</text>`
   ).join("");
   const notes = (spec.notes ?? []).map(
-    (note, index) => `<text x="${margin.left}" y="${height - 26 - index * 18}" font-size="13" fill="#475569">${escapeXml(note)}</text>`
+    (note, index) => `<text x="${margin.left}" y="${height - 26 - index * 18}" font-size="13" fill="#475569">${escapeXml2(note)}</text>`
   ).join("");
   const svg = [
-    `<svg xmlns="http://www.w3.org/2000/svg" width="${width}" height="${height}" viewBox="0 0 ${width} ${height}" role="img" aria-label="${escapeXml(spec.title)}">`,
+    `<svg xmlns="http://www.w3.org/2000/svg" width="${width}" height="${height}" viewBox="0 0 ${width} ${height}" role="img" aria-label="${escapeXml2(spec.title)}">`,
     '<rect width="100%" height="100%" fill="#f8fafc" />',
-    `<text x="${margin.left}" y="56" font-size="34" font-weight="700" fill="#0f172a">${escapeXml(spec.title)}</text>`,
-    spec.subtitle ? `<text x="${margin.left}" y="86" font-size="18" fill="#475569">${escapeXml(spec.subtitle)}</text>` : "",
+    `<text x="${margin.left}" y="56" font-size="34" font-weight="700" fill="#0f172a">${escapeXml2(spec.title)}</text>`,
+    spec.subtitle ? `<text x="${margin.left}" y="86" font-size="18" fill="#475569">${escapeXml2(spec.subtitle)}</text>` : "",
     gridLines,
     `<line x1="${margin.left}" y1="${zeroY}" x2="${width - margin.right}" y2="${zeroY}" stroke="#0f172a" stroke-width="2" />`,
     `<line x1="${margin.left}" y1="${margin.top}" x2="${margin.left}" y2="${height - margin.bottom}" stroke="#0f172a" stroke-width="2" />`,
     bars,
     lineMarks,
     labels,
-    spec.xLabel ? `<text x="${margin.left + chartWidth / 2}" y="${height - 46}" text-anchor="middle" font-size="15" fill="#475569">${escapeXml(spec.xLabel)}</text>` : "",
-    spec.yLabel ? `<text x="34" y="${margin.top + chartHeight / 2}" text-anchor="middle" font-size="15" fill="#475569" transform="rotate(-90 34 ${margin.top + chartHeight / 2})">${escapeXml(spec.yLabel)}</text>` : "",
-    spec.seriesLabel ? `<text x="${width - margin.right}" y="56" text-anchor="end" font-size="15" fill="#475569">${escapeXml(spec.seriesLabel)}</text>` : "",
+    spec.xLabel ? `<text x="${margin.left + chartWidth / 2}" y="${height - 46}" text-anchor="middle" font-size="15" fill="#475569">${escapeXml2(spec.xLabel)}</text>` : "",
+    spec.yLabel ? `<text x="34" y="${margin.top + chartHeight / 2}" text-anchor="middle" font-size="15" fill="#475569" transform="rotate(-90 34 ${margin.top + chartHeight / 2})">${escapeXml2(spec.yLabel)}</text>` : "",
+    spec.seriesLabel ? `<text x="${width - margin.right}" y="56" text-anchor="end" font-size="15" fill="#475569">${escapeXml2(spec.seriesLabel)}</text>` : "",
     notes,
     "</svg>"
   ].filter(Boolean).join("");
@@ -20226,33 +20601,33 @@ function renderSceneSvg(spec) {
   const elements = spec.elements.map((element) => {
     const opacity = element.opacity === void 0 ? 1 : clampNumber(element.opacity, 0, 1);
     if (element.kind === "label") {
-      return `<text x="${element.x}" y="${element.y}" font-size="${clampNumber(element.fontSize ?? 28, 10, 72)}" fill="${escapeXml(
+      return `<text x="${element.x}" y="${element.y}" font-size="${clampNumber(element.fontSize ?? 28, 10, 72)}" fill="${escapeXml2(
         element.fill ?? "#0f172a"
-      )}" opacity="${opacity}" font-family="'Avenir Next', 'Segoe UI', sans-serif">${escapeXml(element.text ?? "")}</text>`;
+      )}" opacity="${opacity}" font-family="'Avenir Next', 'Segoe UI', sans-serif">${escapeXml2(element.text ?? "")}</text>`;
     }
     switch (element.shape) {
       case "circle":
-        return `<circle cx="${element.x}" cy="${element.y}" r="${Math.max(6, element.radius ?? 40)}" fill="${escapeXml(
+        return `<circle cx="${element.x}" cy="${element.y}" r="${Math.max(6, element.radius ?? 40)}" fill="${escapeXml2(
           element.fill ?? "#dbeafe"
-        )}" stroke="${escapeXml(element.stroke ?? "#0ea5e9")}" stroke-width="${Math.max(1, element.strokeWidth ?? 2)}" opacity="${opacity}" />`;
+        )}" stroke="${escapeXml2(element.stroke ?? "#0ea5e9")}" stroke-width="${Math.max(1, element.strokeWidth ?? 2)}" opacity="${opacity}" />`;
       case "line":
-        return `<line x1="${element.x}" y1="${element.y}" x2="${element.x + (element.width ?? 120)}" y2="${element.y + (element.height ?? 0)}" stroke="${escapeXml(element.stroke ?? "#475569")}" stroke-width="${Math.max(1, element.strokeWidth ?? 3)}" opacity="${opacity}" />`;
+        return `<line x1="${element.x}" y1="${element.y}" x2="${element.x + (element.width ?? 120)}" y2="${element.y + (element.height ?? 0)}" stroke="${escapeXml2(element.stroke ?? "#475569")}" stroke-width="${Math.max(1, element.strokeWidth ?? 3)}" opacity="${opacity}" />`;
       default:
         return `<rect x="${element.x}" y="${element.y}" width="${Math.max(8, element.width ?? 160)}" height="${Math.max(
           8,
           element.height ?? 120
-        )}" rx="22" fill="${escapeXml(element.fill ?? "#e2e8f0")}" stroke="${escapeXml(element.stroke ?? "#94a3b8")}" stroke-width="${Math.max(
+        )}" rx="22" fill="${escapeXml2(element.fill ?? "#e2e8f0")}" stroke="${escapeXml2(element.stroke ?? "#94a3b8")}" stroke-width="${Math.max(
           1,
           element.strokeWidth ?? 2
         )}" opacity="${opacity}" />`;
     }
   }).join("");
   const svg = [
-    `<svg xmlns="http://www.w3.org/2000/svg" width="${width}" height="${height}" viewBox="0 0 ${width} ${height}" role="img" aria-label="${escapeXml(
+    `<svg xmlns="http://www.w3.org/2000/svg" width="${width}" height="${height}" viewBox="0 0 ${width} ${height}" role="img" aria-label="${escapeXml2(
       spec.alt
     )}">`,
-    `<rect width="100%" height="100%" fill="${escapeXml(spec.background ?? "#f8fafc")}" />`,
-    `<text x="48" y="64" font-size="34" font-weight="700" fill="#0f172a">${escapeXml(spec.title)}</text>`,
+    `<rect width="100%" height="100%" fill="${escapeXml2(spec.background ?? "#f8fafc")}" />`,
+    `<text x="48" y="64" font-size="34" font-weight="700" fill="#0f172a">${escapeXml2(spec.title)}</text>`,
     elements,
     `</svg>`
   ].join("");
@@ -20263,12 +20638,12 @@ function renderRasterPosterSvg(input) {
   const height = clampNumber(input.height ?? 720, 320, 1200);
   const inset = 42;
   const svg = [
-    `<svg xmlns="http://www.w3.org/2000/svg" width="${width}" height="${height}" viewBox="0 0 ${width} ${height}" role="img" aria-label="${escapeXml(
+    `<svg xmlns="http://www.w3.org/2000/svg" width="${width}" height="${height}" viewBox="0 0 ${width} ${height}" role="img" aria-label="${escapeXml2(
       input.alt
     )}">`,
     '<rect width="100%" height="100%" fill="#f8fafc" />',
-    `<text x="${inset}" y="56" font-size="34" font-weight="700" fill="#0f172a">${escapeXml(input.title)}</text>`,
-    `<image href="${escapeXml(input.rasterFileName)}" x="${inset}" y="92" width="${width - inset * 2}" height="${height - 148}" preserveAspectRatio="xMidYMid meet" />`,
+    `<text x="${inset}" y="56" font-size="34" font-weight="700" fill="#0f172a">${escapeXml2(input.title)}</text>`,
+    `<image href="${escapeXml2(input.rasterFileName)}" x="${inset}" y="92" width="${width - inset * 2}" height="${height - 148}" preserveAspectRatio="xMidYMid meet" />`,
     `</svg>`
   ].join("");
   return { svg, width, height };
@@ -22641,9 +23016,31 @@ async function buildGraphOrientationPages(graph, paths, schemaHash, previousComp
       report
     })
   );
+  const shareArtifact = buildGraphShareArtifact({
+    graph,
+    report,
+    vaultName: path26.basename(paths.rootDir)
+  });
+  const shareRecord = await buildManagedGraphPage(
+    path26.join(paths.wikiDir, "graph", "share-card.md"),
+    {
+      managedBy: "system",
+      compiledFrom: uniqueStrings4(graph.pages.flatMap((page) => page.sourceIds)),
+      confidence: 1
+    },
+    (metadata) => buildGraphSharePage({
+      graph,
+      schemaHash,
+      metadata,
+      artifact: shareArtifact,
+      report,
+      vaultName: path26.basename(paths.rootDir)
+    })
+  );
   return {
-    records: [reportRecord, ...communityRecords],
-    report
+    records: [reportRecord, shareRecord, ...communityRecords],
+    report,
+    shareSvg: renderGraphShareSvg(shareArtifact)
   };
 }
 async function writePage(wikiDir, relativePath, content, changedPages) {
@@ -23264,6 +23661,7 @@ async function syncVaultArtifacts(rootDir, input) {
   }
   await writeJsonFile(paths.graphPath, graph);
   await writeJsonFile(path26.join(paths.wikiDir, "graph", "report.json"), graphOrientation.report);
+  await writeFileIfChanged(path26.join(paths.wikiDir, "graph", "share-card.svg"), graphOrientation.shareSvg);
   await writeJsonFile(paths.codeIndexPath, input.codeIndex);
   await writeJsonFile(paths.compileStatePath, {
     generatedAt: graph.generatedAt,
@@ -23322,7 +23720,7 @@ async function refreshIndexesAndSearch(rootDir, pages) {
     compileState?.generatedAt,
     [],
     config
-  ) : { records: [], report: null };
+  ) : { records: [], report: null, shareSvg: "" };
   const dashboardRecords = currentGraph ? await buildDashboardRecords(
     config,
     paths,
@@ -23458,6 +23856,7 @@ async function refreshIndexesAndSearch(rootDir, pages) {
   }
   if (graphOrientation.report) {
     await writeJsonFile(path26.join(paths.wikiDir, "graph", "report.json"), graphOrientation.report);
+    await writeFileIfChanged(path26.join(paths.wikiDir, "graph", "share-card.svg"), graphOrientation.shareSvg);
   }
   const existingProjectIndexPaths = (await listFilesRecursive(paths.projectsDir)).filter((absolutePath) => absolutePath.endsWith(".md")).map((absolutePath) => toPosix(path26.relative(paths.wikiDir, absolutePath)));
   const allowedProjectIndexPaths = /* @__PURE__ */ new Set([
@@ -26615,7 +27014,7 @@ async function getWatchStatus(rootDir) {
 }
 
 // src/mcp.ts
-var SERVER_VERSION = "1.1.0";
+var SERVER_VERSION = "1.3.0";
 async function createMcpServer(rootDir) {
   const server = new McpServer({
     name: "swarmvault",
@@ -30072,6 +30471,7 @@ export {
   blastRadiusVault,
   bootstrapDemo,
   buildConfiguredRedactor,
+  buildGraphShareArtifact,
   buildRedactor,
   compileVault,
   computeDecayScore,
@@ -30147,6 +30547,8 @@ export {
   rejectApproval,
   reloadManagedSources,
   removeWatchedRoot,
+  renderGraphShareMarkdown,
+  renderGraphShareSvg,
   resetDecay,
   resolveConsolidationConfig,
   resolveDecayConfig,