@intrect/openswarm 0.2.0

package/dist/knowledge/graph.js

@@ -0,0 +1,262 @@
+// ============================================
+// OpenSwarm - Knowledge Graph
+// In-memory graph with adjacency list + traversal
+// ============================================
+// KnowledgeGraph Class
+export class KnowledgeGraph {
+    nodes = new Map();
+    edges = [];
+    // Adjacency list: nodeId → outgoing edges
+    adjacency = new Map();
+    // Reverse adjacency list: nodeId → incoming edges
+    reverseAdjacency = new Map();
+    projectSlug;
+    projectPath;
+    scannedAt = 0;
+    constructor(projectSlug, projectPath) {
+        this.projectSlug = projectSlug;
+        this.projectPath = projectPath;
+    }
+    // ============================================
+    // Node Operations
+    // ============================================
+    addNode(node) {
+        this.nodes.set(node.id, node);
+        if (!this.adjacency.has(node.id)) {
+            this.adjacency.set(node.id, []);
+        }
+        if (!this.reverseAdjacency.has(node.id)) {
+            this.reverseAdjacency.set(node.id, []);
+        }
+    }
+    getNode(id) {
+        return this.nodes.get(id);
+    }
+    hasNode(id) {
+        return this.nodes.has(id);
+    }
+    removeNode(id) {
+        this.nodes.delete(id);
+        // Remove related edges
+        this.edges = this.edges.filter(e => e.source !== id && e.target !== id);
+        this.adjacency.delete(id);
+        this.reverseAdjacency.delete(id);
+        // Also remove from other nodes' adjacency lists
+        for (const [key, edges] of this.adjacency) {
+            const filtered = edges.filter(e => e.target !== id);
+            if (filtered.length !== edges.length)
+                this.adjacency.set(key, filtered);
+        }
+        for (const [key, edges] of this.reverseAdjacency) {
+            const filtered = edges.filter(e => e.source !== id);
+            if (filtered.length !== edges.length)
+                this.reverseAdjacency.set(key, filtered);
+        }
+    }
+    getAllNodes() {
+        return Array.from(this.nodes.values());
+    }
+    getNodesByType(type) {
+        return this.getAllNodes().filter(n => n.type === type);
+    }
+    // ============================================
+    // Edge Operations
+    // ============================================
+    addEdge(edge) {
+        // Prevent duplicates
+        const exists = this.edges.some(e => e.source === edge.source && e.target === edge.target && e.type === edge.type);
+        if (exists)
+            return;
+        this.edges.push(edge);
+        const outEdges = this.adjacency.get(edge.source);
+        if (outEdges)
+            outEdges.push(edge);
+        else
+            this.adjacency.set(edge.source, [edge]);
+        const inEdges = this.reverseAdjacency.get(edge.target);
+        if (inEdges)
+            inEdges.push(edge);
+        else
+            this.reverseAdjacency.set(edge.target, [edge]);
+    }
+    getAllEdges() {
+        return this.edges;
+    }
+    /** Remove only specified edge types from a node's outgoing edges (with adjacency sync) */
+    removeOutgoingEdges(nodeId, types) {
+        const typeSet = new Set(types);
+        // Collect removal targets
+        const toRemove = this.edges.filter(e => e.source === nodeId && typeSet.has(e.type));
+        if (toRemove.length === 0)
+            return;
+        // Remove from main edge array
+        this.edges = this.edges.filter(e => !(e.source === nodeId && typeSet.has(e.type)));
+        // Sync adjacency map
+        const outEdges = this.adjacency.get(nodeId);
+        if (outEdges) {
+            this.adjacency.set(nodeId, outEdges.filter(e => !typeSet.has(e.type)));
+        }
+        // Sync reverseAdjacency map: remove incoming edges from removed edges' targets
+        for (const edge of toRemove) {
+            const inEdges = this.reverseAdjacency.get(edge.target);
+            if (inEdges) {
+                this.reverseAdjacency.set(edge.target, inEdges.filter(e => !(e.source === nodeId && typeSet.has(e.type))));
+            }
+        }
+    }
+    // ============================================
+    // Traversal Queries
+    // ============================================
+    /** Child nodes contained by a specific node (contains edges) */
+    getChildren(nodeId) {
+        const outEdges = this.adjacency.get(nodeId) ?? [];
+        return outEdges
+            .filter(e => e.type === 'contains')
+            .map(e => this.nodes.get(e.target))
+            .filter((n) => n !== undefined);
+    }
+    /** Modules imported by a specific module */
+    getImports(nodeId) {
+        const outEdges = this.adjacency.get(nodeId) ?? [];
+        return outEdges
+            .filter(e => e.type === 'imports')
+            .map(e => this.nodes.get(e.target))
+            .filter((n) => n !== undefined);
+    }
+    /** Modules that import a specific module (reverse direction) */
+    getDependents(nodeId) {
+        const inEdges = this.reverseAdjacency.get(nodeId) ?? [];
+        return inEdges
+            .filter(e => e.type === 'imports')
+            .map(e => this.nodes.get(e.source))
+            .filter((n) => n !== undefined);
+    }
+    /** Test files for a specific module */
+    getTests(nodeId) {
+        const inEdges = this.reverseAdjacency.get(nodeId) ?? [];
+        return inEdges
+            .filter(e => e.type === 'tests')
+            .map(e => this.nodes.get(e.source))
+            .filter((n) => n !== undefined);
+    }
+    /** Modules tested by a specific test file */
+    getTestedModules(testNodeId) {
+        const outEdges = this.adjacency.get(testNodeId) ?? [];
+        return outEdges
+            .filter(e => e.type === 'tests')
+            .map(e => this.nodes.get(e.target))
+            .filter((n) => n !== undefined);
+    }
+    /** Nodes connected by a specific edge type */
+    getConnected(nodeId, edgeType, direction = 'outgoing') {
+        const edgeList = direction === 'outgoing'
+            ? (this.adjacency.get(nodeId) ?? [])
+            : (this.reverseAdjacency.get(nodeId) ?? []);
+        return edgeList
+            .filter(e => e.type === edgeType)
+            .map(e => this.nodes.get(direction === 'outgoing' ? e.target : e.source))
+            .filter((n) => n !== undefined);
+    }
+    /** Transitive dependency traversal (BFS) */
+    getTransitiveDependents(nodeId, maxDepth = 5) {
+        const visited = new Set();
+        const result = [];
+        const queue = [{ id: nodeId, depth: 0 }];
+        while (queue.length > 0) {
+            const { id, depth } = queue.shift();
+            if (visited.has(id) || depth > maxDepth)
+                continue;
+            visited.add(id);
+            const dependents = this.getDependents(id);
+            for (const dep of dependents) {
+                if (!visited.has(dep.id)) {
+                    result.push(dep);
+                    queue.push({ id: dep.id, depth: depth + 1 });
+                }
+            }
+        }
+        return result;
+    }
+    // ============================================
+    // Analysis Queries
+    // ============================================
+    /** Search by module name or path segment */
+    findModules(query) {
+        const lower = query.toLowerCase();
+        return this.getAllNodes().filter(n => (n.type === 'module' || n.type === 'test_file') &&
+            (n.id.toLowerCase().includes(lower) || n.name.toLowerCase().includes(lower)));
+    }
+    /** Build project summary */
+    buildSummary() {
+        const modules = this.getNodesByType('module');
+        const testFiles = this.getNodesByType('test_file');
+        // Hot modules: top 5 by churn score
+        const hotModules = modules
+            .filter(m => m.gitInfo?.churnScore !== undefined)
+            .sort((a, b) => (b.gitInfo?.churnScore ?? 0) - (a.gitInfo?.churnScore ?? 0))
+            .slice(0, 5)
+            .map(m => m.id);
+        // Untested modules: modules with no test edges
+        const testedModuleIds = new Set(this.edges
+            .filter(e => e.type === 'tests')
+            .map(e => e.target));
+        const untestedModules = modules
+            .filter(m => !testedModuleIds.has(m.id))
+            .map(m => m.id);
+        // Average churn score
+        const churnScores = modules
+            .map(m => m.gitInfo?.churnScore ?? 0)
+            .filter(s => s > 0);
+        const avgChurnScore = churnScores.length > 0
+            ? churnScores.reduce((a, b) => a + b, 0) / churnScores.length
+            : 0;
+        return {
+            totalModules: modules.length,
+            totalTestFiles: testFiles.length,
+            hotModules,
+            untestedModules,
+            avgChurnScore: Math.round(avgChurnScore * 1000) / 1000,
+        };
+    }
+    // ============================================
+    // Serialization
+    // ============================================
+    serialize() {
+        return {
+            version: 1,
+            projectSlug: this.projectSlug,
+            projectPath: this.projectPath,
+            scannedAt: this.scannedAt,
+            nodes: this.getAllNodes(),
+            edges: this.getAllEdges(),
+            summary: this.buildSummary(),
+        };
+    }
+    static deserialize(data) {
+        const graph = new KnowledgeGraph(data.projectSlug, data.projectPath);
+        graph.scannedAt = data.scannedAt;
+        for (const node of data.nodes) {
+            graph.addNode(node);
+        }
+        for (const edge of data.edges) {
+            graph.addEdge(edge);
+        }
+        return graph;
+    }
+    // ============================================
+    // Utilities
+    // ============================================
+    clear() {
+        this.nodes.clear();
+        this.edges = [];
+        this.adjacency.clear();
+        this.reverseAdjacency.clear();
+    }
+    get nodeCount() {
+        return this.nodes.size;
+    }
+    get edgeCount() {
+        return this.edges.length;
+    }
+}
+//# sourceMappingURL=graph.js.map

package/dist/knowledge/graph.js.map

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

package/dist/knowledge/graphqlExporter.d.ts

@@ -0,0 +1,64 @@
+import type { KnowledgeGraph } from './graph.js';
+export interface RepoSnapshot {
+    schemaVersion: 1;
+    projectName: string;
+    projectPath: string;
+    scannedAt: string;
+    project: {
+        totalModules: number;
+        totalTests: number;
+        languages: {
+            language: string;
+            count: number;
+            loc: number;
+        }[];
+        layers: {
+            layer: string;
+            count: number;
+            modules: string[];
+        }[];
+        summary: {
+            avgChurnScore: number;
+            hotModules: string[];
+            untestedModules: string[];
+            stableCount: number;
+            experimentalCount: number;
+            deprecatedCount: number;
+        };
+    };
+    modules: {
+        id: string;
+        path: string;
+        name: string;
+        type: string;
+        layer: string;
+        language: string;
+        loc: number;
+        exports: number;
+        imports: number;
+        dependsOn: string[];
+        dependedBy: string[];
+        tests: string[];
+        churnScore: number | null;
+        commitCount30d: number | null;
+        lastCommitDate: string | null;
+        state: string | null;
+        techDebt: number | null;
+        isEntrypoint: boolean;
+        isHotspot: boolean;
+        risk: string;
+    }[];
+    circularDeps: {
+        modules: string[];
+        length: number;
+    }[];
+}
+export declare function buildSnapshot(graph: KnowledgeGraph, projectPath: string): RepoSnapshot;
+export declare function exportRepoGraph(graph: KnowledgeGraph, projectPath: string): {
+    schemaPath: string;
+    snapshotPath: string;
+};
+export declare function hasRepoSnapshot(projectPath: string): boolean;
+export declare function loadRepoSnapshot(projectPath: string): RepoSnapshot | null;
+export declare function snapshotAgeMinutes(projectPath: string): number | null;
+//# sourceMappingURL=graphqlExporter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"graphqlExporter.d.ts","sourceRoot":"","sources":["../../src/knowledge/graphqlExporter.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAgMjD,MAAM,WAAW,YAAY;IAC3B,aAAa,EAAE,CAAC,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAElB,OAAO,EAAE;QACP,YAAY,EAAE,MAAM,CAAC;QACrB,UAAU,EAAE,MAAM,CAAC;QACnB,SAAS,EAAE;YAAE,QAAQ,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAC;YAAC,GAAG,EAAE,MAAM,CAAA;SAAE,EAAE,CAAC;QAC9D,MAAM,EAAE;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,EAAE,CAAA;SAAE,EAAE,CAAC;QAC9D,OAAO,EAAE;YACP,aAAa,EAAE,MAAM,CAAC;YACtB,UAAU,EAAE,MAAM,EAAE,CAAC;YACrB,eAAe,EAAE,MAAM,EAAE,CAAC;YAC1B,WAAW,EAAE,MAAM,CAAC;YACpB,iBAAiB,EAAE,MAAM,CAAC;YAC1B,eAAe,EAAE,MAAM,CAAC;SACzB,CAAC;KACH,CAAC;IAEF,OAAO,EAAE;QACP,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,EAAE,MAAM,CAAC;QACjB,GAAG,EAAE,MAAM,CAAC;QACZ,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,EAAE,MAAM,EAAE,CAAC;QACpB,UAAU,EAAE,MAAM,EAAE,CAAC;QACrB,KAAK,EAAE,MAAM,EAAE,CAAC;QAChB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;QAC1B,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;QAC9B,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;QAC9B,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;QACrB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;QACxB,YAAY,EAAE,OAAO,CAAC;QACtB,SAAS,EAAE,OAAO,CAAC;QACnB,IAAI,EAAE,MAAM,CAAC;KACd,EAAE,CAAC;IAEJ,YAAY,EAAE;QAAE,OAAO,EAAE,MAAM,EAAE,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CACvD;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,GAAG,YAAY,CAoHtF;AAGD,wBAAgB,eAAe,CAAC,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,GAAG;IAC3E,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;CACtB,CAiBA;AAGD,wBAAgB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAE5D;AAGD,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAQzE;AAGD,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAIrE"}

package/dist/knowledge/graphqlExporter.js

@@ -0,0 +1,333 @@
+// OpenSwarm - GraphQL Schema Exporter
+// KnowledgeGraph → .openswarm/repo.graphql + repo-snapshot.json
+// 에이전트가 컨텍스트 윈도우 없이도 저장소를 완전히 이해할 수 있는 정적 파일 생성
+import { existsSync, mkdirSync, writeFileSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+// GraphQL 스키마 (고정 — 데이터 구조 정의)
+const REPO_SCHEMA = `# OpenSwarm Repository Graph Schema
+# 에이전트가 저장소를 이해하기 위한 정적 스키마
+# 데이터: repo-snapshot.json
+
+type Query {
+  project: Project!
+  module(id: ID!): Module
+  modules(layer: ArchLayer, language: Language): [Module!]!
+  entrypoints: [Module!]!
+  hotspots(limit: Int = 5): [Module!]!
+  untested: [Module!]!
+  circularDeps: [Cycle!]!
+  impactOf(moduleId: ID!): Impact!
+}
+
+type Project {
+  name: String!
+  path: String!
+  scannedAt: String!
+  totalModules: Int!
+  totalTests: Int!
+  languages: [LanguageBreakdown!]!
+  layers: [LayerBreakdown!]!
+  summary: ProjectSummary!
+}
+
+type Module {
+  id: ID!
+  path: String!
+  name: String!
+  type: NodeType!
+  layer: ArchLayer
+  language: Language!
+  loc: Int!
+  exports: Int!
+  imports: Int!
+  dependsOn: [Module!]!
+  dependedBy: [Module!]!
+  tests: [Module!]!
+  churnScore: Float
+  commitCount30d: Int
+  lastCommitDate: String
+  state: ModuleState
+  techDebt: Float
+  isEntrypoint: Boolean!
+  isHotspot: Boolean!
+  risk: RiskLevel!
+}
+
+type Impact {
+  direct: [Module!]!
+  transitive: [Module!]!
+  affectedTests: [Module!]!
+  scope: Scope!
+}
+
+type Cycle {
+  modules: [ID!]!
+  length: Int!
+}
+
+type ProjectSummary {
+  avgChurnScore: Float!
+  hotModules: [ID!]!
+  untestedModules: [ID!]!
+  stableCount: Int!
+  experimentalCount: Int!
+  deprecatedCount: Int!
+}
+
+type LanguageBreakdown {
+  language: Language!
+  count: Int!
+  loc: Int!
+}
+
+type LayerBreakdown {
+  layer: ArchLayer!
+  count: Int!
+  modules: [ID!]!
+}
+
+enum NodeType { PROJECT DIRECTORY MODULE TEST_FILE }
+enum Language { TYPESCRIPT PYTHON OTHER }
+enum ArchLayer { CORE AGENT ADAPTER AUTOMATION SUPPORT KNOWLEDGE ORCHESTRATION LINEAR DISCORD CLI LOCALE MEMORY TEST OTHER }
+enum ModuleState { STABLE EXPERIMENTAL DEPRECATED LEGACY PLANNED }
+enum RiskLevel { LOW MEDIUM HIGH }
+enum Scope { SMALL MEDIUM LARGE }
+`;
+// 아키텍처 레이어 추론
+function inferLayer(modulePath) {
+    const segments = modulePath.split('/');
+    const layerMap = {
+        core: 'CORE',
+        agents: 'AGENT',
+        adapters: 'ADAPTER',
+        automation: 'AUTOMATION',
+        support: 'SUPPORT',
+        knowledge: 'KNOWLEDGE',
+        orchestration: 'ORCHESTRATION',
+        linear: 'LINEAR',
+        discord: 'DISCORD',
+        cli: 'CLI',
+        locale: 'LOCALE',
+        memory: 'MEMORY',
+        runners: 'CLI',
+        taskState: 'CORE',
+        __tests__: 'TEST',
+    };
+    for (const seg of segments) {
+        if (layerMap[seg])
+            return layerMap[seg];
+    }
+    return 'OTHER';
+}
+// 리스크 계산
+function computeRisk(node, hasTests, dependentCount) {
+    const churn = node.gitInfo?.churnScore ?? 0;
+    const loc = node.metrics?.loc ?? 0;
+    if ((churn > 0.5 && !hasTests) || (dependentCount >= 5 && !hasTests))
+        return 'HIGH';
+    if (churn > 0.3 || dependentCount >= 3 || (loc > 200 && !hasTests))
+        return 'MEDIUM';
+    return 'LOW';
+}
+// 순환 의존성 탐지
+function detectCycles(nodes, edges) {
+    const importEdges = edges.filter(e => e.type === 'imports');
+    const adj = new Map();
+    for (const e of importEdges) {
+        if (!adj.has(e.source))
+            adj.set(e.source, []);
+        adj.get(e.source).push(e.target);
+    }
+    const cycles = [];
+    const visited = new Set();
+    const stack = new Set();
+    const path = [];
+    function dfs(node) {
+        if (stack.has(node)) {
+            const cycleStart = path.indexOf(node);
+            if (cycleStart >= 0) {
+                cycles.push(path.slice(cycleStart));
+            }
+            return;
+        }
+        if (visited.has(node))
+            return;
+        visited.add(node);
+        stack.add(node);
+        path.push(node);
+        for (const next of adj.get(node) ?? []) {
+            dfs(next);
+        }
+        path.pop();
+        stack.delete(node);
+    }
+    for (const node of adj.keys()) {
+        dfs(node);
+    }
+    // 중복 사이클 제거 (정규화: 사전순 최소 시작)
+    const seen = new Set();
+    return cycles.filter(cycle => {
+        const minIdx = cycle.indexOf(cycle.slice().sort()[0]);
+        const normalized = [...cycle.slice(minIdx), ...cycle.slice(0, minIdx)].join('→');
+        if (seen.has(normalized))
+            return false;
+        seen.add(normalized);
+        return true;
+    });
+}
+// 진입점 탐지 (아무도 import하지 않는 모듈)
+function findEntrypoints(nodes, edges) {
+    const imported = new Set(edges.filter(e => e.type === 'imports').map(e => e.target));
+    const entrypoints = new Set();
+    for (const node of nodes) {
+        if (node.type === 'module' && !imported.has(node.id)) {
+            entrypoints.add(node.id);
+        }
+    }
+    return entrypoints;
+}
+export function buildSnapshot(graph, projectPath) {
+    const allNodes = graph.getAllNodes();
+    const allEdges = graph.getAllEdges();
+    // Only include source files (src/, lib/, app/, etc.) — exclude node_modules artifacts, cache, models
+    const SOURCE_PREFIXES = ['src/', 'lib/', 'app/', 'packages/', 'test/', 'tests/', 'scripts/'];
+    const isSourceFile = (path) => SOURCE_PREFIXES.some(p => path.startsWith(p)) || !path.includes('/');
+    const moduleNodes = allNodes.filter((n) => (n.type === 'module' || n.type === 'test_file') && isSourceFile(n.path));
+    const moduleIds = new Set(moduleNodes.map(n => n.id));
+    const importEdges = allEdges.filter((e) => e.type === 'imports' && moduleIds.has(e.source));
+    const testEdges = allEdges.filter((e) => e.type === 'tests' && moduleIds.has(e.source));
+    const summary = graph.buildSummary();
+    // 의존성 맵 구축
+    const dependsOnMap = new Map();
+    const dependedByMap = new Map();
+    for (const e of importEdges) {
+        if (!dependsOnMap.has(e.source))
+            dependsOnMap.set(e.source, []);
+        dependsOnMap.get(e.source).push(e.target);
+        if (!dependedByMap.has(e.target))
+            dependedByMap.set(e.target, []);
+        dependedByMap.get(e.target).push(e.source);
+    }
+    // 테스트 맵
+    const testsMap = new Map();
+    for (const e of testEdges) {
+        if (!testsMap.has(e.target))
+            testsMap.set(e.target, []);
+        testsMap.get(e.target).push(e.source);
+    }
+    const entrypoints = findEntrypoints(moduleNodes, importEdges);
+    const hotModulesSet = new Set(summary.hotModules);
+    const sourceEdges = allEdges.filter((e) => moduleIds.has(e.source) && moduleIds.has(e.target));
+    const cycles = detectCycles(moduleNodes, sourceEdges);
+    // 언어 통계
+    const langStats = new Map();
+    for (const n of moduleNodes) {
+        const lang = (n.metrics?.language ?? 'other').toUpperCase();
+        const cur = langStats.get(lang) ?? { count: 0, loc: 0 };
+        cur.count++;
+        cur.loc += n.metrics?.loc ?? 0;
+        langStats.set(lang, cur);
+    }
+    // 레이어 통계
+    const layerStats = new Map();
+    for (const n of moduleNodes) {
+        const layer = inferLayer(n.path);
+        const cur = layerStats.get(layer) ?? { count: 0, modules: [] };
+        cur.count++;
+        cur.modules.push(n.id);
+        layerStats.set(layer, cur);
+    }
+    const projectName = projectPath.split('/').pop() ?? 'unknown';
+    return {
+        schemaVersion: 1,
+        projectName,
+        projectPath,
+        scannedAt: new Date(graph.scannedAt).toISOString(),
+        project: {
+            totalModules: summary.totalModules,
+            totalTests: summary.totalTestFiles,
+            languages: Array.from(langStats.entries()).map(([language, stats]) => ({
+                language, ...stats,
+            })),
+            layers: Array.from(layerStats.entries()).map(([layer, stats]) => ({
+                layer, count: stats.count, modules: stats.modules,
+            })),
+            summary: {
+                avgChurnScore: summary.avgChurnScore,
+                hotModules: summary.hotModules,
+                untestedModules: summary.untestedModules,
+                stableCount: summary.stableModules ?? 0,
+                experimentalCount: summary.experimentalModules ?? 0,
+                deprecatedCount: summary.deprecatedModules ?? 0,
+            },
+        },
+        modules: moduleNodes.map(n => {
+            const deps = dependsOnMap.get(n.id) ?? [];
+            const depBy = dependedByMap.get(n.id) ?? [];
+            const tests = testsMap.get(n.id) ?? [];
+            return {
+                id: n.id,
+                path: n.path,
+                name: n.name,
+                type: n.type.toUpperCase(),
+                layer: inferLayer(n.path),
+                language: (n.metrics?.language ?? 'other').toUpperCase(),
+                loc: n.metrics?.loc ?? 0,
+                exports: n.metrics?.exportCount ?? 0,
+                imports: n.metrics?.importCount ?? 0,
+                dependsOn: deps.filter(d => !d.startsWith('pkg:')),
+                dependedBy: depBy,
+                tests,
+                churnScore: n.gitInfo?.churnScore ?? null,
+                commitCount30d: n.gitInfo?.commitCount30d ?? null,
+                lastCommitDate: n.gitInfo?.lastCommitDate
+                    ? new Date(n.gitInfo.lastCommitDate).toISOString()
+                    : null,
+                state: n.metadata?.state ?? null,
+                techDebt: n.metadata?.techDebt ?? null,
+                isEntrypoint: entrypoints.has(n.id),
+                isHotspot: hotModulesSet.has(n.id),
+                risk: computeRisk(n, tests.length > 0, depBy.length),
+            };
+        }),
+        circularDeps: cycles.map(c => ({ modules: c, length: c.length })),
+    };
+}
+// .openswarm/ 디렉토리에 스키마 + 스냅샷 저장
+export function exportRepoGraph(graph, projectPath) {
+    const dir = join(projectPath, '.openswarm');
+    if (!existsSync(dir)) {
+        mkdirSync(dir, { recursive: true });
+    }
+    const schemaPath = join(dir, 'repo.graphql');
+    const snapshotPath = join(dir, 'repo-snapshot.json');
+    writeFileSync(schemaPath, REPO_SCHEMA, 'utf8');
+    const snapshot = buildSnapshot(graph, projectPath);
+    writeFileSync(snapshotPath, JSON.stringify(snapshot, null, 2), 'utf8');
+    console.log(`[Knowledge] Exported repo graph: ${schemaPath} (schema) + ${snapshotPath} (${snapshot.modules.length} modules, ${snapshot.circularDeps.length} cycles)`);
+    return { schemaPath, snapshotPath };
+}
+// 스냅샷이 존재하는지 확인
+export function hasRepoSnapshot(projectPath) {
+    return existsSync(join(projectPath, '.openswarm', 'repo-snapshot.json'));
+}
+// 스냅샷 로드 (에이전트가 읽을 때)
+export function loadRepoSnapshot(projectPath) {
+    const snapshotPath = join(projectPath, '.openswarm', 'repo-snapshot.json');
+    if (!existsSync(snapshotPath))
+        return null;
+    try {
+        return JSON.parse(readFileSync(snapshotPath, 'utf8'));
+    }
+    catch {
+        return null;
+    }
+}
+// 스냅샷 나이 확인 (분)
+export function snapshotAgeMinutes(projectPath) {
+    const snapshot = loadRepoSnapshot(projectPath);
+    if (!snapshot)
+        return null;
+    return (Date.now() - new Date(snapshot.scannedAt).getTime()) / 60_000;
+}
+//# sourceMappingURL=graphqlExporter.js.map