@intrect/openswarm 0.2.0

package/dist/knowledge/analyzer.d.ts

@@ -0,0 +1,36 @@
+import type { KnowledgeGraph } from './graph.js';
+import type { ImpactAnalysis, ProjectSummary } from './types.js';
+/**
+ * Analyze issue text to identify affected modules
+ */
+export declare function analyzeIssueImpact(graph: KnowledgeGraph, issueTitle: string, issueDescription?: string): ImpactAnalysis;
+export interface ModuleHealth {
+    moduleId: string;
+    hasTests: boolean;
+    dependentCount: number;
+    importCount: number;
+    churnScore: number;
+    loc: number;
+    risk: 'low' | 'medium' | 'high';
+}
+/**
+ * Health check for an individual module
+ */
+export declare function getModuleHealth(graph: KnowledgeGraph, moduleId: string): ModuleHealth | null;
+export interface ReviewFocus {
+    criticalModules: string[];
+    suggestedTests: string[];
+    reasons: string[];
+}
+/**
+ * Suggest review focus based on changed files
+ */
+export declare function suggestReviewFocus(graph: KnowledgeGraph, changedFiles: string[]): ReviewFocus;
+/**
+ * Overall project health summary
+ */
+export declare function getProjectHealth(graph: KnowledgeGraph): {
+    summary: ProjectSummary;
+    riskModules: ModuleHealth[];
+};
+//# sourceMappingURL=analyzer.d.ts.map

package/dist/knowledge/analyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyzer.d.ts","sourceRoot":"","sources":["../../src/knowledge/analyzer.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAIjE;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,cAAc,EACrB,UAAU,EAAE,MAAM,EAClB,gBAAgB,CAAC,EAAE,MAAM,GACxB,cAAc,CAoEhB;AAID,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;CACjC;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAmC5F;AAID,MAAM,WAAW,WAAW;IAC1B,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,cAAc,EACrB,YAAY,EAAE,MAAM,EAAE,GACrB,WAAW,CAuCb;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,cAAc,GAAG;IACvD,OAAO,EAAE,cAAc,CAAC;IACxB,WAAW,EAAE,YAAY,EAAE,CAAC;CAC7B,CAmBA"}

package/dist/knowledge/analyzer.js

@@ -0,0 +1,170 @@
+// ============================================
+// OpenSwarm - Knowledge Graph Analyzer
+// Issue impact analysis, module health, review focus
+// ============================================
+// Issue Impact Analysis
+/**
+ * Analyze issue text to identify affected modules
+ */
+export function analyzeIssueImpact(graph, issueTitle, issueDescription) {
+    const text = `${issueTitle} ${issueDescription ?? ''}`.toLowerCase();
+    // Step 1: Find modules directly referenced in issue text
+    const directModules = [];
+    const allModules = graph.getNodesByType('module');
+    for (const mod of allModules) {
+        // Match by filename, path segment, or module name
+        const name = mod.name.replace(/\.[^.]+$/, ''); // Remove extension
+        const pathParts = mod.path.split('/');
+        // Filename matching (e.g., "decisionEngine" → decisionEngine.ts)
+        if (text.includes(name.toLowerCase())) {
+            directModules.push(mod.id);
+            continue;
+        }
+        // camelCase → word-split matching (e.g., "decision engine" → decisionEngine.ts)
+        const words = name.replace(/([A-Z])/g, ' $1').toLowerCase().trim();
+        if (words.includes(' ') && text.includes(words)) {
+            directModules.push(mod.id);
+            continue;
+        }
+        // Directory/file path matching (e.g., "orchestration/taskParser")
+        if (pathParts.length >= 2) {
+            const pathRef = pathParts.slice(-2).join('/').toLowerCase().replace(/\.[^.]+$/, '');
+            if (text.includes(pathRef)) {
+                directModules.push(mod.id);
+            }
+        }
+    }
+    // Step 2: Find modules that import the direct modules
+    const dependentModules = new Set();
+    for (const modId of directModules) {
+        const deps = graph.getDependents(modId);
+        for (const dep of deps) {
+            if (!directModules.includes(dep.id)) {
+                dependentModules.add(dep.id);
+            }
+        }
+    }
+    // Step 3: Find related test files
+    const testFiles = new Set();
+    const allAffected = [...directModules, ...dependentModules];
+    for (const modId of allAffected) {
+        const tests = graph.getTests(modId);
+        for (const test of tests) {
+            testFiles.add(test.id);
+        }
+    }
+    // Step 4: Estimate impact scope
+    const totalAffected = directModules.length + dependentModules.size;
+    let estimatedScope;
+    if (totalAffected <= 2)
+        estimatedScope = 'small';
+    else if (totalAffected <= 8)
+        estimatedScope = 'medium';
+    else
+        estimatedScope = 'large';
+    return {
+        directModules,
+        dependentModules: Array.from(dependentModules),
+        testFiles: Array.from(testFiles),
+        estimatedScope,
+    };
+}
+/**
+ * Health check for an individual module
+ */
+export function getModuleHealth(graph, moduleId) {
+    const mod = graph.getNode(moduleId);
+    if (!mod || (mod.type !== 'module' && mod.type !== 'test_file'))
+        return null;
+    const tests = graph.getTests(moduleId);
+    const dependents = graph.getDependents(moduleId);
+    const imports = graph.getImports(moduleId);
+    const hasTests = tests.length > 0;
+    const dependentCount = dependents.length;
+    const importCount = imports.length;
+    const churnScore = mod.gitInfo?.churnScore ?? 0;
+    const loc = mod.metrics?.loc ?? 0;
+    // Risk assessment
+    let risk = 'low';
+    // High churn + no tests → high
+    if (churnScore > 0.5 && !hasTests)
+        risk = 'high';
+    // Many dependents + no tests → high
+    else if (dependentCount >= 5 && !hasTests)
+        risk = 'high';
+    // High churn or many dependents → medium
+    else if (churnScore > 0.3 || dependentCount >= 3)
+        risk = 'medium';
+    // Large file without tests → medium
+    else if (!hasTests && loc > 200)
+        risk = 'medium';
+    return {
+        moduleId,
+        hasTests,
+        dependentCount,
+        importCount,
+        churnScore,
+        loc,
+        risk,
+    };
+}
+/**
+ * Suggest review focus based on changed files
+ */
+export function suggestReviewFocus(graph, changedFiles) {
+    const criticalModules = [];
+    const suggestedTests = new Set();
+    const reasons = [];
+    for (const file of changedFiles) {
+        const mod = graph.getNode(file);
+        if (!mod)
+            continue;
+        // Files with many dependents → focus review
+        const dependents = graph.getDependents(file);
+        if (dependents.length >= 3) {
+            criticalModules.push(file);
+            reasons.push(`${mod.name}: ${dependents.length} modules depend on this — wide impact`);
+        }
+        // Frequently changed files → attention needed
+        if (mod.gitInfo && mod.gitInfo.churnScore > 0.5) {
+            if (!criticalModules.includes(file))
+                criticalModules.push(file);
+            reasons.push(`${mod.name}: frequent recent changes (churn=${mod.gitInfo.churnScore})`);
+        }
+        // Collect related tests
+        const tests = graph.getTests(file);
+        for (const t of tests) {
+            suggestedTests.add(t.id);
+        }
+        // Warning for changed files without tests
+        if (tests.length === 0 && mod.type === 'module') {
+            reasons.push(`${mod.name}: no tests — manual verification required`);
+        }
+    }
+    return {
+        criticalModules,
+        suggestedTests: Array.from(suggestedTests),
+        reasons,
+    };
+}
+/**
+ * Overall project health summary
+ */
+export function getProjectHealth(graph) {
+    const summary = graph.buildSummary();
+    const modules = graph.getNodesByType('module');
+    const riskModules = [];
+    for (const mod of modules) {
+        const health = getModuleHealth(graph, mod.id);
+        if (health && health.risk !== 'low') {
+            riskModules.push(health);
+        }
+    }
+    // Sort by risk level (high → medium)
+    riskModules.sort((a, b) => {
+        const order = { high: 0, medium: 1, low: 2 };
+        return order[a.risk] - order[b.risk];
+    });
+    return { summary, riskModules };
+}
+//# sourceMappingURL=analyzer.js.map

package/dist/knowledge/analyzer.js.map

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

package/dist/knowledge/gitInfo.d.ts

@@ -0,0 +1,10 @@
+import type { KnowledgeGraph } from './graph.js';
+/**
+ * Enrich all modules in the graph with Git info
+ */
+export declare function enrichWithGitInfo(graph: KnowledgeGraph, projectPath: string, sinceDays?: number): Promise<void>;
+/**
+ * List of recently changed files (for incremental update trigger)
+ */
+export declare function getRecentlyChangedFiles(projectPath: string, sinceTimestamp: number): Promise<string[]>;
+//# sourceMappingURL=gitInfo.d.ts.map

package/dist/knowledge/gitInfo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gitInfo.d.ts","sourceRoot":"","sources":["../../src/knowledge/gitInfo.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAyFjD;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,cAAc,EACrB,WAAW,EAAE,MAAM,EACnB,SAAS,GAAE,MAAW,GACrB,OAAO,CAAC,IAAI,CAAC,CAiCf;AAED;;GAEG;AACH,wBAAsB,uBAAuB,CAC3C,WAAW,EAAE,MAAM,EACnB,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,MAAM,EAAE,CAAC,CAoBnB"}

package/dist/knowledge/gitInfo.js

@@ -0,0 +1,134 @@
+// ============================================
+// OpenSwarm - Git Info for Knowledge Graph
+// Git log based churn score, recent changes, contributor tracking
+// ============================================
+import { spawn } from 'node:child_process';
+// Git Command Runner (same pattern as gitTracker.ts)
+function runGitCommand(cwd, args, timeoutMs = 10_000) {
+    return new Promise((resolve, reject) => {
+        const proc = spawn('git', args, { cwd });
+        let stdout = '';
+        let stderr = '';
+        proc.stdout.on('data', (data) => { stdout += data.toString(); });
+        proc.stderr.on('data', (data) => { stderr += data.toString(); });
+        const timer = setTimeout(() => {
+            proc.kill();
+            reject(new Error(`git command timed out after ${timeoutMs}ms`));
+        }, timeoutMs);
+        proc.on('close', (code) => {
+            clearTimeout(timer);
+            if (code === 0)
+                resolve(stdout);
+            else
+                reject(new Error(`git ${args.join(' ')} failed: ${stderr}`));
+        });
+        proc.on('error', (err) => {
+            clearTimeout(timer);
+            reject(err);
+        });
+    });
+}
+/**
+ * Calculate per-file commit count over the last 30 days
+ */
+async function getFileChurns(projectPath, sinceDays = 30) {
+    const churns = new Map();
+    try {
+        // git log --since="30 days ago" --name-only --format="%ct"
+        const output = await runGitCommand(projectPath, [
+            'log',
+            `--since=${sinceDays} days ago`,
+            '--name-only',
+            '--format=%ct',
+        ]);
+        let currentTimestamp = 0;
+        for (const line of output.split('\n')) {
+            const trimmed = line.trim();
+            if (!trimmed)
+                continue;
+            // If numeric, it's a commit timestamp
+            if (/^\d+$/.test(trimmed)) {
+                currentTimestamp = parseInt(trimmed, 10) * 1000; // Convert to ms
+                continue;
+            }
+            // File path
+            const existing = churns.get(trimmed);
+            if (existing) {
+                existing.commitCount++;
+                if (currentTimestamp > existing.lastCommitDate) {
+                    existing.lastCommitDate = currentTimestamp;
+                }
+            }
+            else {
+                churns.set(trimmed, {
+                    path: trimmed,
+                    commitCount: 1,
+                    lastCommitDate: currentTimestamp,
+                });
+            }
+        }
+    }
+    catch (err) {
+        console.warn(`[GitInfo] Failed to get file churns:`, err);
+    }
+    return churns;
+}
+/**
+ * Enrich all modules in the graph with Git info
+ */
+export async function enrichWithGitInfo(graph, projectPath, sinceDays = 30) {
+    const churns = await getFileChurns(projectPath, sinceDays);
+    if (churns.size === 0)
+        return;
+    // Maximum value for churn score normalization
+    const maxCommits = Math.max(...Array.from(churns.values()).map(c => c.commitCount), 1);
+    const modules = [
+        ...graph.getNodesByType('module'),
+        ...graph.getNodesByType('test_file'),
+    ];
+    for (const mod of modules) {
+        const churn = churns.get(mod.path);
+        if (churn) {
+            const gitInfo = {
+                lastCommitDate: churn.lastCommitDate,
+                commitCount30d: churn.commitCount,
+                churnScore: Math.round((churn.commitCount / maxCommits) * 1000) / 1000,
+            };
+            mod.gitInfo = gitInfo;
+        }
+        else {
+            // File not in git history (no changes in 30 days)
+            mod.gitInfo = {
+                lastCommitDate: 0,
+                commitCount30d: 0,
+                churnScore: 0,
+            };
+        }
+    }
+    console.log(`[GitInfo] Enriched ${modules.length} modules with git data (${churns.size} files had changes in ${sinceDays}d)`);
+}
+/**
+ * List of recently changed files (for incremental update trigger)
+ */
+export async function getRecentlyChangedFiles(projectPath, sinceTimestamp) {
+    try {
+        const sinceDate = new Date(sinceTimestamp).toISOString();
+        const output = await runGitCommand(projectPath, [
+            'log',
+            `--since=${sinceDate}`,
+            '--name-only',
+            '--format=',
+        ]);
+        const files = new Set();
+        for (const line of output.split('\n')) {
+            const trimmed = line.trim();
+            if (trimmed)
+                files.add(trimmed);
+        }
+        return Array.from(files);
+    }
+    catch {
+        return [];
+    }
+}
+//# sourceMappingURL=gitInfo.js.map

package/dist/knowledge/gitInfo.js.map

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

package/dist/knowledge/graph.d.ts

@@ -0,0 +1,45 @@
+import type { GraphNode, GraphEdge, EdgeType, NodeType, ProjectSummary, SerializedGraph } from './types.js';
+export declare class KnowledgeGraph {
+    private nodes;
+    private edges;
+    private adjacency;
+    private reverseAdjacency;
+    readonly projectSlug: string;
+    readonly projectPath: string;
+    scannedAt: number;
+    constructor(projectSlug: string, projectPath: string);
+    addNode(node: GraphNode): void;
+    getNode(id: string): GraphNode | undefined;
+    hasNode(id: string): boolean;
+    removeNode(id: string): void;
+    getAllNodes(): GraphNode[];
+    getNodesByType(type: NodeType): GraphNode[];
+    addEdge(edge: GraphEdge): void;
+    getAllEdges(): GraphEdge[];
+    /** Remove only specified edge types from a node's outgoing edges (with adjacency sync) */
+    removeOutgoingEdges(nodeId: string, types: EdgeType[]): void;
+    /** Child nodes contained by a specific node (contains edges) */
+    getChildren(nodeId: string): GraphNode[];
+    /** Modules imported by a specific module */
+    getImports(nodeId: string): GraphNode[];
+    /** Modules that import a specific module (reverse direction) */
+    getDependents(nodeId: string): GraphNode[];
+    /** Test files for a specific module */
+    getTests(nodeId: string): GraphNode[];
+    /** Modules tested by a specific test file */
+    getTestedModules(testNodeId: string): GraphNode[];
+    /** Nodes connected by a specific edge type */
+    getConnected(nodeId: string, edgeType: EdgeType, direction?: 'outgoing' | 'incoming'): GraphNode[];
+    /** Transitive dependency traversal (BFS) */
+    getTransitiveDependents(nodeId: string, maxDepth?: number): GraphNode[];
+    /** Search by module name or path segment */
+    findModules(query: string): GraphNode[];
+    /** Build project summary */
+    buildSummary(): ProjectSummary;
+    serialize(): SerializedGraph;
+    static deserialize(data: SerializedGraph): KnowledgeGraph;
+    clear(): void;
+    get nodeCount(): number;
+    get edgeCount(): number;
+}
+//# sourceMappingURL=graph.d.ts.map

package/dist/knowledge/graph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph.d.ts","sourceRoot":"","sources":["../../src/knowledge/graph.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAI5G,qBAAa,cAAc;IACzB,OAAO,CAAC,KAAK,CAAgC;IAC7C,OAAO,CAAC,KAAK,CAAmB;IAGhC,OAAO,CAAC,SAAS,CAAkC;IAEnD,OAAO,CAAC,gBAAgB,CAAkC;IAE1D,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,SAAS,EAAE,MAAM,CAAK;gBAEV,WAAW,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM;IASpD,OAAO,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI;IAU9B,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS;IAI1C,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAI5B,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAiB5B,WAAW,IAAI,SAAS,EAAE;IAI1B,cAAc,CAAC,IAAI,EAAE,QAAQ,GAAG,SAAS,EAAE;IAQ3C,OAAO,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI;IAkB9B,WAAW,IAAI,SAAS,EAAE;IAI1B,0FAA0F;IAC1F,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,IAAI;IAgC5D,gEAAgE;IAChE,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,EAAE;IAQxC,4CAA4C;IAC5C,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,EAAE;IAQvC,gEAAgE;IAChE,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,EAAE;IAQ1C,uCAAuC;IACvC,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,EAAE;IAQrC,6CAA6C;IAC7C,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,EAAE;IAQjD,8CAA8C;IAC9C,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,SAAS,GAAE,UAAU,GAAG,UAAuB,GAAG,SAAS,EAAE;IAW9G,4CAA4C;IAC5C,uBAAuB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAU,GAAG,SAAS,EAAE;IA0B1E,4CAA4C;IAC5C,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE;IAQvC,4BAA4B;IAC5B,YAAY,IAAI,cAAc;IA0C9B,SAAS,IAAI,eAAe;IAY5B,MAAM,CAAC,WAAW,CAAC,IAAI,EAAE,eAAe,GAAG,cAAc;IAgBzD,KAAK,IAAI,IAAI;IAOb,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED,IAAI,SAAS,IAAI,MAAM,CAEtB;CACF"}