@side-quest/kit 0.0.0 → 0.2.0

package/dist/lib/utils/index-parser.js

@@ -0,0 +1,252 @@
+/**
+ * PROJECT_INDEX.json parser and query utilities
+ *
+ * Provides TypeScript-based queries to replace jq dependencies.
+ * Supports git-style directory search to find index from any subdirectory.
+ */
+import { dirname, join, resolve } from 'node:path';
+import { findUpSync, pathExistsSync } from '@side-quest/core/fs';
+/**
+ * Search up directory tree for PROJECT_INDEX.json (git-style)
+ *
+ * Note: Delegates to @sidequest/core/fs findUpSync for the file search.
+ *
+ * @param startDir - Directory to start searching from (default: process.cwd())
+ * @returns Absolute path to PROJECT_INDEX.json
+ * @throws Error if index not found
+ */
+export async function findProjectIndex(startDir = process.cwd()) {
+    const indexPath = findUpSync('PROJECT_INDEX.json', startDir);
+    if (indexPath) {
+        return indexPath;
+    }
+    throw new Error('PROJECT_INDEX.json not found in current directory or any parent directory.\n' +
+        'Run: bun run src/cli.ts prime');
+}
+/**
+ * Resolve explicit path to PROJECT_INDEX.json
+ *
+ * Handles three cases:
+ * 1. Path to PROJECT_INDEX.json file directly
+ * 2. Path to directory containing PROJECT_INDEX.json
+ * 3. Relative path that needs resolution
+ *
+ * @param explicitPath - Explicit path provided by user
+ * @returns Absolute path to PROJECT_INDEX.json
+ * @throws Error if index not found at specified path
+ */
+export function resolveExplicitIndexPath(explicitPath) {
+    const resolved = resolve(explicitPath);
+    // Case 1: Direct path to PROJECT_INDEX.json
+    if (resolved.endsWith('PROJECT_INDEX.json')) {
+        if (pathExistsSync(resolved)) {
+            return resolved;
+        }
+        throw new Error(`PROJECT_INDEX.json not found at: ${resolved}`);
+    }
+    // Case 2: Directory containing PROJECT_INDEX.json
+    const indexInDir = join(resolved, 'PROJECT_INDEX.json');
+    if (pathExistsSync(indexInDir)) {
+        return indexInDir;
+    }
+    throw new Error(`PROJECT_INDEX.json not found at: ${indexInDir}\n` +
+        'Specify either:\n' +
+        '  - Path to PROJECT_INDEX.json file\n' +
+        '  - Directory containing PROJECT_INDEX.json');
+}
+/**
+ * Load and parse PROJECT_INDEX.json
+ *
+ * @param explicitPath - Optional explicit path to index file or directory
+ * @returns Parsed project index
+ * @throws Error if index not found or invalid JSON
+ */
+export async function loadProjectIndex(explicitPath) {
+    const indexPath = explicitPath
+        ? resolveExplicitIndexPath(explicitPath)
+        : await findProjectIndex();
+    const file = Bun.file(indexPath);
+    return (await file.json());
+}
+/**
+ * Find symbols by name across all files
+ *
+ * @param index - Project index
+ * @param symbolName - Symbol name to search for (exact match)
+ * @returns Array of matching symbols with their file paths
+ */
+export function findSymbol(index, symbolName) {
+    const results = [];
+    for (const [file, symbols] of Object.entries(index.symbols)) {
+        for (const symbol of symbols) {
+            if (symbol.name === symbolName) {
+                results.push({ file, symbol });
+            }
+        }
+    }
+    return results;
+}
+/**
+ * Find symbols by fuzzy name matching (case-insensitive substring)
+ *
+ * @param index - Project index
+ * @param query - Search query (substring, case-insensitive)
+ * @returns Array of matching symbols with their file paths
+ */
+export function findSymbolFuzzy(index, query) {
+    const results = [];
+    const lowerQuery = query.toLowerCase();
+    for (const [file, symbols] of Object.entries(index.symbols)) {
+        for (const symbol of symbols) {
+            const lowerName = symbol.name.toLowerCase();
+            // Exact match (highest score)
+            if (lowerName === lowerQuery) {
+                results.push({ file, symbol, score: 100 });
+            }
+            // Starts with (high score)
+            else if (lowerName.startsWith(lowerQuery)) {
+                results.push({ file, symbol, score: 75 });
+            }
+            // Contains (lower score)
+            else if (lowerName.includes(lowerQuery)) {
+                results.push({ file, symbol, score: 50 });
+            }
+        }
+    }
+    // Sort by score descending, then by name
+    return results.sort((a, b) => {
+        if (b.score !== a.score)
+            return b.score - a.score;
+        return a.symbol.name.localeCompare(b.symbol.name);
+    });
+}
+/**
+ * Get all symbols in a file
+ *
+ * @param index - Project index
+ * @param filePath - File path (can be relative or absolute)
+ * @returns Array of symbols in the file
+ */
+export function getFileSymbols(index, filePath) {
+    // Try exact match first
+    if (index.symbols[filePath]) {
+        return index.symbols[filePath];
+    }
+    // Try finding by filename (if relative path provided)
+    for (const [path, symbols] of Object.entries(index.symbols)) {
+        if (path.endsWith(filePath)) {
+            return symbols;
+        }
+    }
+    return [];
+}
+/**
+ * Get all files with their symbol counts
+ *
+ * @param index - Project index
+ * @returns Array of files with symbol counts
+ */
+export function getFileStats(index) {
+    const stats = [];
+    for (const [file, symbols] of Object.entries(index.symbols)) {
+        stats.push({ file, symbolCount: symbols.length });
+    }
+    // Sort by symbol count descending
+    return stats.sort((a, b) => b.symbolCount - a.symbolCount);
+}
+/**
+ * Get symbol distribution by type
+ *
+ * @param index - Project index
+ * @returns Record of symbol types to counts
+ */
+export function getSymbolTypeDistribution(index) {
+    const distribution = {
+        function: 0,
+        class: 0,
+        interface: 0,
+        type: 0,
+        constant: 0,
+        variable: 0,
+    };
+    for (const symbols of Object.values(index.symbols)) {
+        for (const symbol of symbols) {
+            distribution[symbol.type] = (distribution[symbol.type] || 0) + 1;
+        }
+    }
+    return distribution;
+}
+/**
+ * Get all exported symbols (heuristic: uppercase or common export patterns)
+ *
+ * Note: Kit index doesn't have explicit "exported" flag, so we use naming conventions
+ *
+ * @param index - Project index
+ * @returns Array of likely exported symbols
+ */
+export function getExportedSymbols(index) {
+    const exported = [];
+    for (const [file, symbols] of Object.entries(index.symbols)) {
+        // Skip test files
+        if (file.includes('.test.') || file.includes('.spec.')) {
+            continue;
+        }
+        for (const symbol of symbols) {
+            // Heuristic: likely exported if:
+            // 1. Starts with uppercase (classes, types, interfaces)
+            // 2. Exported by naming convention
+            const firstChar = symbol.name[0];
+            if (firstChar && firstChar === firstChar.toUpperCase()) {
+                exported.push({ file, symbol });
+            }
+        }
+    }
+    return exported;
+}
+/**
+ * Group symbols by directory
+ *
+ * @param index - Project index
+ * @returns Record of directory paths to symbol counts
+ */
+export function groupSymbolsByDirectory(index) {
+    const dirCounts = {};
+    for (const [file, symbols] of Object.entries(index.symbols)) {
+        const dir = dirname(file);
+        dirCounts[dir] = (dirCounts[dir] || 0) + symbols.length;
+    }
+    return dirCounts;
+}
+/**
+ * Get directory with most symbols (complexity hotspot)
+ *
+ * @param index - Project index
+ * @param topN - Number of top directories to return
+ * @returns Array of directories sorted by symbol count
+ */
+export function getComplexityHotspots(index, topN = 10) {
+    const dirCounts = groupSymbolsByDirectory(index);
+    const sorted = Object.entries(dirCounts)
+        .map(([directory, symbolCount]) => ({ directory, symbolCount }))
+        .sort((a, b) => b.symbolCount - a.symbolCount);
+    return sorted.slice(0, topN);
+}
+/**
+ * Get all symbols of a specific type
+ *
+ * @param index - Project index
+ * @param type - Symbol type to filter by
+ * @returns Array of matching symbols with file paths
+ */
+export function getSymbolsByType(index, type) {
+    const results = [];
+    for (const [file, symbols] of Object.entries(index.symbols)) {
+        for (const symbol of symbols) {
+            if (symbol.type === type) {
+                results.push({ file, symbol });
+            }
+        }
+    }
+    return results;
+}
+//# sourceMappingURL=index-parser.js.map

package/dist/lib/utils/index-parser.js.map

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

package/dist/lib/validators.d.ts

@@ -0,0 +1,138 @@
+/**
+ * Kit Plugin Validators
+ *
+ * Input validation and security utilities for safe Kit CLI operations.
+ */
+/**
+ * Result of path validation.
+ */
+export interface PathValidationResult {
+    /** Whether the path is valid */
+    valid: boolean;
+    /** Normalized absolute path (only if valid) */
+    path?: string;
+    /** Error message (only if invalid) */
+    error?: string;
+}
+/**
+ * Validate a path for Kit operations.
+ *
+ * Checks:
+ * - Path exists
+ * - Path is a directory (for search operations)
+ * - No path traversal attacks (.. sequences escaping base)
+ *
+ * @param inputPath - Path to validate
+ * @param options - Validation options
+ * @returns Validation result with normalized path or error
+ */
+export declare function validatePath(inputPath: string, options?: {
+    /** Base directory to restrict access within (optional) */
+    basePath?: string;
+    /** Whether the path must be a directory (default: true) */
+    mustBeDirectory?: boolean;
+    /** Whether the path must exist (default: true) */
+    mustExist?: boolean;
+}): PathValidationResult;
+/**
+ * Validate a number is a positive integer within bounds.
+ * @deprecated Use validateInteger from @sidequest/core/validation instead
+ * @param value - Value to validate
+ * @param options - Validation options
+ * @returns Validation result
+ */
+export declare function validatePositiveInt(value: unknown, options: {
+    /** Field name for error messages */
+    name: string;
+    /** Minimum allowed value (default: 1) */
+    min?: number;
+    /** Maximum allowed value (default: 10000) */
+    max?: number;
+    /** Default value if undefined */
+    defaultValue?: number;
+}): {
+    valid: boolean;
+    value?: number;
+    error?: string;
+};
+/**
+ * Validate all inputs for a grep search operation.
+ * @param inputs - Grep inputs to validate
+ * @returns Combined validation result
+ */
+export declare function validateGrepInputs(inputs: {
+    pattern: string;
+    path?: string;
+    include?: string;
+    exclude?: string;
+    maxResults?: number;
+}): {
+    valid: boolean;
+    errors: string[];
+    validated?: {
+        pattern: string;
+        path: string;
+        include?: string;
+        exclude?: string;
+        maxResults: number;
+    };
+};
+/**
+ * Validate all inputs for a semantic search operation.
+ * @param inputs - Semantic search inputs to validate
+ * @returns Combined validation result
+ */
+export declare function validateSemanticInputs(inputs: {
+    query: string;
+    path?: string;
+    topK?: number;
+}): {
+    valid: boolean;
+    errors: string[];
+    validated?: {
+        query: string;
+        path: string;
+        topK: number;
+    };
+};
+/**
+ * Validate all inputs for a symbol usages operation.
+ * @param inputs - Usages inputs to validate
+ * @returns Combined validation result
+ */
+export declare function validateUsagesInputs(inputs: {
+    path?: string;
+    symbolName: string;
+    symbolType?: string;
+}): {
+    valid: boolean;
+    errors: string[];
+    validated?: {
+        path: string;
+        symbolName: string;
+        symbolType?: string;
+    };
+};
+/**
+ * Validate all inputs for an AST search operation.
+ * @param inputs - AST search inputs to validate
+ * @returns Combined validation result
+ */
+export declare function validateAstSearchInputs(inputs: {
+    pattern: string;
+    mode?: string;
+    filePattern?: string;
+    path?: string;
+    maxResults?: number;
+}): {
+    valid: boolean;
+    errors: string[];
+    validated?: {
+        pattern: string;
+        mode: 'simple' | 'pattern';
+        filePattern?: string;
+        path: string;
+        maxResults: number;
+    };
+};
+//# sourceMappingURL=validators.d.ts.map

package/dist/lib/validators.d.ts.map

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