@nahisaho/musubix-codegraph 2.3.0

package/dist/types.d.ts

@@ -0,0 +1,539 @@
+/**
+ * @nahisaho/musubix-codegraph - Type Definitions
+ *
+ * @packageDocumentation
+ * @module @nahisaho/musubix-codegraph
+ *
+ * @see REQ-CG-API-004
+ * @see DES-CG-010
+ */
+/**
+ * Supported programming languages
+ * @see REQ-CG-AST-001
+ */
+export type Language = 'typescript' | 'javascript' | 'python' | 'rust' | 'go' | 'java' | 'php' | 'csharp' | 'c' | 'cpp' | 'ruby' | 'hcl' | 'kotlin' | 'swift' | 'scala' | 'lua';
+/**
+ * File extension to language mapping
+ */
+export declare const LANGUAGE_EXTENSIONS: Record<string, Language>;
+/**
+ * Entity types in the code graph
+ * @see REQ-CG-AST-003
+ */
+export type EntityType = 'file' | 'module' | 'class' | 'interface' | 'function' | 'method' | 'property' | 'variable' | 'constant' | 'type' | 'enum' | 'enum_member' | 'parameter' | 'import' | 'export' | 'namespace' | 'trait' | 'struct' | 'impl' | 'unknown';
+/**
+ * Code entity in the graph
+ * @see REQ-CG-AST-003
+ * @see DES-CG-010
+ */
+export interface Entity {
+    /** Unique identifier */
+    id: string;
+    /** Entity type */
+    type: EntityType;
+    /** Entity name */
+    name: string;
+    /** Qualified name (namespace.name) */
+    qualifiedName?: string;
+    /** Namespace or module path */
+    namespace?: string;
+    /** Source file path */
+    filePath?: string;
+    /** Start line number (1-indexed) */
+    startLine?: number;
+    /** End line number (1-indexed) */
+    endLine?: number;
+    /** Function/method signature */
+    signature?: string;
+    /** Documentation string */
+    docstring?: string;
+    /** Source code content */
+    sourceCode?: string;
+    /** Community ID (for GraphRAG) */
+    communityId?: string;
+    /** Programming language */
+    language?: Language;
+    /** Additional metadata */
+    metadata: Record<string, unknown>;
+    /** Creation timestamp */
+    createdAt?: Date;
+    /** Last update timestamp */
+    updatedAt?: Date;
+}
+/**
+ * Input for creating an entity
+ */
+export interface EntityInput {
+    type: EntityType;
+    name: string;
+    qualifiedName?: string;
+    namespace?: string;
+    filePath?: string;
+    startLine?: number;
+    endLine?: number;
+    signature?: string;
+    docstring?: string;
+    sourceCode?: string;
+    language?: Language;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Relationship types between entities
+ * @see REQ-CG-AST-004
+ */
+export type RelationType = 'calls' | 'imports' | 'exports' | 'extends' | 'implements' | 'contains' | 'uses' | 'defines' | 'returns' | 'parameter_of' | 'member_of' | 'type_of' | 'inherits' | 'overrides' | 'references' | 'depends_on';
+/**
+ * Relationship between entities
+ * @see REQ-CG-AST-004
+ */
+export interface Relation {
+    /** Unique identifier */
+    id: string;
+    /** Source entity ID */
+    sourceId: string;
+    /** Target entity ID */
+    targetId: string;
+    /** Relationship type */
+    type: RelationType;
+    /** Relationship weight/strength (0-1) */
+    weight: number;
+    /** Additional metadata */
+    metadata: Record<string, unknown>;
+    /** Creation timestamp */
+    createdAt?: Date;
+}
+/**
+ * Input for creating a relation
+ */
+export interface RelationInput {
+    sourceId: string;
+    targetId: string;
+    type: RelationType;
+    weight?: number;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * CodeGraph configuration options
+ * @see REQ-CG-API-005
+ */
+export interface CodeGraphOptions {
+    /** Storage backend */
+    storage?: 'memory' | 'sqlite' | StorageAdapter;
+    /** SQLite database path (when storage is 'sqlite') */
+    sqlitePath?: string;
+    /** Parser options */
+    parser?: ParserOptions;
+    /** Graph engine options */
+    graph?: GraphOptions;
+    /** Indexer options */
+    indexer?: IndexerOptions;
+    /** GraphRAG options */
+    graphrag?: GraphRAGOptions;
+}
+/**
+ * Default CodeGraph options
+ */
+export declare const DEFAULT_CODEGRAPH_OPTIONS: Required<Omit<CodeGraphOptions, 'storage' | 'sqlitePath'>>;
+/**
+ * Parser configuration
+ */
+export interface ParserOptions {
+    /** Languages to parse */
+    languages?: Language[];
+    /** Include comments in AST */
+    includeComments?: boolean;
+    /** Extract docstrings */
+    extractDocstrings?: boolean;
+}
+/**
+ * Graph engine configuration
+ */
+export interface GraphOptions {
+    /** Maximum traversal depth */
+    maxDepth?: number;
+    /** Enable query caching */
+    enableCaching?: boolean;
+}
+/**
+ * Indexer configuration
+ */
+export interface IndexerOptions {
+    /** Glob patterns to ignore */
+    ignorePatterns?: string[];
+    /** Maximum file size to process (bytes) */
+    maxFileSize?: number;
+    /** Number of parallel file processors */
+    parallelism?: number;
+}
+/**
+ * GraphRAG configuration
+ */
+export interface GraphRAGOptions {
+    /** Community detection algorithm */
+    communityAlgorithm?: 'louvain' | 'label_propagation';
+    /** Minimum community size */
+    minCommunitySize?: number;
+}
+/**
+ * Graph query specification
+ * @see REQ-CG-GRF-003
+ */
+export interface GraphQuery {
+    /** Entity type filter */
+    entityTypes?: EntityType[];
+    /** Name pattern (glob or regex) */
+    namePattern?: string;
+    /** Namespace filter */
+    namespace?: string;
+    /** File path filter */
+    filePath?: string;
+    /** Relation type filter */
+    relationTypes?: RelationType[];
+    /** Relation direction */
+    relationDirection?: 'in' | 'out' | 'both';
+    /** Full-text search query */
+    textSearch?: string;
+    /** Include relationships in result */
+    includeRelations?: boolean;
+    /** Maximum results */
+    limit?: number;
+    /** Result offset */
+    offset?: number;
+}
+/**
+ * Query options for dependency analysis
+ */
+export interface DependencyOptions {
+    /** Maximum depth to traverse */
+    depth?: number;
+    /** Relation types to follow */
+    relationTypes?: RelationType[];
+    /** Include indirect dependencies */
+    includeIndirect?: boolean;
+}
+/**
+ * Local search options
+ */
+export interface LocalSearchOptions {
+    /** Search radius (hops) */
+    radius?: number;
+    /** Maximum results */
+    limit?: number;
+    /** Include community context */
+    includeCommunity?: boolean;
+}
+/**
+ * Global search options
+ */
+export interface GlobalSearchOptions {
+    /** Maximum results */
+    limit?: number;
+    /** Minimum relevance score */
+    minScore?: number;
+    /** Include community summaries */
+    includeSummaries?: boolean;
+}
+/**
+ * Query result
+ * @see REQ-CG-API-004
+ */
+export interface QueryResult {
+    /** Matched entities */
+    entities: Entity[];
+    /** Related relationships */
+    relations: Relation[];
+    /** Total count (before pagination) */
+    totalCount: number;
+    /** Whether more results exist */
+    hasMore: boolean;
+    /** Query execution time (ms) */
+    queryTimeMs?: number;
+}
+/**
+ * Index operation result
+ * @see REQ-CG-IDX-001
+ */
+export interface IndexResult {
+    /** Whether indexing succeeded */
+    success: boolean;
+    /** Number of entities indexed */
+    entitiesIndexed: number;
+    /** Number of relations indexed */
+    relationsIndexed: number;
+    /** Number of files processed */
+    filesProcessed: number;
+    /** Indexing duration (ms) */
+    durationMs: number;
+    /** Errors encountered */
+    errors: IndexError[];
+}
+/**
+ * Index error
+ */
+export interface IndexError {
+    /** File path */
+    filePath: string;
+    /** Error message */
+    message: string;
+    /** Line number (if applicable) */
+    line?: number;
+}
+/**
+ * Parse result
+ * @see REQ-CG-AST-003
+ */
+export interface ParseResult {
+    /** Extracted entities */
+    entities: Entity[];
+    /** Extracted relations */
+    relations: Relation[];
+    /** Parse errors */
+    errors: ParseError[];
+    /** Statistics */
+    stats: {
+        linesOfCode: number;
+        parseTimeMs: number;
+    };
+}
+/**
+ * Parse error
+ */
+export interface ParseError {
+    /** Error message */
+    message: string;
+    /** Line number */
+    line?: number;
+    /** Column number */
+    column?: number;
+}
+/**
+ * Graph statistics
+ * @see REQ-CG-API-004
+ */
+export interface GraphStatistics {
+    /** Total entity count */
+    entityCount: number;
+    /** Total relation count */
+    relationCount: number;
+    /** Number of files */
+    fileCount: number;
+    /** Number of communities */
+    communityCount: number;
+    /** Entities by type */
+    entitiesByType: Partial<Record<EntityType, number>>;
+    /** Relations by type */
+    relationsByType: Partial<Record<RelationType, number>>;
+    /** Languages detected */
+    languages: Language[];
+    /** Index timestamp */
+    indexedAt?: Date;
+}
+/**
+ * Call path in call graph
+ */
+export interface CallPath {
+    /** Source entity */
+    from: Entity;
+    /** Target entity */
+    to: Entity;
+    /** Path of entities */
+    path: Entity[];
+    /** Call site information */
+    callSites: CallSite[];
+}
+/**
+ * Call site information
+ */
+export interface CallSite {
+    /** File path */
+    filePath: string;
+    /** Line number */
+    line: number;
+    /** Column number */
+    column?: number;
+}
+/**
+ * Module analysis result
+ */
+export interface ModuleAnalysis {
+    /** File path */
+    filePath: string;
+    /** Module name */
+    moduleName: string;
+    /** Entities in module */
+    entities: Entity[];
+    /** Import statements */
+    imports: Entity[];
+    /** Export statements */
+    exports: Entity[];
+    /** Dependencies */
+    dependencies: string[];
+    /** Dependents */
+    dependents: string[];
+}
+/**
+ * Code snippet
+ */
+export interface CodeSnippet {
+    /** Entity ID */
+    entityId: string;
+    /** Source code */
+    code: string;
+    /** Language */
+    language: Language;
+    /** File path */
+    filePath: string;
+    /** Start line */
+    startLine: number;
+    /** End line */
+    endLine: number;
+    /** Context (surrounding code) */
+    context?: {
+        before: string;
+        after: string;
+    };
+}
+/**
+ * File structure
+ */
+export interface FileStructure {
+    /** File path */
+    filePath: string;
+    /** Language */
+    language: Language;
+    /** Entities in file */
+    entities: Entity[];
+    /** Lines of code */
+    linesOfCode: number;
+    /** Import count */
+    importCount: number;
+    /** Export count */
+    exportCount: number;
+}
+/**
+ * Search result (GraphRAG)
+ * @see REQ-CG-RAG-002
+ */
+export interface SearchResult {
+    /** Matched entity */
+    entity: Entity;
+    /** Relevance score (0-1) */
+    score: number;
+    /** Context snippet */
+    context: string;
+    /** Community information */
+    community?: Community;
+}
+/**
+ * Code community (GraphRAG)
+ * @see REQ-CG-RAG-001
+ */
+export interface Community {
+    /** Community ID */
+    id: string;
+    /** Community name/label */
+    name: string;
+    /** Member count */
+    memberCount: number;
+    /** Community summary */
+    summary?: string;
+    /** Key entities */
+    keyEntities: string[];
+    /** Parent community ID */
+    parentId?: string;
+}
+/**
+ * Storage adapter interface
+ * @see REQ-CG-API-005
+ * @see DES-CG-006
+ */
+export interface StorageAdapter {
+    saveEntity(entity: Entity): Promise<void>;
+    getEntity(id: string): Promise<Entity | null>;
+    queryEntities(query: GraphQuery): Promise<Entity[]>;
+    deleteEntity(id: string): Promise<void>;
+    saveRelation(relation: Relation): Promise<void>;
+    getRelations(entityId: string, direction?: 'in' | 'out' | 'both'): Promise<Relation[]>;
+    deleteRelation(id: string): Promise<void>;
+    bulkSave(entities: Entity[], relations: Relation[]): Promise<void>;
+    clear(): Promise<void>;
+    getStats(): Promise<StorageStats>;
+    initialize(): Promise<void>;
+    close(): Promise<void>;
+}
+/**
+ * Storage statistics
+ */
+export interface StorageStats {
+    entityCount: number;
+    relationCount: number;
+    fileCount: number;
+}
+/**
+ * CodeGraph event types
+ * @see REQ-CG-API-006
+ */
+export interface CodeGraphEvents extends Record<string, unknown> {
+    'indexing:start': {
+        path: string;
+        timestamp: Date;
+    };
+    'indexing:progress': {
+        processed: number;
+        total: number;
+        currentFile: string;
+    };
+    'indexing:complete': IndexResult;
+    'indexing:error': {
+        error: Error;
+        file?: string;
+    };
+    'query:start': {
+        query: GraphQuery;
+    };
+    'query:complete': {
+        result: QueryResult;
+        durationMs: number;
+    };
+    'entity:added': {
+        entity: Entity;
+    };
+    'entity:updated': {
+        entity: Entity;
+    };
+    'entity:deleted': {
+        entityId: string;
+    };
+}
+/**
+ * Index progress information
+ */
+export interface IndexProgress {
+    /** Files processed so far */
+    processed: number;
+    /** Total files to process */
+    total: number;
+    /** Current file being processed */
+    currentFile: string;
+    /** Progress percentage (0-100) */
+    percentage: number;
+    /** Estimated time remaining (ms) */
+    estimatedRemainingMs?: number;
+}
+/**
+ * Generate entity ID
+ */
+export declare function generateEntityId(type: EntityType, name: string, filePath?: string): string;
+/**
+ * Generate relation ID
+ */
+export declare function generateRelationId(sourceId: string, targetId: string, type: RelationType): string;
+/**
+ * Check if language is supported
+ */
+export declare function isSupportedLanguage(lang: string): lang is Language;
+/**
+ * Get language from file extension
+ */
+export declare function getLanguageFromExtension(filePath: string): Language | null;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,99 @@
+/**
+ * @nahisaho/musubix-codegraph - Type Definitions
+ *
+ * @packageDocumentation
+ * @module @nahisaho/musubix-codegraph
+ *
+ * @see REQ-CG-API-004
+ * @see DES-CG-010
+ */
+/**
+ * File extension to language mapping
+ */
+export const LANGUAGE_EXTENSIONS = {
+    '.ts': 'typescript',
+    '.tsx': 'typescript',
+    '.js': 'javascript',
+    '.jsx': 'javascript',
+    '.mjs': 'javascript',
+    '.cjs': 'javascript',
+    '.py': 'python',
+    '.pyw': 'python',
+    '.rs': 'rust',
+    '.go': 'go',
+    '.java': 'java',
+    '.php': 'php',
+    '.cs': 'csharp',
+    '.c': 'c',
+    '.h': 'c',
+    '.cpp': 'cpp',
+    '.hpp': 'cpp',
+    '.cc': 'cpp',
+    '.cxx': 'cpp',
+    '.rb': 'ruby',
+    '.tf': 'hcl',
+    '.hcl': 'hcl',
+    '.kt': 'kotlin',
+    '.kts': 'kotlin',
+    '.swift': 'swift',
+    '.scala': 'scala',
+    '.sc': 'scala',
+    '.lua': 'lua',
+};
+/**
+ * Default CodeGraph options
+ */
+export const DEFAULT_CODEGRAPH_OPTIONS = {
+    parser: {
+        languages: ['typescript', 'javascript', 'python'],
+        includeComments: true,
+        extractDocstrings: true,
+    },
+    graph: {
+        maxDepth: 10,
+        enableCaching: true,
+    },
+    indexer: {
+        ignorePatterns: ['node_modules', '.git', 'dist', 'build', '__pycache__', '.venv'],
+        maxFileSize: 1024 * 1024, // 1MB
+        parallelism: 4,
+    },
+    graphrag: {
+        communityAlgorithm: 'louvain',
+        minCommunitySize: 3,
+    },
+};
+// ============================================================================
+// Utility Types
+// ============================================================================
+/**
+ * Generate entity ID
+ */
+export function generateEntityId(type, name, filePath) {
+    const base = filePath ? `${filePath}:${name}` : name;
+    return `${type}:${base}`.replace(/[^a-zA-Z0-9:._-]/g, '_');
+}
+/**
+ * Generate relation ID
+ */
+export function generateRelationId(sourceId, targetId, type) {
+    return `${sourceId}-${type}-${targetId}`;
+}
+/**
+ * Check if language is supported
+ */
+export function isSupportedLanguage(lang) {
+    const supported = [
+        'typescript', 'javascript', 'python', 'rust', 'go', 'java',
+        'php', 'csharp', 'c', 'cpp', 'ruby', 'hcl', 'kotlin', 'swift', 'scala', 'lua'
+    ];
+    return supported.includes(lang);
+}
+/**
+ * Get language from file extension
+ */
+export function getLanguageFromExtension(filePath) {
+    const ext = filePath.slice(filePath.lastIndexOf('.')).toLowerCase();
+    return LANGUAGE_EXTENSIONS[ext] ?? null;
+}
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

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