whygraph 0.1.0

package/dist/server/worktree.js

@@ -0,0 +1,84 @@
+import * as path from "node:path";
+import * as fs from "node:fs/promises";
+import { execFile as execFileCb } from "node:child_process";
+import { promisify } from "node:util";
+const execFileAsync = promisify(execFileCb);
+// ============================================================
+// Parse porcelain output
+// ============================================================
+export function parseWorktreeList(output) {
+    const trimmed = output.trim();
+    if (trimmed === "")
+        return [];
+    const results = [];
+    const lines = trimmed.split("\n");
+    let current = {};
+    let isFirst = true;
+    for (const line of lines) {
+        if (line.startsWith("worktree ")) {
+            current = { path: line.slice("worktree ".length) };
+        }
+        else if (line.startsWith("branch ")) {
+            const ref = line.slice("branch ".length);
+            current.branch = ref.replace("refs/heads/", "");
+        }
+        else if (line === "detached") {
+            current.branch = null;
+        }
+        else if (line === "") {
+            if (current.path !== undefined) {
+                results.push({
+                    path: current.path,
+                    branch: current.branch ?? null,
+                    isMain: isFirst,
+                });
+                isFirst = false;
+                current = {};
+            }
+        }
+    }
+    // Handle trailing entry without final blank line
+    if (current.path !== undefined) {
+        results.push({
+            path: current.path,
+            branch: current.branch ?? null,
+            isMain: isFirst,
+        });
+    }
+    return results;
+}
+// ============================================================
+// Detect worktrees with whygraph graphs
+// ============================================================
+export async function detectWorktrees(repoDir, deps) {
+    /* v8 ignore next 3 */
+    const run = deps?.execFile ?? ((cmd, args, opts) => execFileAsync(cmd, args, { cwd: opts.cwd }));
+    /* v8 ignore next 1 */
+    const checkAccess = deps?.access ?? ((p) => fs.access(p));
+    let stdout;
+    try {
+        const result = await run("git", ["worktree", "list", "--porcelain"], { cwd: repoDir });
+        stdout = result.stdout;
+    }
+    catch {
+        return [];
+    }
+    const parsed = parseWorktreeList(stdout);
+    const nonMain = parsed.filter((wt) => !wt.isMain && wt.branch !== null);
+    const results = [];
+    for (const wt of nonMain) {
+        const graphDir = path.join(wt.path, ".whygraph", "graph");
+        try {
+            await checkAccess(graphDir);
+            results.push({
+                path: wt.path,
+                branch: wt.branch,
+                graphDir,
+            });
+        }
+        catch {
+            // No .whygraph/graph/ — skip
+        }
+    }
+    return results;
+}

package/package.json

@@ -0,0 +1,73 @@
+{
+  "name": "whygraph",
+  "version": "0.1.0",
+  "description": "The graph of why. So your agent knows before it touches anything.",
+  "author": "Geovanie Ruiz",
+  "license": "MIT",
+  "keywords": [
+    "ai",
+    "agent",
+    "mcp",
+    "architecture",
+    "decision",
+    "adr",
+    "claude",
+    "cursor",
+    "vibe-coding"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/geovanie-ruiz/whygraph.git"
+  },
+  "homepage": "https://github.com/geovanie-ruiz/whygraph#readme",
+  "bugs": {
+    "url": "https://github.com/geovanie-ruiz/whygraph/issues"
+  },
+  "type": "module",
+  "bin": {
+    "whygraph": "./dist/cli/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "build:frontend": "cd frontend && npm run build",
+    "build:all": "npm run build && npm run build:frontend",
+    "dev": "tsc --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "lint": "tsc --noEmit",
+    "prepublishOnly": "npm run build && npm run build:frontend"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.27.1",
+    "chokidar": "^5.0.0",
+    "commander": "^14.0.3",
+    "graphology": "^0.25.0",
+    "graphql": "^16.13.1",
+    "graphql-ws": "^6.0.7",
+    "graphql-yoga": "^5.18.1",
+    "gray-matter": "^4.0.3",
+    "js-yaml": "^4.1.1",
+    "nanoid": "^5.1.7",
+    "open": "^11.0.0",
+    "prompts": "^2.4.2",
+    "ws": "^8.20.0"
+  },
+  "devDependencies": {
+    "@types/js-yaml": "^4.0.9",
+    "@types/node": "^20.0.0",
+    "@types/prompts": "^2.4.9",
+    "@types/ws": "^8.18.1",
+    "@vitest/coverage-v8": "^4.1.2",
+    "typescript": "^5.0.0",
+    "vitest": "^4.1.2"
+  },
+  "files": [
+    "dist/",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=20.0.0"
+  }
+}