@swarmvaultai/engine 0.7.27 → 0.7.29

package/dist/index.js

@@ -952,6 +952,37 @@ function loadVisNetworkJs() {
   }
   return _visNetworkJs;
 }
+function hexToObsidianColor(hex) {
+  return { a: 1, rgb: Number.parseInt(hex.replace("#", ""), 16) };
+}
+var OBSIDIAN_PROPERTY_TYPES = {
+  page_id: "text",
+  kind: "text",
+  title: "text",
+  tags: "tags",
+  aliases: "aliases",
+  source_ids: "multitext",
+  project_ids: "multitext",
+  node_ids: "multitext",
+  freshness: "text",
+  status: "text",
+  confidence: "number",
+  created_at: "datetime",
+  updated_at: "datetime",
+  compiled_from: "multitext",
+  managed_by: "text",
+  backlinks: "multitext",
+  schema_hash: "text",
+  source_class: "text",
+  source_type: "text",
+  language: "text",
+  graph_community: "text",
+  degree: "number",
+  bridge_score: "number",
+  is_god_node: "checkbox",
+  community: "text",
+  cssclasses: "multitext"
+};
 var NODE_COLORS = {
   source: "#f59e0b",
   module: "#fb7185",
@@ -1680,6 +1711,25 @@ function connectionsSection(nodeIds, adjacency, nodesById, wikilinkTarget) {
   }
   return lines;
 }
+function typedLinkFrontmatter(nodeIds, adjacency, nodesById, wikilinkTarget) {
+  const byRelation = /* @__PURE__ */ new Map();
+  const seen = /* @__PURE__ */ new Set();
+  for (const nodeId of nodeIds) {
+    for (const entry of adjacency.get(nodeId) ?? []) {
+      const key = `${entry.neighborId}:${entry.relation}`;
+      if (seen.has(key)) continue;
+      seen.add(key);
+      const neighbor = nodesById.get(entry.neighborId);
+      if (!neighbor) continue;
+      const target = wikilinkTarget.get(entry.neighborId);
+      if (!target) continue;
+      const bucket = byRelation.get(entry.relation) ?? [];
+      bucket.push(`[[${target}|${neighbor.label}]]`);
+      byRelation.set(entry.relation, bucket);
+    }
+  }
+  return Object.fromEntries(byRelation);
+}
 async function exportObsidianVault(rootDir, outputDir) {
   const graph = await loadGraph(rootDir);
   const { paths } = await loadVaultConfig(rootDir);
@@ -1741,6 +1791,9 @@ async function exportObsidianVault(rootDir, outputDir) {
       if (primaryNode.communityId) {
         data.graph_community = primaryNode.communityId;
       }
+      data.degree = primaryNode.degree ?? 0;
+      data.bridge_score = primaryNode.bridgeScore ?? 0;
+      data.is_god_node = primaryNode.isGodNode ?? false;
       const title = data.title ?? "";
       const nodeAliases = pageNodes.map((n) => n.label).filter((label) => label.toLowerCase() !== title.toLowerCase());
       const existingAliases = Array.isArray(data.aliases) ? data.aliases : [];
@@ -1748,6 +1801,15 @@ async function exportObsidianVault(rootDir, outputDir) {
       if (mergedAliases.length > 0) {
         data.aliases = mergedAliases;
       }
+      const typedLinks = typedLinkFrontmatter(
+        pageNodes.map((n) => n.id),
+        adjacency,
+        nodesById,
+        wikilinkTarget
+      );
+      for (const [relation, links] of Object.entries(typedLinks)) {
+        data[relation] = links;
+      }
     }
     let outputContent = matter.stringify(parsed.content, data);
     if (pageNodes.length > 0) {
@@ -1781,11 +1843,19 @@ ${connLines.join("\n")}
       community: node.communityId ?? null,
       confidence: node.confidence ?? null,
       source_class: node.sourceClass ?? null,
-      tags: node.tags ?? []
+      degree: node.degree ?? 0,
+      bridge_score: node.bridgeScore ?? 0,
+      is_god_node: node.isGodNode ?? false,
+      tags: node.tags ?? [],
+      cssclasses: ["swarmvault", `sv-${node.type}`]
     };
     if (aliases.length > 0) {
       frontmatter.aliases = aliases;
     }
+    const orphanTypedLinks = typedLinkFrontmatter([node.id], adjacency, nodesById, wikilinkTarget);
+    for (const [relation, links] of Object.entries(orphanTypedLinks)) {
+      frontmatter[relation] = links;
+    }
     const lines = [`# ${node.label}`, ""];
     const connLines = connectionsSection([node.id], adjacency, nodesById, wikilinkTarget);
     if (connLines.length > 0) {
@@ -1887,10 +1957,19 @@ ${connLines.join("\n")}
       {}
     )
   );
-  const colorGroups = projectIds.map((pid, index) => ({
+  const nodeTypeGroups = [
+    { query: "tag:#source", color: hexToObsidianColor("#f59e0b") },
+    { query: "tag:#module", color: hexToObsidianColor("#fb7185") },
+    { query: "tag:#concept", color: hexToObsidianColor("#0ea5e9") },
+    { query: "tag:#entity", color: hexToObsidianColor("#22c55e") },
+    { query: "tag:#rationale", color: hexToObsidianColor("#14b8a6") },
+    { query: "tag:#symbol", color: hexToObsidianColor("#8b5cf6") }
+  ];
+  const projectColorGroups = projectIds.map((pid, index) => ({
     query: `tag:#project/${pid}`,
-    color: ["#0ea5e9", "#22c55e", "#f59e0b", "#8b5cf6", "#fb7185", "#14b8a6"][index % 6]
+    color: hexToObsidianColor(["#0ea5e9", "#22c55e", "#f59e0b", "#8b5cf6", "#fb7185", "#14b8a6"][index % 6])
   }));
+  const colorGroups = [...nodeTypeGroups, ...projectColorGroups];
   await fs2.writeFile(
     path2.join(obsidianDir, "app.json"),
     JSON.stringify(
@@ -1914,7 +1993,48 @@ ${connLines.join("\n")}
     ),
     "utf8"
   );
-  fileCount += 3;
+  await fs2.writeFile(path2.join(obsidianDir, "types.json"), JSON.stringify({ types: OBSIDIAN_PROPERTY_TYPES }, null, 2), "utf8");
+  fileCount += 4;
+  const dashboardDir = path2.join(resolvedOutputDir, "graph", "dashboards");
+  await ensureDir(dashboardDir);
+  const dvPages = [
+    {
+      name: "sources-by-confidence",
+      title: "Sources by Confidence",
+      query: "TABLE confidence, source_class, updated_at FROM #source SORT confidence DESC"
+    },
+    {
+      name: "concepts-index",
+      title: "Concepts Index",
+      query: "TABLE degree, graph_community FROM #concept SORT degree DESC"
+    },
+    {
+      name: "stale-pages",
+      title: "Stale Pages",
+      query: 'TABLE freshness, updated_at FROM "" WHERE freshness = "stale"'
+    },
+    {
+      name: "god-nodes",
+      title: "God Nodes",
+      query: 'TABLE degree, bridge_score FROM "" WHERE is_god_node = true SORT degree DESC'
+    }
+  ];
+  for (const dv of dvPages) {
+    const dvFrontmatter = {
+      title: dv.title,
+      kind: "dashboard",
+      tags: ["dashboard", "dataview"],
+      cssclasses: ["swarmvault", "sv-dashboard"]
+    };
+    const dvBody = `# ${dv.title}
+
+\`\`\`dataview
+${dv.query}
+\`\`\`
+`;
+    await fs2.writeFile(path2.join(dashboardDir, `${dv.name}.md`), matter.stringify(dvBody, dvFrontmatter), "utf8");
+    fileCount++;
+  }
   return { format: "obsidian", outputPath: resolvedOutputDir, fileCount };
 }
 async function exportObsidianCanvas(rootDir, outputPath) {
@@ -1929,6 +2049,7 @@ async function exportObsidianCanvas(rootDir, outputPath) {
   const GROUP_PAD = 50;
   const GRID_COLS = 3;
   const GROUP_GAP = 100;
+  const pageById2 = graphPageById(graph);
   const canvasNodes = [];
   const canvasEdges = [];
   const nodeCanvasId = /* @__PURE__ */ new Map();
@@ -1980,19 +2101,33 @@ async function exportObsidianCanvas(rootDir, outputPath) {
       const nodeY = groupY + GROUP_PAD + 30 + innerRow * (NODE_HEIGHT + NODE_PAD_Y);
       const canvasId = `node-${node.id}`;
       nodeCanvasId.set(node.id, canvasId);
-      const communityLabel2 = community.id === "community:unassigned" ? "Unassigned" : community.label;
-      canvasNodes.push({
-        id: canvasId,
-        type: "text",
-        text: `**${node.label}**
+      const page = node.pageId ? pageById2.get(node.pageId) : void 0;
+      if (page) {
+        canvasNodes.push({
+          id: canvasId,
+          type: "file",
+          file: page.path,
+          x: nodeX,
+          y: nodeY,
+          width: NODE_WIDTH,
+          height: NODE_HEIGHT,
+          color: COLORS[communityIndex % COLORS.length]
+        });
+      } else {
+        const communityLabel2 = community.id === "community:unassigned" ? "Unassigned" : community.label;
+        canvasNodes.push({
+          id: canvasId,
+          type: "text",
+          text: `**${node.label}**
 Type: ${node.type}
 Community: ${communityLabel2}`,
-        x: nodeX,
-        y: nodeY,
-        width: NODE_WIDTH,
-        height: NODE_HEIGHT,
-        color: COLORS[communityIndex % COLORS.length]
-      });
+          x: nodeX,
+          y: nodeY,
+          width: NODE_WIDTH,
+          height: NODE_HEIGHT,
+          color: COLORS[communityIndex % COLORS.length]
+        });
+      }
     });
   });
   for (const edge of graph.edges) {
@@ -2003,6 +2138,10 @@ Community: ${communityLabel2}`,
       id: `edge-${edge.id}`,
       fromNode: fromId,
       toNode: toId,
+      fromSide: "right",
+      toSide: "left",
+      fromEnd: "none",
+      toEnd: "arrow",
       label: edge.relation
     });
   }
@@ -15423,6 +15562,9 @@ function sourceHashFrontmatter(sourceHashes, sourceSemanticHashes) {
     source_semantic_hashes: sourceSemanticHashes
   };
 }
+function cssclassesFor(kind) {
+  return ["swarmvault", `sv-${kind.replace(/_/g, "-")}`];
+}
 function decoratedTags(baseTags, decorations) {
   return uniqueStrings2([
     ...baseTags,
@@ -15516,6 +15658,7 @@ function buildSourcePage(manifest, analysis, schemaHash, metadata, relatedOutput
   const frontmatter = {
     page_id: pageId,
     kind: "source",
+    cssclasses: cssclassesFor("source"),
     title: analysis.title,
     ...manifest.sourceType ? { source_type: manifest.sourceType } : {},
     ...manifest.sourceClass ? { source_class: manifest.sourceClass } : {},
@@ -15667,6 +15810,7 @@ function buildModulePage(input) {
   const frontmatter = {
     page_id: pageId,
     kind: "module",
+    cssclasses: cssclassesFor("module"),
     title,
     ...manifest.sourceClass ? { source_class: manifest.sourceClass } : {},
     tags: decoratedTags(["module", "code", code.language], { projectIds: input.projectIds, extraTags: input.extraTags }),
@@ -15784,6 +15928,7 @@ function buildAggregatePage(kind, name, descriptions, sourceAnalyses, sourceHash
   const frontmatter = {
     page_id: pageId,
     kind,
+    cssclasses: cssclassesFor(kind),
     title: name,
     ...decorations?.sourceClass ? { source_class: decorations.sourceClass } : {},
     tags: decoratedTags(metadata.status === "candidate" ? [kind, "candidate"] : [kind], decorations),
@@ -15938,6 +16083,7 @@ function buildSectionIndex(kind, pages, schemaHash, metadata, projectIds = []) {
     {
       page_id: `${kind}:index`,
       kind: "index",
+      cssclasses: cssclassesFor("index"),
       title,
       tags: decoratedTags(["index", kind], { projectIds }),
       source_ids: [],
@@ -16305,6 +16451,7 @@ function buildGraphReportPage(input) {
   const frontmatter = {
     page_id: pageId,
     kind: "graph_report",
+    cssclasses: cssclassesFor("graph_report"),
     title: "Graph Report",
     tags: ["graph", "report"],
     source_ids: relatedSourceIds,
@@ -16465,6 +16612,7 @@ function buildCommunitySummaryPage(input) {
   const frontmatter = {
     page_id: pageId,
     kind: "community_summary",
+    cssclasses: cssclassesFor("community"),
     title: `Community: ${input.community.label}`,
     tags: ["graph", "community"],
     source_ids: relatedSourceIds,
@@ -16543,6 +16691,7 @@ function buildProjectsIndex(projectPages, schemaHash, metadata) {
     {
       page_id: "projects:index",
       kind: "index",
+      cssclasses: cssclassesFor("index"),
       title: "Projects",
       tags: ["index", "projects"],
       source_ids: [],
@@ -16596,6 +16745,7 @@ function buildProjectIndex(input) {
     {
       page_id: `project:${input.projectId}:index`,
       kind: "index",
+      cssclasses: cssclassesFor("index"),
       title,
       tags: decoratedTags(["index", "projects"], { projectIds: [input.projectId] }),
       source_ids: [],
@@ -16627,6 +16777,7 @@ function buildOutputPage(input) {
   const frontmatter = {
     page_id: pageId,
     kind: "output",
+    cssclasses: cssclassesFor("output"),
     title: input.title ?? input.question,
     tags: decoratedTags(["output"], { projectIds: input.projectIds, extraTags: input.extraTags }),
     source_ids: input.citations,
@@ -16756,6 +16907,7 @@ function buildExploreHubPage(input) {
   const frontmatter = {
     page_id: pageId,
     kind: "output",
+    cssclasses: cssclassesFor("output"),
     title,
     tags: decoratedTags(["output", "explore"], { projectIds: input.projectIds, extraTags: input.extraTags }),
     source_ids: relatedSourceIds,
@@ -21086,12 +21238,41 @@ async function ensureObsidianWorkspace(rootDir) {
       showTags: true,
       showAttachments: false,
       hideUnresolved: false,
-      colorGroups: projectIds.map((projectId, index) => ({
-        query: `tag:#project/${projectId}`,
-        color: ["#0ea5e9", "#22c55e", "#f59e0b", "#fb7185", "#8b5cf6", "#14b8a6"][index % 6]
-      })),
+      colorGroups: [
+        { query: "tag:#source", color: { a: 1, rgb: 16096779 } },
+        { query: "tag:#module", color: { a: 1, rgb: 16478597 } },
+        { query: "tag:#concept", color: { a: 1, rgb: 959977 } },
+        { query: "tag:#entity", color: { a: 1, rgb: 2278750 } },
+        { query: "tag:#rationale", color: { a: 1, rgb: 1357990 } },
+        { query: "tag:#symbol", color: { a: 1, rgb: 9133302 } },
+        ...projectIds.map((projectId, index) => ({
+          query: `tag:#project/${projectId}`,
+          color: { a: 1, rgb: [959977, 2278750, 16096779, 16478597, 9133302, 1357990][index % 6] }
+        }))
+      ],
       localJumps: false
     }),
+    writeJsonFile(path23.join(obsidianDir, "types.json"), {
+      types: {
+        page_id: "text",
+        kind: "text",
+        title: "text",
+        tags: "tags",
+        aliases: "aliases",
+        source_ids: "multitext",
+        project_ids: "multitext",
+        node_ids: "multitext",
+        freshness: "text",
+        status: "text",
+        confidence: "number",
+        created_at: "datetime",
+        updated_at: "datetime",
+        compiled_from: "multitext",
+        managed_by: "text",
+        backlinks: "multitext",
+        cssclasses: "multitext"
+      }
+    }),
     writeJsonFile(path23.join(obsidianDir, "workspace.json"), {
       active: "root",
       lastOpenFiles: ["wiki/index.md", "wiki/projects/index.md", "wiki/candidates/index.md", "wiki/insights/index.md"],
@@ -22295,7 +22476,7 @@ async function bootstrapDemo(rootDir, input) {
 }
 
 // src/mcp.ts
-var SERVER_VERSION = "0.7.27";
+var SERVER_VERSION = "0.7.29";
 async function createMcpServer(rootDir) {
   const server = new McpServer({
     name: "swarmvault",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@swarmvaultai/engine",
-  "version": "0.7.27",
+  "version": "0.7.29",
   "description": "Core engine for SwarmVault: ingest, compile, query, lint, and provider abstractions.",
   "type": "module",
   "main": "dist/index.js",
@@ -39,6 +39,13 @@
   "engines": {
     "node": ">=24.0.0"
   },
+  "scripts": {
+    "build": "test -f ../viewer/dist/index.html || pnpm --dir ../viewer build; tsup src/index.ts --format esm --dts && tsup --config tsup.hooks.config.ts && rm -rf dist/viewer && mkdir -p dist/viewer && cp -R ../viewer/dist/. dist/viewer/",
+    "pretest": "tsup --config tsup.hooks.config.ts",
+    "test": "SWARMVAULT_ALLOW_PRIVATE_URLS=1 vitest run",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "node ../../scripts/check-release-sync.mjs && node ../../scripts/check-published-manifests.mjs"
+  },
   "dependencies": {
     "@asciidoctor/core": "^3.0.4",
     "@modelcontextprotocol/sdk": "^1.29.0",
@@ -88,11 +95,5 @@
     "graphology-types": "^0.24.8",
     "tsup": "^8.5.0",
     "vitest": "^3.2.4"
-  },
-  "scripts": {
-    "build": "test -f ../viewer/dist/index.html || pnpm --dir ../viewer build; tsup src/index.ts --format esm --dts && tsup --config tsup.hooks.config.ts && rm -rf dist/viewer && mkdir -p dist/viewer && cp -R ../viewer/dist/. dist/viewer/",
-    "pretest": "tsup --config tsup.hooks.config.ts",
-    "test": "SWARMVAULT_ALLOW_PRIVATE_URLS=1 vitest run",
-    "typecheck": "tsc --noEmit"
   }
-}
+}

package/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2026 SwarmVault
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.