@colbymchenry/codegraph 0.8.0 → 0.9.1

package/dist/sync/watcher.js

@@ -1,194 +0,0 @@
-"use strict";
-/**
- * File Watcher
- *
- * Watches the project directory for file changes and triggers
- * debounced sync operations to keep the code graph up-to-date.
- *
- * Uses Node.js native fs.watch with recursive mode (macOS FSEvents,
- * Windows ReadDirectoryChangesW, Linux inotify on Node 19+).
- */
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.FileWatcher = void 0;
-const fs = __importStar(require("fs"));
-const extraction_1 = require("../extraction");
-const errors_1 = require("../errors");
-const utils_1 = require("../utils");
-const watch_policy_1 = require("./watch-policy");
-/**
- * FileWatcher monitors a project directory for changes and triggers
- * debounced sync operations via a provided callback.
- *
- * Design goals:
- * - Minimal resource usage (native OS file events, no polling)
- * - Debounced to avoid thrashing on rapid saves
- * - Filters against CodeGraph include/exclude patterns
- * - Ignores .codegraph/ directory changes
- */
-class FileWatcher {
-    watcher = null;
-    debounceTimer = null;
-    hasChanges = false;
-    syncing = false;
-    stopped = false;
-    projectRoot;
-    config;
-    debounceMs;
-    syncFn;
-    onSyncComplete;
-    onSyncError;
-    constructor(projectRoot, config, syncFn, options = {}) {
-        this.projectRoot = projectRoot;
-        this.config = config;
-        this.syncFn = syncFn;
-        this.debounceMs = options.debounceMs ?? 2000;
-        this.onSyncComplete = options.onSyncComplete;
-        this.onSyncError = options.onSyncError;
-    }
-    /**
-     * Start watching for file changes.
-     * Returns true if watching started successfully, false otherwise.
-     */
-    start() {
-        if (this.watcher)
-            return true; // Already watching
-        this.stopped = false;
-        // Some environments make recursive fs.watch unusable — most notably WSL2
-        // /mnt/ drives, where setup blocks long enough to break MCP startup
-        // handshakes (issue #199). Skip watching there; callers fall back to
-        // manual `codegraph sync` or the git sync hooks.
-        const disabledReason = (0, watch_policy_1.watchDisabledReason)(this.projectRoot);
-        if (disabledReason) {
-            (0, errors_1.logDebug)('File watcher disabled', { reason: disabledReason, projectRoot: this.projectRoot });
-            return false;
-        }
-        try {
-            this.watcher = fs.watch(this.projectRoot, { recursive: true }, (_eventType, filename) => {
-                if (!filename || this.stopped)
-                    return;
-                // Normalize path separators
-                const normalized = (0, utils_1.normalizePath)(filename);
-                // Ignore .codegraph/ directory changes (our own DB writes)
-                if (normalized === '.codegraph' ||
-                    normalized.startsWith('.codegraph/') ||
-                    normalized.startsWith('.codegraph\\')) {
-                    return;
-                }
-                // Filter against include/exclude patterns
-                if (!(0, extraction_1.shouldIncludeFile)(normalized, this.config)) {
-                    return;
-                }
-                (0, errors_1.logDebug)('File change detected', { file: normalized });
-                this.hasChanges = true;
-                this.scheduleSync();
-            });
-            // Handle watcher errors gracefully
-            this.watcher.on('error', (err) => {
-                (0, errors_1.logWarn)('File watcher error', { error: String(err) });
-                // Don't crash — watcher may recover or user can restart
-            });
-            (0, errors_1.logDebug)('File watcher started', { projectRoot: this.projectRoot, debounceMs: this.debounceMs });
-            return true;
-        }
-        catch (err) {
-            // Recursive watch not supported (e.g., Linux < Node 19)
-            (0, errors_1.logWarn)('Could not start file watcher — recursive fs.watch not supported on this platform', { error: String(err) });
-            return false;
-        }
-    }
-    /**
-     * Stop watching for file changes.
-     */
-    stop() {
-        this.stopped = true;
-        if (this.debounceTimer) {
-            clearTimeout(this.debounceTimer);
-            this.debounceTimer = null;
-        }
-        if (this.watcher) {
-            this.watcher.close();
-            this.watcher = null;
-        }
-        this.hasChanges = false;
-        (0, errors_1.logDebug)('File watcher stopped');
-    }
-    /**
-     * Whether the watcher is currently active.
-     */
-    isActive() {
-        return this.watcher !== null && !this.stopped;
-    }
-    /**
-     * Schedule a debounced sync.
-     */
-    scheduleSync() {
-        if (this.debounceTimer) {
-            clearTimeout(this.debounceTimer);
-        }
-        this.debounceTimer = setTimeout(() => {
-            this.debounceTimer = null;
-            this.flush();
-        }, this.debounceMs);
-    }
-    /**
-     * Flush pending changes by running sync.
-     */
-    async flush() {
-        // If already syncing, the post-sync check will re-trigger
-        if (this.syncing || this.stopped)
-            return;
-        this.hasChanges = false;
-        this.syncing = true;
-        try {
-            const result = await this.syncFn();
-            this.onSyncComplete?.(result);
-        }
-        catch (err) {
-            const error = err instanceof Error ? err : new Error(String(err));
-            (0, errors_1.logWarn)('Watch sync failed', { error: error.message });
-            this.onSyncError?.(error);
-        }
-        finally {
-            this.syncing = false;
-            // If new changes arrived during sync, schedule another
-            if (this.hasChanges && !this.stopped) {
-                this.scheduleSync();
-            }
-        }
-    }
-}
-exports.FileWatcher = FileWatcher;
-//# sourceMappingURL=watcher.js.map

package/dist/sync/watcher.js.map

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

package/dist/types.d.ts

@@ -1,423 +0,0 @@
-/**
- * CodeGraph Type Definitions
- *
- * Core types for the semantic knowledge graph system.
- */
-/**
- * Types of nodes in the knowledge graph.
- *
- * Defined as a runtime-iterable `as const` array so the same source
- * of truth backs both the TS type and any runtime validation
- * (e.g. the search query parser).
- */
-export declare const NODE_KINDS: readonly ["file", "module", "class", "struct", "interface", "trait", "protocol", "function", "method", "property", "field", "variable", "constant", "enum", "enum_member", "type_alias", "namespace", "parameter", "import", "export", "route", "component"];
-export type NodeKind = (typeof NODE_KINDS)[number];
-/**
- * Types of edges (relationships) between nodes
- */
-export type EdgeKind = 'contains' | 'calls' | 'imports' | 'exports' | 'extends' | 'implements' | 'references' | 'type_of' | 'returns' | 'instantiates' | 'overrides' | 'decorates';
-/**
- * Supported programming languages. See NODE_KINDS for why this is a
- * runtime-iterable const array.
- */
-export declare const LANGUAGES: readonly ["typescript", "javascript", "tsx", "jsx", "python", "go", "rust", "java", "c", "cpp", "csharp", "php", "ruby", "swift", "kotlin", "dart", "svelte", "vue", "liquid", "pascal", "scala", "unknown"];
-export type Language = (typeof LANGUAGES)[number];
-/**
- * A node in the knowledge graph representing a code symbol
- */
-export interface Node {
-    /** Unique identifier (hash of file path + qualified name) */
-    id: string;
-    /** Type of code element */
-    kind: NodeKind;
-    /** Simple name (e.g., "calculateTotal") */
-    name: string;
-    /** Fully qualified name (e.g., "src/utils.ts::MathHelper.calculateTotal") */
-    qualifiedName: string;
-    /** File path relative to project root */
-    filePath: string;
-    /** Programming language */
-    language: Language;
-    /** Starting line number (1-indexed) */
-    startLine: number;
-    /** Ending line number (1-indexed) */
-    endLine: number;
-    /** Starting column (0-indexed) */
-    startColumn: number;
-    /** Ending column (0-indexed) */
-    endColumn: number;
-    /** Documentation string if present */
-    docstring?: string;
-    /** Function/method signature */
-    signature?: string;
-    /** Visibility modifier */
-    visibility?: 'public' | 'private' | 'protected' | 'internal';
-    /** Whether symbol is exported */
-    isExported?: boolean;
-    /** Whether symbol is async */
-    isAsync?: boolean;
-    /** Whether symbol is static */
-    isStatic?: boolean;
-    /** Whether symbol is abstract */
-    isAbstract?: boolean;
-    /** Decorators/annotations applied */
-    decorators?: string[];
-    /** Generic type parameters */
-    typeParameters?: string[];
-    /** When the node was last updated */
-    updatedAt: number;
-}
-/**
- * An edge representing a relationship between two nodes
- */
-export interface Edge {
-    /** Source node ID */
-    source: string;
-    /** Target node ID */
-    target: string;
-    /** Type of relationship */
-    kind: EdgeKind;
-    /** Additional context about the relationship */
-    metadata?: Record<string, unknown>;
-    /** Line number where relationship occurs (e.g., call site) */
-    line?: number;
-    /** Column number where relationship occurs */
-    column?: number;
-    /** How this edge was created */
-    provenance?: 'tree-sitter' | 'scip' | 'heuristic';
-}
-/**
- * Metadata about a tracked file
- */
-export interface FileRecord {
-    /** File path relative to project root */
-    path: string;
-    /** Content hash for change detection */
-    contentHash: string;
-    /** Detected language */
-    language: Language;
-    /** File size in bytes */
-    size: number;
-    /** Last modification timestamp */
-    modifiedAt: number;
-    /** When last indexed */
-    indexedAt: number;
-    /** Number of nodes extracted */
-    nodeCount: number;
-    /** Any extraction errors */
-    errors?: ExtractionError[];
-}
-/**
- * Result from parsing a source file
- */
-export interface ExtractionResult {
-    /** Extracted nodes */
-    nodes: Node[];
-    /** Extracted edges */
-    edges: Edge[];
-    /** References that couldn't be resolved yet */
-    unresolvedReferences: UnresolvedReference[];
-    /** Any errors during extraction */
-    errors: ExtractionError[];
-    /** Extraction duration in milliseconds */
-    durationMs: number;
-}
-/**
- * Error during code extraction
- */
-export interface ExtractionError {
-    /** Error message */
-    message: string;
-    /** File path where the error occurred */
-    filePath?: string;
-    /** Line number if available */
-    line?: number;
-    /** Column number if available */
-    column?: number;
-    /** Error severity */
-    severity: 'error' | 'warning';
-    /** Error code for categorization */
-    code?: string;
-}
-/**
- * A reference that couldn't be resolved during extraction
- */
-export interface UnresolvedReference {
-    /** ID of the node containing the reference */
-    fromNodeId: string;
-    /** Name being referenced */
-    referenceName: string;
-    /** Type of reference (call, type, import, etc.) */
-    referenceKind: EdgeKind;
-    /** Location of the reference */
-    line: number;
-    column: number;
-    /** File path where reference occurs (denormalized for performance) */
-    filePath?: string;
-    /** Language of the source file (denormalized for performance) */
-    language?: Language;
-    /** Possible qualified names it might resolve to */
-    candidates?: string[];
-}
-/**
- * A subgraph containing a subset of the knowledge graph
- */
-export interface Subgraph {
-    /** Nodes in this subgraph */
-    nodes: Map<string, Node>;
-    /** Edges in this subgraph */
-    edges: Edge[];
-    /** Root node IDs (entry points) */
-    roots: string[];
-}
-/**
- * Options for graph traversal
- */
-export interface TraversalOptions {
-    /** Maximum depth to traverse (default: Infinity) */
-    maxDepth?: number;
-    /** Edge types to follow (default: all) */
-    edgeKinds?: EdgeKind[];
-    /** Node types to include (default: all) */
-    nodeKinds?: NodeKind[];
-    /** Direction of traversal */
-    direction?: 'outgoing' | 'incoming' | 'both';
-    /** Maximum nodes to return */
-    limit?: number;
-    /** Whether to include the starting node */
-    includeStart?: boolean;
-}
-/**
- * Options for searching the graph
- */
-export interface SearchOptions {
-    /** Node types to search */
-    kinds?: NodeKind[];
-    /** Languages to include */
-    languages?: Language[];
-    /** File path patterns to include */
-    includePatterns?: string[];
-    /** File path patterns to exclude */
-    excludePatterns?: string[];
-    /** Maximum results to return */
-    limit?: number;
-    /** Offset for pagination */
-    offset?: number;
-    /** Whether search is case-sensitive */
-    caseSensitive?: boolean;
-}
-/**
- * A search result with relevance scoring
- */
-export interface SearchResult {
-    /** Matching node */
-    node: Node;
-    /** Relevance score (0-1) */
-    score: number;
-    /** Matched text snippets for highlighting */
-    highlights?: string[];
-}
-/**
- * Context information for code understanding
- */
-export interface Context {
-    /** Primary node being examined */
-    focal: Node;
-    /** Nodes containing the focal node (file, class, etc.) */
-    ancestors: Node[];
-    /** Nodes directly contained by focal node */
-    children: Node[];
-    /** Incoming references (who calls/uses this) */
-    incomingRefs: Array<{
-        node: Node;
-        edge: Edge;
-    }>;
-    /** Outgoing references (what this calls/uses) */
-    outgoingRefs: Array<{
-        node: Node;
-        edge: Edge;
-    }>;
-    /** Related type information */
-    types: Node[];
-    /** Relevant imports */
-    imports: Node[];
-}
-/**
- * A block of code with context
- */
-export interface CodeBlock {
-    /** The code content */
-    content: string;
-    /** File path */
-    filePath: string;
-    /** Starting line */
-    startLine: number;
-    /** Ending line */
-    endLine: number;
-    /** Language for syntax highlighting */
-    language: Language;
-    /** Associated node if extracted */
-    node?: Node;
-}
-/**
- * Framework-specific hints for better extraction
- */
-export interface FrameworkHint {
-    /** Framework name (react, express, django, etc.) */
-    name: string;
-    /** Version constraint if relevant */
-    version?: string;
-    /** Custom patterns for this framework */
-    patterns?: {
-        /** Component detection patterns */
-        components?: string[];
-        /** Route detection patterns */
-        routes?: string[];
-        /** Model detection patterns */
-        models?: string[];
-    };
-}
-/**
- * Configuration for a CodeGraph project
- */
-export interface CodeGraphConfig {
-    /** Schema version for migrations */
-    version: number;
-    /** Root directory of the project */
-    rootDir: string;
-    /** Glob patterns for files to include */
-    include: string[];
-    /** Glob patterns for files to exclude */
-    exclude: string[];
-    /** Languages to process (auto-detected if empty) */
-    languages: Language[];
-    /** Framework hints for better extraction */
-    frameworks: FrameworkHint[];
-    /** Maximum file size to process (in bytes) */
-    maxFileSize: number;
-    /** Whether to extract docstrings */
-    extractDocstrings: boolean;
-    /** Whether to track call sites */
-    trackCallSites: boolean;
-    /** Custom symbol patterns to extract */
-    customPatterns?: {
-        /** Name for this pattern group */
-        name: string;
-        /** Regex pattern to match */
-        pattern: string;
-        /** Node kind to assign */
-        kind: NodeKind;
-    }[];
-}
-/**
- * Default configuration values
- */
-export declare const DEFAULT_CONFIG: CodeGraphConfig;
-/**
- * Database schema version info
- */
-export interface SchemaVersion {
-    /** Current schema version */
-    version: number;
-    /** When schema was created/updated */
-    appliedAt: number;
-    /** Description of this version */
-    description?: string;
-}
-/**
- * Statistics about the knowledge graph
- */
-export interface GraphStats {
-    /** Total number of nodes */
-    nodeCount: number;
-    /** Total number of edges */
-    edgeCount: number;
-    /** Number of tracked files */
-    fileCount: number;
-    /** Node counts by kind */
-    nodesByKind: Record<NodeKind, number>;
-    /** Edge counts by kind */
-    edgesByKind: Record<EdgeKind, number>;
-    /** File counts by language */
-    filesByLanguage: Record<Language, number>;
-    /** Database size in bytes */
-    dbSizeBytes: number;
-    /** Last update timestamp */
-    lastUpdated: number;
-}
-/**
- * Input for building task context
- */
-export type TaskInput = string | {
-    title: string;
-    description?: string;
-};
-/**
- * Options for building task context
- */
-export interface BuildContextOptions {
-    /** Maximum number of nodes to include (default: 50) */
-    maxNodes?: number;
-    /** Maximum number of code blocks to include (default: 10) */
-    maxCodeBlocks?: number;
-    /** Maximum characters per code block (default: 2000) */
-    maxCodeBlockSize?: number;
-    /** Whether to include code blocks (default: true) */
-    includeCode?: boolean;
-    /** Output format (default: 'markdown') */
-    format?: 'markdown' | 'json';
-    /** Number of semantic search results (default: 5) */
-    searchLimit?: number;
-    /** Graph traversal depth from entry points (default: 2) */
-    traversalDepth?: number;
-    /** Minimum semantic similarity score (default: 0.3) */
-    minScore?: number;
-}
-/**
- * Full context for a task, ready for Claude
- */
-export interface TaskContext {
-    /** The original query/task */
-    query: string;
-    /** Subgraph of relevant nodes and edges */
-    subgraph: Subgraph;
-    /** Entry point nodes (from semantic search) */
-    entryPoints: Node[];
-    /** Code blocks extracted from key nodes */
-    codeBlocks: CodeBlock[];
-    /** Files involved in this context */
-    relatedFiles: string[];
-    /** Brief summary of the context */
-    summary: string;
-    /** Statistics about the context */
-    stats: {
-        /** Number of nodes included */
-        nodeCount: number;
-        /** Number of edges included */
-        edgeCount: number;
-        /** Number of files touched */
-        fileCount: number;
-        /** Number of code blocks included */
-        codeBlockCount: number;
-        /** Total characters in code blocks */
-        totalCodeSize: number;
-    };
-}
-/**
- * Options for finding relevant context
- */
-export interface FindRelevantContextOptions {
-    /** Number of semantic search results (default: 5) */
-    searchLimit?: number;
-    /** Graph traversal depth (default: 2) */
-    traversalDepth?: number;
-    /** Maximum nodes in result (default: 50) */
-    maxNodes?: number;
-    /** Minimum semantic similarity score (default: 0.3) */
-    minScore?: number;
-    /** Edge types to follow in traversal */
-    edgeKinds?: EdgeKind[];
-    /** Node types to include */
-    nodeKinds?: NodeKind[];
-}
-//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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