@taciturnaxolotl/traverse 0.1.6 → 0.1.8

package/package.json

@@ -1,31 +1,32 @@
 {
-  "name": "@taciturnaxolotl/traverse",
-  "version": "0.1.6",
-  "description": "Interactive code walkthrough diagrams via MCP",
-  "module": "src/index.ts",
-  "type": "module",
-  "bin": {
-    "traverse": "./bin/traverse.cjs"
-  },
-  "files": [
-    "src",
-    "bin",
-    "fonts",
-    "icon.svg"
-  ],
-  "scripts": {
-    "start": "bun run src/index.ts",
-    "dev": "bun --hot run src/index.ts"
-  },
-  "devDependencies": {
-    "@types/bun": "latest"
-  },
-  "peerDependencies": {
-    "typescript": "^5"
-  },
-  "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.26.0",
-    "@resvg/resvg-wasm": "^2.6.2",
-    "satori": "^0.19.1"
-  }
+	"name": "@taciturnaxolotl/traverse",
+	"version": "0.1.8",
+	"description": "Interactive code walkthrough diagrams via MCP",
+	"module": "src/index.ts",
+	"type": "module",
+	"bin": {
+		"traverse": "bin/traverse.cjs"
+	},
+	"files": [
+		"src",
+		"bin",
+		"fonts",
+		"vendor",
+		"icon.svg"
+	],
+	"scripts": {
+		"start": "bun run src/index.ts",
+		"dev": "bun --hot run src/index.ts"
+	},
+	"devDependencies": {
+		"@types/bun": "latest"
+	},
+	"peerDependencies": {
+		"typescript": "^5"
+	},
+	"dependencies": {
+		"@modelcontextprotocol/sdk": "^1.26.0",
+		"@resvg/resvg-wasm": "^2.6.2",
+		"satori": "^0.19.1"
+	}
 }

package/src/index.ts

@@ -14,6 +14,16 @@ const VERSION = await Bun.$`git rev-parse --short HEAD`.text().then(s => s.trim(
   const pkg = await Bun.file(import.meta.dir + "/../package.json").json();
   return `v${pkg.version}`;
 });
+const GITHUB_REPO = await Bun.$`git remote get-url origin`.text().then(url => {
+  url = url.trim();
+  // Convert SSH URLs: git@github.com:user/repo.git -> https://github.com/user/repo
+  const sshMatch = url.match(/^git@github\.com:(.+?)(?:\.git)?$/);
+  if (sshMatch) return `https://github.com/${sshMatch[1]}`;
+  // Convert HTTPS URLs: https://github.com/user/repo.git -> https://github.com/user/repo
+  const httpsMatch = url.match(/^https:\/\/github\.com\/(.+?)(?:\.git)?$/);
+  if (httpsMatch) return `https://github.com/${httpsMatch[1]}`;
+  return "";
+}).catch(() => "");
 initDb();
 
 // Load persisted diagrams
@@ -119,6 +129,7 @@ try {
             code: body.code,
             summary: body.summary,
             nodes: body.nodes,
+            githubRepo: body.githubRepo || undefined,
             createdAt: new Date().toISOString(),
           };
           diagrams.set(id, diagram);
@@ -230,7 +241,7 @@ Then build the diagram:
       const res = await fetch(`http://localhost:${PORT}/api/diagrams`, {
         method: "POST",
         headers: { "Content-Type": "application/json" },
-        body: JSON.stringify({ code, summary, nodes }),
+        body: JSON.stringify({ code, summary, nodes, githubRepo: GITHUB_REPO || undefined }),
       });
       if (!res.ok) {
         return {
@@ -245,6 +256,7 @@ Then build the diagram:
         code,
         summary,
         nodes,
+        githubRepo: GITHUB_REPO || undefined,
         createdAt: new Date().toISOString(),
       };
       diagrams.set(id, diagram);

package/src/og.ts

@@ -10,38 +10,32 @@ const [interRegular, interBold] = await Promise.all([
 ]);
 
 // Initialize resvg-wasm
-// Use import.meta.resolve to find the package, then locate the WASM file
-let wasmPath: string;
-try {
-  // Try to resolve the @resvg/resvg-wasm package
-  const resvgPath = import.meta.resolve("@resvg/resvg-wasm");
-  // The resolved path will be something like file:///path/to/node_modules/@resvg/resvg-wasm/index.js
-  // Extract the directory and append the WASM file
-  const resvgDir = new URL(".", resvgPath).pathname;
-  wasmPath = join(resvgDir, "index_bg.wasm");
-} catch {
-  // Fallback to manual path resolution if import.meta.resolve fails
-  const possiblePaths = [
-    join(import.meta.dir, "../node_modules/@resvg/resvg-wasm/index_bg.wasm"),
-    join(import.meta.dir, "../../@resvg/resvg-wasm/index_bg.wasm"),
-    join(import.meta.dir, "../../../@resvg/resvg-wasm/index_bg.wasm"),
-  ];
+// Try bundled WASM first, then fall back to node_modules
+const possiblePaths = [
+  // Bundled WASM file (most reliable)
+  join(import.meta.dir, "../vendor/index_bg.wasm"),
+  // Development: node_modules is a sibling of src
+  join(import.meta.dir, "../node_modules/@resvg/resvg-wasm/index_bg.wasm"),
+  // Installed: in parent node_modules
+  join(import.meta.dir, "../../@resvg/resvg-wasm/index_bg.wasm"),
+  join(import.meta.dir, "../../../@resvg/resvg-wasm/index_bg.wasm"),
+];
 
-  for (const path of possiblePaths) {
-    if (await Bun.file(path).exists()) {
-      wasmPath = path;
-      break;
-    }
+let wasmPath: string | undefined;
+for (const path of possiblePaths) {
+  if (await Bun.file(path).exists()) {
+    wasmPath = path;
+    break;
   }
+}
 
-  if (!wasmPath!) {
-    console.error("Failed to find @resvg/resvg-wasm WASM file. Tried:");
-    for (const path of possiblePaths) {
-      console.error(`  - ${path}`);
-    }
-    console.error(`\nCurrent directory: ${import.meta.dir}`);
-    throw new Error("Could not find @resvg/resvg-wasm WASM file");
+if (!wasmPath) {
+  console.error("Failed to find @resvg/resvg-wasm WASM file. Tried:");
+  for (const path of possiblePaths) {
+    console.error(`  - ${path}`);
   }
+  console.error(`\nCurrent directory: ${import.meta.dir}`);
+  throw new Error("Could not find @resvg/resvg-wasm WASM file");
 }
 
 await initWasm(Bun.file(wasmPath).arrayBuffer());

package/src/template.ts

@@ -654,6 +654,7 @@ export function generateViewerHTML(diagram: WalkthroughDiagram, gitHash: string
 
     const DIAGRAM_DATA = ${diagramJSON};
     const PROJECT_ROOT = ${JSON.stringify(projectRoot)};
+    const GITHUB_REPO = ${JSON.stringify(diagram.githubRepo || "")};
     const SHARE_SERVER_URL = ${JSON.stringify(shareServerUrl)};
     const DIAGRAM_ID = ${JSON.stringify(diagramId)};
     const VIEWER_MODE = ${JSON.stringify(mode)};
@@ -814,7 +815,8 @@ export function generateViewerHTML(diagram: WalkthroughDiagram, gitHash: string
         html += '<ul class="links-list">';
         meta.links.forEach(link => {
           const href = buildFileUrl(link.label, link.url);
-          html += '<li><a href="' + escapeAttr(href) + '">' + escapeText(link.label) + "</a></li>";
+          const target = GITHUB_REPO ? ' target="_blank" rel="noopener"' : '';
+          html += '<li><a href="' + escapeAttr(href) + '"' + target + '>' + escapeText(link.label) + "</a></li>";
         });
         html += "</ul>";
       }
@@ -921,8 +923,15 @@ export function generateViewerHTML(diagram: WalkthroughDiagram, gitHash: string
 
     function buildFileUrl(label, url) {
       // Parse line number from label like "src/index.ts:56-59" or "src/index.ts:56"
-      const lineMatch = label.match(/:(\d+)/);
+      const lineMatch = label.match(/:(\d+)(?:-(\d+))?/);
       const line = lineMatch ? lineMatch[1] : "1";
+      if (GITHUB_REPO) {
+        // Build GitHub link: https://github.com/user/repo/blob/HEAD/path#L1-L5
+        const lineAnchor = lineMatch && lineMatch[2]
+          ? "#L" + lineMatch[1] + "-L" + lineMatch[2]
+          : "#L" + line;
+        return GITHUB_REPO + "/blob/HEAD/" + url + lineAnchor;
+      }
       const filePath = PROJECT_ROOT + "/" + url;
       return "vscode://file/" + filePath + ":" + line;
     }

package/src/types.ts

@@ -14,6 +14,7 @@ export interface WalkthroughDiagram {
   code: string;
   summary: string;
   nodes: Record<string, NodeMetadata>;
+  githubRepo?: string;
   createdAt?: string;
 }