@mcp-graph-workflow/mcp-graph 3.0.0

package/dist/core/insights/skill-recommender.js

@@ -0,0 +1,129 @@
+import path from "node:path";
+import { readdir, readFile } from "node:fs/promises";
+import { logger } from "../utils/logger.js";
+/**
+ * Scan skills directory for SKILL.md files and extract frontmatter.
+ */
+export async function scanSkills(basePath) {
+    const skillsDirs = [
+        path.join(basePath, "copilot-ecosystem", "skills", "agents"),
+        path.join(basePath, ".claude", "skills"),
+    ];
+    const skills = [];
+    for (const dir of skillsDirs) {
+        try {
+            const entries = await readdir(dir, { withFileTypes: true });
+            for (const entry of entries) {
+                if (!entry.isDirectory())
+                    continue;
+                const skillMdPath = path.join(dir, entry.name, "SKILL.md");
+                try {
+                    const content = await readFile(skillMdPath, "utf-8");
+                    const info = parseSkillFrontmatter(content, entry.name, skillMdPath);
+                    if (info)
+                        skills.push(info);
+                }
+                catch {
+                    // No SKILL.md in this directory
+                }
+            }
+        }
+        catch {
+            // Directory doesn't exist
+        }
+    }
+    logger.info("Skills scanned", { count: skills.length });
+    return skills;
+}
+function parseSkillFrontmatter(content, dirName, filePath) {
+    // Parse YAML frontmatter between --- delimiters
+    const match = content.match(/^---\n([\s\S]*?)\n---/);
+    if (!match) {
+        return {
+            name: dirName,
+            description: extractFirstLine(content),
+            category: "general",
+            filePath,
+        };
+    }
+    const frontmatter = match[1];
+    const name = extractField(frontmatter, "name") ?? dirName;
+    const description = extractField(frontmatter, "description") ?? extractFirstLine(content);
+    const category = extractField(frontmatter, "category") ?? "general";
+    return { name, description, category, filePath };
+}
+function extractField(yaml, field) {
+    const match = yaml.match(new RegExp(`^${field}:\\s*(.+)$`, "m"));
+    return match ? match[1].trim().replace(/^["']|["']$/g, "") : null;
+}
+function extractFirstLine(content) {
+    const lines = content.split("\n").filter((l) => l.trim() && !l.startsWith("---") && !l.startsWith("#"));
+    return lines[0]?.trim().substring(0, 120) ?? "";
+}
+/**
+ * Generate skill recommendations based on current graph state.
+ */
+export function recommendSkills(doc, availableSkills) {
+    const recommendations = [];
+    const skillNames = new Set(availableSkills.map((s) => s.name));
+    const tasksByStatus = new Map();
+    for (const node of doc.nodes) {
+        if (node.type === "task" || node.type === "subtask") {
+            const count = tasksByStatus.get(node.status) ?? 0;
+            tasksByStatus.set(node.status, count + 1);
+        }
+    }
+    const inProgressCount = tasksByStatus.get("in_progress") ?? 0;
+    const backlogCount = tasksByStatus.get("backlog") ?? 0;
+    const blockedCount = tasksByStatus.get("blocked") ?? 0;
+    // Tasks without tests
+    const tasksWithoutTests = doc.nodes.filter((n) => (n.type === "task" || n.type === "subtask") &&
+        n.status === "in_progress" &&
+        !n.tags?.includes("tested"));
+    if (tasksWithoutTests.length > 0 && skillNames.has("polyglot-test-generator")) {
+        recommendations.push({
+            skill: "polyglot-test-generator",
+            reason: `${tasksWithoutTests.length} tasks in progress without test coverage`,
+            phase: "IMPLEMENT",
+        });
+    }
+    // Review pending
+    const readyForReview = doc.nodes.filter((n) => n.type === "task" && n.status === "in_progress" && n.tags?.includes("review-pending"));
+    if (readyForReview.length > 0 && skillNames.has("code-reviewer")) {
+        recommendations.push({
+            skill: "code-reviewer",
+            reason: `${readyForReview.length} tasks pending review`,
+            phase: "REVIEW",
+        });
+    }
+    // High blocked count
+    if (blockedCount > 3) {
+        recommendations.push({
+            skill: "dev-flow-orchestrator",
+            reason: `${blockedCount} blocked tasks — consider re-planning dependencies`,
+            phase: "ANALYZE",
+        });
+    }
+    // Large backlog
+    if (backlogCount > 20 && inProgressCount === 0) {
+        recommendations.push({
+            skill: "dev-flow-orchestrator",
+            reason: `${backlogCount} tasks in backlog with none in progress — start sprint planning`,
+            phase: "PLAN",
+        });
+    }
+    // Missing acceptance criteria
+    const missingAC = doc.nodes.filter((n) => (n.type === "task" || n.type === "epic") &&
+        n.status !== "done" &&
+        (!n.acceptanceCriteria || n.acceptanceCriteria.length === 0));
+    if (missingAC.length > 5) {
+        recommendations.push({
+            skill: "create-prd-chat-mode",
+            reason: `${missingAC.length} tasks/epics without acceptance criteria`,
+            phase: "DESIGN",
+        });
+    }
+    logger.info("Skill recommendations generated", { count: recommendations.length });
+    return recommendations;
+}
+//# sourceMappingURL=skill-recommender.js.map

package/dist/core/insights/skill-recommender.js.map

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

package/dist/core/integrations/enriched-context.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Enriched Context Builder — combines Serena memories with GitNexus data
+ * for a unified symbol context. All data sourced locally.
+ */
+export interface EnrichedContext {
+    symbol: string;
+    serena: {
+        available: boolean;
+        relevantMemories: Array<{
+            name: string;
+            excerpt: string;
+        }>;
+    };
+    gitnexus: {
+        available: boolean;
+        data?: unknown;
+    };
+    combined: string;
+}
+/**
+ * Build enriched context for a symbol by combining Serena + GitNexus data.
+ */
+export declare function buildEnrichedContext(symbol: string, basePath: string, gitnexusPort?: number): Promise<EnrichedContext>;
+//# sourceMappingURL=enriched-context.d.ts.map

package/dist/core/integrations/enriched-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"enriched-context.d.ts","sourceRoot":"","sources":["../../../src/core/integrations/enriched-context.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE;QACN,SAAS,EAAE,OAAO,CAAC;QACnB,gBAAgB,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KAC5D,CAAC;IACF,QAAQ,EAAE;QACR,SAAS,EAAE,OAAO,CAAC;QACnB,IAAI,CAAC,EAAE,OAAO,CAAC;KAChB,CAAC;IACF,QAAQ,EAAE,MAAM,CAAC;CAClB;AAqDD;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,YAAY,GAAE,MAAa,GAC1B,OAAO,CAAC,eAAe,CAAC,CA6C1B"}

package/dist/core/integrations/enriched-context.js

@@ -0,0 +1,89 @@
+/**
+ * Enriched Context Builder — combines Serena memories with GitNexus data
+ * for a unified symbol context. All data sourced locally.
+ */
+import { readAllSerenaMemories } from "./serena-reader.js";
+import { isGitNexusRunning } from "./gitnexus-launcher.js";
+import { logger } from "../utils/logger.js";
+/**
+ * Filter memories that mention the given symbol (case-insensitive).
+ */
+function filterRelevantMemories(memories, symbol) {
+    const lower = symbol.toLowerCase();
+    return memories
+        .filter((m) => m.content.toLowerCase().includes(lower))
+        .map((m) => {
+        // Extract relevant excerpt — lines containing the symbol
+        const lines = m.content.split("\n");
+        const relevant = lines.filter((l) => l.toLowerCase().includes(lower));
+        const excerpt = relevant.slice(0, 5).join("\n") || m.content.slice(0, 200);
+        return { name: m.name, excerpt };
+    });
+}
+/**
+ * Try to fetch GitNexus context for a symbol.
+ */
+async function fetchGitNexusContext(symbol, port) {
+    const running = await isGitNexusRunning(port);
+    if (!running) {
+        return { available: false };
+    }
+    try {
+        const res = await fetch(`http://localhost:${port}/api/context`, {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify({ symbol }),
+        });
+        if (!res.ok) {
+            return { available: true, data: null };
+        }
+        const data = await res.json();
+        return { available: true, data };
+    }
+    catch {
+        return { available: false };
+    }
+}
+/**
+ * Build enriched context for a symbol by combining Serena + GitNexus data.
+ */
+export async function buildEnrichedContext(symbol, basePath, gitnexusPort = 3737) {
+    logger.info("Building enriched context", { symbol, basePath });
+    // Fetch data from both sources in parallel
+    const [memories, gitnexus] = await Promise.all([
+        readAllSerenaMemories(basePath),
+        fetchGitNexusContext(symbol, gitnexusPort),
+    ]);
+    const serenaAvailable = memories.length > 0;
+    const relevantMemories = filterRelevantMemories(memories, symbol);
+    // Build combined summary
+    const parts = [`Symbol: ${symbol}`];
+    if (relevantMemories.length > 0) {
+        parts.push(`\nSerena Memories (${relevantMemories.length} relevant):`);
+        for (const mem of relevantMemories) {
+            parts.push(`  [${mem.name}] ${mem.excerpt.split("\n")[0]}`);
+        }
+    }
+    if (gitnexus.available && gitnexus.data) {
+        parts.push("\nGitNexus Context: Available (see gitnexus.data)");
+    }
+    else if (!gitnexus.available) {
+        parts.push("\nGitNexus: Not available");
+    }
+    const combined = parts.join("\n");
+    logger.info("Enriched context built", {
+        symbol,
+        serenaMemories: relevantMemories.length,
+        gitnexusAvailable: gitnexus.available,
+    });
+    return {
+        symbol,
+        serena: {
+            available: serenaAvailable,
+            relevantMemories,
+        },
+        gitnexus,
+        combined,
+    };
+}
+//# sourceMappingURL=enriched-context.js.map

package/dist/core/integrations/enriched-context.js.map

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

package/dist/core/integrations/gitnexus-launcher.d.ts

@@ -0,0 +1,62 @@
+/**
+ * GitNexus lifecycle manager.
+ * Handles analyze, serve (as child process), and cleanup.
+ * All operations are local-only — no data sent externally.
+ *
+ * Binary resolution order:
+ *   1. Local node_modules/.bin/gitnexus (target project)
+ *   2. Local node_modules/.bin/gitnexus (mcp-graph install dir)
+ *   3. Global `gitnexus` on PATH
+ *   4. Auto-install via `npm install --no-save gitnexus` in target project, then use local bin
+ */
+export type AnalyzePhase = "idle" | "analyzing" | "ready" | "unavailable" | "error";
+/**
+ * Get the current analyze phase.
+ */
+export declare function getAnalyzePhase(): AnalyzePhase;
+/**
+ * Reset analyze phase to idle (for testing).
+ */
+export declare function resetAnalyzePhase(): void;
+/**
+ * Check if the given path is inside a git repository.
+ */
+export declare function isGitRepo(basePath: string): boolean;
+export interface AnalyzeResult {
+    skipped: boolean;
+    success?: boolean;
+    reason: string;
+}
+export interface ServeResult {
+    started: boolean;
+    message: string;
+    port?: number;
+}
+/**
+ * Check if the codebase has been indexed by GitNexus.
+ */
+export declare function isGitNexusIndexed(basePath: string): boolean;
+/**
+ * Check if GitNexus serve is running on a given port via HTTP probe.
+ */
+export declare function isGitNexusRunning(port: number): Promise<boolean>;
+/**
+ * Resolve the gitnexus binary path.
+ * Caches result after first successful resolution.
+ */
+export declare function resolveGitNexusBin(basePath: string): Promise<string | null>;
+/**
+ * Ensure codebase is analyzed by GitNexus.
+ * Skips if `.gitnexus/` already exists.
+ */
+export declare function ensureGitNexusAnalyzed(basePath: string): Promise<AnalyzeResult>;
+/**
+ * Start GitNexus serve as a child process on the given port.
+ * Returns immediately after spawning — does not wait for readiness.
+ */
+export declare function startGitNexusServe(basePath: string, port: number): Promise<ServeResult>;
+/**
+ * Stop the GitNexus serve child process if running.
+ */
+export declare function stopGitNexus(): Promise<void>;
+//# sourceMappingURL=gitnexus-launcher.d.ts.map

package/dist/core/integrations/gitnexus-launcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gitnexus-launcher.d.ts","sourceRoot":"","sources":["../../../src/core/integrations/gitnexus-launcher.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAkBH,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,WAAW,GAAG,OAAO,GAAG,aAAa,GAAG,OAAO,CAAC;AAIpF;;GAEG;AACH,wBAAgB,eAAe,IAAI,YAAY,CAE9C;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,IAAI,CAGxC;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEnD;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAE3D;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAUtE;AA4CD;;;GAGG;AACH,wBAAsB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAqCjF;AAID;;;GAGG;AACH,wBAAsB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAyCrF;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CA8C7F;AAED;;GAEG;AACH,wBAAsB,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC,CAWlD"}

package/dist/core/integrations/gitnexus-launcher.js

@@ -0,0 +1,241 @@
+/**
+ * GitNexus lifecycle manager.
+ * Handles analyze, serve (as child process), and cleanup.
+ * All operations are local-only — no data sent externally.
+ *
+ * Binary resolution order:
+ *   1. Local node_modules/.bin/gitnexus (target project)
+ *   2. Local node_modules/.bin/gitnexus (mcp-graph install dir)
+ *   3. Global `gitnexus` on PATH
+ *   4. Auto-install via `npm install --no-save gitnexus` in target project, then use local bin
+ */
+import { existsSync } from "node:fs";
+import { execFile, spawn } from "node:child_process";
+import { promisify } from "node:util";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { logger } from "../utils/logger.js";
+import { IS_WINDOWS as IS_WIN, killProcess } from "../utils/platform.js";
+const execAsync = promisify(execFile);
+const GITNEXUS_DIR = ".gitnexus";
+const GITNEXUS_PKG = "gitnexus";
+let serveProcess = null;
+let resolvedBin = null;
+let analyzePhase = "idle";
+/**
+ * Get the current analyze phase.
+ */
+export function getAnalyzePhase() {
+    return analyzePhase;
+}
+/**
+ * Reset analyze phase to idle (for testing).
+ */
+export function resetAnalyzePhase() {
+    analyzePhase = "idle";
+    resolvedBin = null;
+}
+/**
+ * Check if the given path is inside a git repository.
+ */
+export function isGitRepo(basePath) {
+    return existsSync(path.join(basePath, ".git"));
+}
+/**
+ * Check if the codebase has been indexed by GitNexus.
+ */
+export function isGitNexusIndexed(basePath) {
+    return existsSync(path.join(basePath, GITNEXUS_DIR));
+}
+/**
+ * Check if GitNexus serve is running on a given port via HTTP probe.
+ */
+export async function isGitNexusRunning(port) {
+    try {
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), 2000);
+        const res = await fetch(`http://localhost:${port}`, { signal: controller.signal });
+        clearTimeout(timer);
+        return res.ok || res.status < 500;
+    }
+    catch {
+        return false;
+    }
+}
+// ── Binary resolution ─────────────────────────────────────
+const IS_WINDOWS = IS_WIN;
+function localBin(dir) {
+    const binName = IS_WINDOWS ? `${GITNEXUS_PKG}.cmd` : GITNEXUS_PKG;
+    return path.join(dir, "node_modules", ".bin", binName);
+}
+function mcpGraphRoot() {
+    const thisFile = fileURLToPath(import.meta.url);
+    // src/core/integrations/gitnexus-launcher.ts → project root (3 levels up)
+    return path.resolve(path.dirname(thisFile), "..", "..", "..");
+}
+async function whichGitNexus() {
+    const cmd = IS_WINDOWS ? "where" : "which";
+    try {
+        const { stdout } = await execAsync(cmd, [GITNEXUS_PKG]);
+        const bin = stdout.trim().split(/\r?\n/)[0];
+        return bin.length > 0 ? bin : null;
+    }
+    catch {
+        return null;
+    }
+}
+async function installGitNexus(basePath) {
+    logger.info("Auto-installing gitnexus in target project", { basePath });
+    try {
+        await execAsync("npm", ["install", "--no-save", GITNEXUS_PKG], {
+            cwd: basePath,
+            timeout: 120_000,
+        });
+        logger.success("gitnexus installed successfully", { basePath });
+        return true;
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        logger.warn("Failed to auto-install gitnexus", { error: msg });
+        return false;
+    }
+}
+/**
+ * Resolve the gitnexus binary path.
+ * Caches result after first successful resolution.
+ */
+export async function resolveGitNexusBin(basePath) {
+    if (resolvedBin && existsSync(resolvedBin))
+        return resolvedBin;
+    // 1. Local bin in target project
+    const targetBin = localBin(basePath);
+    if (existsSync(targetBin)) {
+        resolvedBin = targetBin;
+        logger.debug("GitNexus resolved: target project local bin", { bin: targetBin });
+        return resolvedBin;
+    }
+    // 2. Local bin in mcp-graph install directory
+    const mcpBin = localBin(mcpGraphRoot());
+    if (existsSync(mcpBin)) {
+        resolvedBin = mcpBin;
+        logger.debug("GitNexus resolved: mcp-graph local bin", { bin: mcpBin });
+        return resolvedBin;
+    }
+    // 3. Global binary on PATH
+    const globalBin = await whichGitNexus();
+    if (globalBin) {
+        resolvedBin = globalBin;
+        logger.debug("GitNexus resolved: global binary", { bin: globalBin });
+        return resolvedBin;
+    }
+    // 4. Auto-install in target project
+    const installed = await installGitNexus(basePath);
+    if (installed && existsSync(targetBin)) {
+        resolvedBin = targetBin;
+        logger.debug("GitNexus resolved: auto-installed local bin", { bin: targetBin });
+        return resolvedBin;
+    }
+    logger.warn("GitNexus binary not found and auto-install failed");
+    return null;
+}
+// ── Core operations ─────────────────────────────────────
+/**
+ * Ensure codebase is analyzed by GitNexus.
+ * Skips if `.gitnexus/` already exists.
+ */
+export async function ensureGitNexusAnalyzed(basePath) {
+    if (!isGitRepo(basePath)) {
+        analyzePhase = "unavailable";
+        logger.info("No git repository found, skipping GitNexus analysis", { basePath });
+        return { skipped: true, reason: "No git repository found" };
+    }
+    if (isGitNexusIndexed(basePath)) {
+        analyzePhase = "ready";
+        logger.info("GitNexus index already exists, skipping analysis", { basePath });
+        return { skipped: true, reason: "Already indexed" };
+    }
+    const bin = await resolveGitNexusBin(basePath);
+    if (!bin) {
+        analyzePhase = "error";
+        return {
+            skipped: false,
+            success: false,
+            reason: "GitNexus binary not found. Install with: npm install gitnexus",
+        };
+    }
+    analyzePhase = "analyzing";
+    logger.info("Running GitNexus analyze", { basePath, bin });
+    try {
+        await execAsync(bin, ["analyze", basePath], {
+            timeout: 300_000,
+            cwd: basePath,
+        });
+        analyzePhase = "ready";
+        logger.success("GitNexus analysis complete", { basePath });
+        return { skipped: false, success: true, reason: "Analysis completed" };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        analyzePhase = "error";
+        logger.warn("GitNexus analysis failed", { basePath, error: message });
+        return { skipped: false, success: false, reason: `Analysis failed: ${message}` };
+    }
+}
+/**
+ * Start GitNexus serve as a child process on the given port.
+ * Returns immediately after spawning — does not wait for readiness.
+ */
+export async function startGitNexusServe(basePath, port) {
+    if (!isGitNexusIndexed(basePath)) {
+        logger.info("GitNexus not indexed, skipping serve", { basePath });
+        return { started: false, message: "Codebase not indexed. Run gitnexus analyze first." };
+    }
+    const alreadyRunning = await isGitNexusRunning(port);
+    if (alreadyRunning) {
+        logger.info("GitNexus already running", { port });
+        return { started: true, message: `GitNexus already running on port ${port}`, port };
+    }
+    if (serveProcess && !serveProcess.killed) {
+        logger.info("GitNexus serve process already spawned", { pid: serveProcess.pid });
+        return { started: true, message: "GitNexus serve process already active", port };
+    }
+    const bin = await resolveGitNexusBin(basePath);
+    if (!bin) {
+        return { started: false, message: "GitNexus binary not found. Install with: npm install gitnexus" };
+    }
+    try {
+        serveProcess = spawn(bin, ["serve", "--port", String(port)], {
+            cwd: basePath,
+            stdio: "pipe",
+            detached: false,
+        });
+        serveProcess.on("error", (err) => {
+            logger.error("GitNexus serve process error", { error: err.message });
+            serveProcess = null;
+        });
+        serveProcess.on("exit", (code) => {
+            logger.info("GitNexus serve process exited", { code });
+            serveProcess = null;
+        });
+        logger.success("GitNexus serve started", { port, pid: serveProcess.pid });
+        return { started: true, message: `GitNexus serve started on port ${port}`, port };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        logger.error("Failed to start GitNexus serve", { error: message });
+        return { started: false, message: `Failed to start: ${message}` };
+    }
+}
+/**
+ * Stop the GitNexus serve child process if running.
+ */
+export async function stopGitNexus() {
+    if (!serveProcess || serveProcess.killed) {
+        serveProcess = null;
+        return;
+    }
+    logger.info("Stopping GitNexus serve", { pid: serveProcess.pid });
+    killProcess(serveProcess);
+    serveProcess = null;
+}
+//# sourceMappingURL=gitnexus-launcher.js.map

package/dist/core/integrations/gitnexus-launcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gitnexus-launcher.js","sourceRoot":"","sources":["../../../src/core/integrations/gitnexus-launcher.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAqB,MAAM,oBAAoB,CAAC;AACxE,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,OAAO,EAAE,UAAU,IAAI,MAAM,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAEzE,MAAM,SAAS,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;AAEtC,MAAM,YAAY,GAAG,WAAW,CAAC;AACjC,MAAM,YAAY,GAAG,UAAU,CAAC;AAEhC,IAAI,YAAY,GAAwB,IAAI,CAAC;AAC7C,IAAI,WAAW,GAAkB,IAAI,CAAC;AAItC,IAAI,YAAY,GAAiB,MAAM,CAAC;AAExC;;GAEG;AACH,MAAM,UAAU,eAAe;IAC7B,OAAO,YAAY,CAAC;AACtB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB;IAC/B,YAAY,GAAG,MAAM,CAAC;IACtB,WAAW,GAAG,IAAI,CAAC;AACrB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,SAAS,CAAC,QAAgB;IACxC,OAAO,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC;AACjD,CAAC;AAcD;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,QAAgB;IAChD,OAAO,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC,CAAC;AACvD,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,IAAY;IAClD,IAAI,CAAC;QACH,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;QACzC,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,IAAI,CAAC,CAAC;QACzD,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,oBAAoB,IAAI,EAAE,EAAE,EAAE,MAAM,EAAE,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC;QACnF,YAAY,CAAC,KAAK,CAAC,CAAC;QACpB,OAAO,GAAG,CAAC,EAAE,IAAI,GAAG,CAAC,MAAM,GAAG,GAAG,CAAC;IACpC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,6DAA6D;AAE7D,MAAM,UAAU,GAAG,MAAM,CAAC;AAE1B,SAAS,QAAQ,CAAC,GAAW;IAC3B,MAAM,OAAO,GAAG,UAAU,CAAC,CAAC,CAAC,GAAG,YAAY,MAAM,CAAC,CAAC,CAAC,YAAY,CAAC;IAClE,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,cAAc,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;AACzD,CAAC;AAED,SAAS,YAAY;IACnB,MAAM,QAAQ,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAChD,0EAA0E;IAC1E,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;AAChE,CAAC;AAED,KAAK,UAAU,aAAa;IAC1B,MAAM,GAAG,GAAG,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC;IAC3C,IAAI,CAAC;QACH,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,SAAS,CAAC,GAAG,EAAE,CAAC,YAAY,CAAC,CAAC,CAAC;QACxD,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;QAC5C,OAAO,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;IACrC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,KAAK,UAAU,eAAe,CAAC,QAAgB;IAC7C,MAAM,CAAC,IAAI,CAAC,4CAA4C,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC;IACxE,IAAI,CAAC;QACH,MAAM,SAAS,CAAC,KAAK,EAAE,CAAC,SAAS,EAAE,WAAW,EAAE,YAAY,CAAC,EAAE;YAC7D,GAAG,EAAE,QAAQ;YACb,OAAO,EAAE,OAAO;SACjB,CAAC,CAAC;QACH,MAAM,CAAC,OAAO,CAAC,iCAAiC,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC;QAChE,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC7D,MAAM,CAAC,IAAI,CAAC,iCAAiC,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,CAAC;QAC/D,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,QAAgB;IACvD,IAAI,WAAW,IAAI,UAAU,CAAC,WAAW,CAAC;QAAE,OAAO,WAAW,CAAC;IAE/D,iCAAiC;IACjC,MAAM,SAAS,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC;IACrC,IAAI,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAC1B,WAAW,GAAG,SAAS,CAAC;QACxB,MAAM,CAAC,KAAK,CAAC,6CAA6C,EAAE,EAAE,GAAG,EAAE,SAAS,EAAE,CAAC,CAAC;QAChF,OAAO,WAAW,CAAC;IACrB,CAAC;IAED,8CAA8C;IAC9C,MAAM,MAAM,GAAG,QAAQ,CAAC,YAAY,EAAE,CAAC,CAAC;IACxC,IAAI,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;QACvB,WAAW,GAAG,MAAM,CAAC;QACrB,MAAM,CAAC,KAAK,CAAC,wCAAwC,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC,CAAC;QACxE,OAAO,WAAW,CAAC;IACrB,CAAC;IAED,2BAA2B;IAC3B,MAAM,SAAS,GAAG,MAAM,aAAa,EAAE,CAAC;IACxC,IAAI,SAAS,EAAE,CAAC;QACd,WAAW,GAAG,SAAS,CAAC;QACxB,MAAM,CAAC,KAAK,CAAC,kCAAkC,EAAE,EAAE,GAAG,EAAE,SAAS,EAAE,CAAC,CAAC;QACrE,OAAO,WAAW,CAAC;IACrB,CAAC;IAED,oCAAoC;IACpC,MAAM,SAAS,GAAG,MAAM,eAAe,CAAC,QAAQ,CAAC,CAAC;IAClD,IAAI,SAAS,IAAI,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QACvC,WAAW,GAAG,SAAS,CAAC;QACxB,MAAM,CAAC,KAAK,CAAC,6CAA6C,EAAE,EAAE,GAAG,EAAE,SAAS,EAAE,CAAC,CAAC;QAChF,OAAO,WAAW,CAAC;IACrB,CAAC;IAED,MAAM,CAAC,IAAI,CAAC,mDAAmD,CAAC,CAAC;IACjE,OAAO,IAAI,CAAC;AACd,CAAC;AAED,2DAA2D;AAE3D;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,QAAgB;IAC3D,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,EAAE,CAAC;QACzB,YAAY,GAAG,aAAa,CAAC;QAC7B,MAAM,CAAC,IAAI,CAAC,qDAAqD,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC;QACjF,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,yBAAyB,EAAE,CAAC;IAC9D,CAAC;IAED,IAAI,iBAAiB,CAAC,QAAQ,CAAC,EAAE,CAAC;QAChC,YAAY,GAAG,OAAO,CAAC;QACvB,MAAM,CAAC,IAAI,CAAC,kDAAkD,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC;QAC9E,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,iBAAiB,EAAE,CAAC;IACtD,CAAC;IAED,MAAM,GAAG,GAAG,MAAM,kBAAkB,CAAC,QAAQ,CAAC,CAAC;IAC/C,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,YAAY,GAAG,OAAO,CAAC;QACvB,OAAO;YACL,OAAO,EAAE,KAAK;YACd,OAAO,EAAE,KAAK;YACd,MAAM,EAAE,+DAA+D;SACxE,CAAC;IACJ,CAAC;IAED,YAAY,GAAG,WAAW,CAAC;IAC3B,MAAM,CAAC,IAAI,CAAC,0BAA0B,EAAE,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC,CAAC;IAE3D,IAAI,CAAC;QACH,MAAM,SAAS,CAAC,GAAG,EAAE,CAAC,SAAS,EAAE,QAAQ,CAAC,EAAE;YAC1C,OAAO,EAAE,OAAO;YAChB,GAAG,EAAE,QAAQ;SACd,CAAC,CAAC;QAEH,YAAY,GAAG,OAAO,CAAC;QACvB,MAAM,CAAC,OAAO,CAAC,4BAA4B,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC;QAC3D,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,oBAAoB,EAAE,CAAC;IACzE,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACjE,YAAY,GAAG,OAAO,CAAC;QACvB,MAAM,CAAC,IAAI,CAAC,0BAA0B,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;QACtE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,oBAAoB,OAAO,EAAE,EAAE,CAAC;IACnF,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,QAAgB,EAAE,IAAY;IACrE,IAAI,CAAC,iBAAiB,CAAC,QAAQ,CAAC,EAAE,CAAC;QACjC,MAAM,CAAC,IAAI,CAAC,sCAAsC,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC;QAClE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,mDAAmD,EAAE,CAAC;IAC1F,CAAC;IAED,MAAM,cAAc,GAAG,MAAM,iBAAiB,CAAC,IAAI,CAAC,CAAC;IACrD,IAAI,cAAc,EAAE,CAAC;QACnB,MAAM,CAAC,IAAI,CAAC,0BAA0B,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;QAClD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,oCAAoC,IAAI,EAAE,EAAE,IAAI,EAAE,CAAC;IACtF,CAAC;IAED,IAAI,YAAY,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,CAAC;QACzC,MAAM,CAAC,IAAI,CAAC,wCAAwC,EAAE,EAAE,GAAG,EAAE,YAAY,CAAC,GAAG,EAAE,CAAC,CAAC;QACjF,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,uCAAuC,EAAE,IAAI,EAAE,CAAC;IACnF,CAAC;IAED,MAAM,GAAG,GAAG,MAAM,kBAAkB,CAAC,QAAQ,CAAC,CAAC;IAC/C,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,+DAA+D,EAAE,CAAC;IACtG,CAAC;IAED,IAAI,CAAC;QACH,YAAY,GAAG,KAAK,CAAC,GAAG,EAAE,CAAC,OAAO,EAAE,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,EAAE;YAC3D,GAAG,EAAE,QAAQ;YACb,KAAK,EAAE,MAAM;YACb,QAAQ,EAAE,KAAK;SAChB,CAAC,CAAC;QAEH,YAAY,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;YAC/B,MAAM,CAAC,KAAK,CAAC,8BAA8B,EAAE,EAAE,KAAK,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;YACrE,YAAY,GAAG,IAAI,CAAC;QACtB,CAAC,CAAC,CAAC;QAEH,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE;YAC/B,MAAM,CAAC,IAAI,CAAC,+BAA+B,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;YACvD,YAAY,GAAG,IAAI,CAAC;QACtB,CAAC,CAAC,CAAC;QAEH,MAAM,CAAC,OAAO,CAAC,wBAAwB,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,YAAY,CAAC,GAAG,EAAE,CAAC,CAAC;QAC1E,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,kCAAkC,IAAI,EAAE,EAAE,IAAI,EAAE,CAAC;IACpF,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACjE,MAAM,CAAC,KAAK,CAAC,gCAAgC,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;QACnE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,oBAAoB,OAAO,EAAE,EAAE,CAAC;IACpE,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY;IAChC,IAAI,CAAC,YAAY,IAAI,YAAY,CAAC,MAAM,EAAE,CAAC;QACzC,YAAY,GAAG,IAAI,CAAC;QACpB,OAAO;IACT,CAAC;IAED,MAAM,CAAC,IAAI,CAAC,yBAAyB,EAAE,EAAE,GAAG,EAAE,YAAY,CAAC,GAAG,EAAE,CAAC,CAAC;IAElE,WAAW,CAAC,YAAY,CAAC,CAAC;IAE1B,YAAY,GAAG,IAAI,CAAC;AACtB,CAAC"}

package/dist/core/integrations/gitnexus-queries.d.ts

@@ -0,0 +1,55 @@
+/**
+ * GitNexus query builders and response parsers.
+ * Converts symbol names into Cypher queries and parses GitNexus responses
+ * into structured CodeGraphData and ImpactResult formats.
+ */
+export interface CodeSymbol {
+    name: string;
+    kind: string;
+    file?: string;
+    startLine?: number;
+    endLine?: number;
+    metadata?: Record<string, unknown>;
+}
+export interface CodeRelation {
+    from: string;
+    to: string;
+    type: string;
+}
+export interface CodeGraphData {
+    symbols: CodeSymbol[];
+    relations: CodeRelation[];
+}
+export interface AffectedSymbol {
+    name: string;
+    file: string;
+    confidence: number;
+}
+export type RiskLevel = "low" | "medium" | "high";
+export interface ImpactResult {
+    symbol: string;
+    affectedSymbols: AffectedSymbol[];
+    riskLevel: RiskLevel;
+}
+/**
+ * Build a Cypher query to retrieve a symbol's context (related symbols and relations).
+ */
+export declare function buildContextQuery(symbol: string): string;
+/**
+ * Build a Cypher query for upstream impact analysis (who depends on this symbol).
+ */
+export declare function buildImpactQuery(symbol: string): string;
+/**
+ * Calculate risk level based on number of affected symbols.
+ */
+export declare function calculateRiskLevel(affectedCount: number): RiskLevel;
+/**
+ * Parse a GitNexus Cypher response into CodeGraphData.
+ * Handles the { result: [...] } format from GitNexus query endpoint.
+ */
+export declare function parseContextResponse(raw: unknown): CodeGraphData;
+/**
+ * Parse a GitNexus Cypher impact response into ImpactResult.
+ */
+export declare function parseImpactResponse(raw: unknown, symbol: string): ImpactResult;
+//# sourceMappingURL=gitnexus-queries.d.ts.map

package/dist/core/integrations/gitnexus-queries.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gitnexus-queries.d.ts","sourceRoot":"","sources":["../../../src/core/integrations/gitnexus-queries.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,SAAS,EAAE,YAAY,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,MAAM,SAAS,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;AAElD,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,eAAe,EAAE,cAAc,EAAE,CAAC;IAClC,SAAS,EAAE,SAAS,CAAC;CACtB;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAIxD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAGvD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,aAAa,EAAE,MAAM,GAAG,SAAS,CAInE;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,OAAO,GAAG,aAAa,CA4DhE;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,YAAY,CA+B9E"}