attocode 0.2.3 → 0.2.5

package/dist/src/integrations/utilities/rules.js

@@ -0,0 +1,284 @@
+/**
+ * Lesson 25: Rules System Integration
+ *
+ * Loads and applies rules from CLAUDE.md and other sources (from Lesson 12).
+ * Rules can modify the system prompt, add constraints, or provide context.
+ */
+import { readFile } from 'node:fs/promises';
+import { existsSync, watch } from 'node:fs';
+import { resolve } from 'node:path';
+// =============================================================================
+// RULES MANAGER
+// =============================================================================
+/**
+ * RulesManager loads and manages rules from various sources.
+ */
+export class RulesManager {
+    config;
+    rules = [];
+    listeners = [];
+    watchers = [];
+    baseDir;
+    constructor(config = {}, baseDir) {
+        this.config = {
+            enabled: config.enabled ?? true,
+            sources: config.sources ?? [],
+            watch: config.watch ?? false,
+        };
+        this.baseDir = baseDir || process.cwd();
+    }
+    /**
+     * Load rules from configured sources.
+     */
+    async loadRules() {
+        if (!this.config.enabled)
+            return;
+        this.rules = [];
+        const loadedSources = [];
+        for (const source of this.config.sources || []) {
+            try {
+                const rule = await this.loadSource(source);
+                if (rule) {
+                    this.rules.push(rule);
+                    loadedSources.push(rule.source);
+                }
+            }
+            catch (err) {
+                const error = err instanceof Error ? err.message : String(err);
+                this.emit({ type: 'rules.error', source: source.path || 'inline', error });
+            }
+        }
+        // Sort by priority (higher first)
+        this.rules.sort((a, b) => b.priority - a.priority);
+        this.emit({ type: 'rules.loaded', count: this.rules.length, sources: loadedSources });
+        // Setup watchers if configured
+        if (this.config.watch) {
+            this.setupWatchers();
+        }
+    }
+    /**
+     * Load a single rule source.
+     */
+    async loadSource(source) {
+        if (source.type === 'inline' && source.content) {
+            return {
+                source: 'inline',
+                content: source.content,
+                priority: source.priority ?? 0,
+                loadedAt: new Date(),
+            };
+        }
+        if (source.type === 'file' && source.path) {
+            const resolvedPath = resolve(this.baseDir, source.path);
+            if (!existsSync(resolvedPath)) {
+                // File doesn't exist - not an error, just skip
+                return null;
+            }
+            const content = await readFile(resolvedPath, 'utf-8');
+            return {
+                source: resolvedPath,
+                content: content.trim(),
+                priority: source.priority ?? 0,
+                loadedAt: new Date(),
+            };
+        }
+        return null;
+    }
+    /**
+     * Setup file watchers for auto-reload.
+     */
+    setupWatchers() {
+        // Clean up existing watchers
+        this.cleanupWatchers();
+        for (const source of this.config.sources || []) {
+            if (source.type === 'file' && source.path) {
+                const resolvedPath = resolve(this.baseDir, source.path);
+                if (existsSync(resolvedPath)) {
+                    try {
+                        const watcher = watch(resolvedPath, async (eventType) => {
+                            if (eventType === 'change') {
+                                await this.reloadSource(source);
+                            }
+                        });
+                        this.watchers.push(watcher);
+                    }
+                    catch {
+                        // Ignore watch errors (e.g., file system doesn't support watching)
+                    }
+                }
+            }
+        }
+    }
+    /**
+     * Reload a specific source.
+     */
+    async reloadSource(source) {
+        try {
+            const rule = await this.loadSource(source);
+            if (rule) {
+                // Find and replace existing rule from this source
+                const existingIndex = this.rules.findIndex(r => r.source === rule.source);
+                if (existingIndex >= 0) {
+                    this.rules[existingIndex] = rule;
+                }
+                else {
+                    this.rules.push(rule);
+                    this.rules.sort((a, b) => b.priority - a.priority);
+                }
+                this.emit({ type: 'rules.reloaded', source: rule.source });
+            }
+        }
+        catch (err) {
+            const error = err instanceof Error ? err.message : String(err);
+            this.emit({ type: 'rules.error', source: source.path || 'inline', error });
+        }
+    }
+    /**
+     * Clean up watchers.
+     */
+    cleanupWatchers() {
+        for (const watcher of this.watchers) {
+            watcher.close();
+        }
+        this.watchers = [];
+    }
+    /**
+     * Get all rules as a combined string for system prompt.
+     */
+    getRulesContent() {
+        if (this.rules.length === 0)
+            return '';
+        return this.rules
+            .map(r => `# Rules from ${r.source}\n\n${r.content}`)
+            .join('\n\n---\n\n');
+    }
+    /**
+     * Get rules as context strings for memory augmentation.
+     */
+    getRulesContext() {
+        return this.rules.map(r => r.content);
+    }
+    /**
+     * Get loaded rules.
+     */
+    getLoadedRules() {
+        return [...this.rules];
+    }
+    /**
+     * Add a rule at runtime.
+     */
+    addRule(content, priority = 0, source = 'runtime') {
+        this.rules.push({
+            source,
+            content,
+            priority,
+            loadedAt: new Date(),
+        });
+        this.rules.sort((a, b) => b.priority - a.priority);
+    }
+    /**
+     * Remove a rule by source.
+     */
+    removeRule(source) {
+        const index = this.rules.findIndex(r => r.source === source);
+        if (index >= 0) {
+            this.rules.splice(index, 1);
+            return true;
+        }
+        return false;
+    }
+    /**
+     * Subscribe to events.
+     */
+    on(listener) {
+        this.listeners.push(listener);
+        return () => {
+            const idx = this.listeners.indexOf(listener);
+            if (idx >= 0)
+                this.listeners.splice(idx, 1);
+        };
+    }
+    /**
+     * Emit an event.
+     */
+    emit(event) {
+        for (const listener of this.listeners) {
+            try {
+                listener(event);
+            }
+            catch {
+                // Ignore listener errors
+            }
+        }
+    }
+    /**
+     * Cleanup resources.
+     */
+    cleanup() {
+        this.cleanupWatchers();
+        this.listeners = [];
+        this.rules = [];
+    }
+}
+// =============================================================================
+// FACTORY
+// =============================================================================
+/**
+ * Create a rules manager and load rules.
+ */
+export async function createRulesManager(config, baseDir) {
+    const manager = new RulesManager(config, baseDir);
+    await manager.loadRules();
+    return manager;
+}
+// =============================================================================
+// DEFAULT SOURCES
+// =============================================================================
+/**
+ * Default rule sources to check.
+ */
+export const DEFAULT_RULE_SOURCES = [
+    // Project-level rules (highest priority)
+    { type: 'file', path: '.agent/rules.md', priority: 10 },
+    // Global CLAUDE.md at project root
+    { type: 'file', path: 'CLAUDE.md', priority: 5 },
+    // Alternative locations
+    { type: 'file', path: '.agent/CLAUDE.md', priority: 5 },
+    { type: 'file', path: 'docs/CLAUDE.md', priority: 3 },
+];
+/**
+ * Parse rules from markdown content.
+ * Extracts sections and returns structured rules.
+ */
+export function parseRulesFromMarkdown(content) {
+    const sections = [];
+    const lines = content.split('\n');
+    let currentHeading = '';
+    let currentContent = [];
+    for (const line of lines) {
+        const headingMatch = line.match(/^(#{1,3})\s+(.+)$/);
+        if (headingMatch) {
+            // Save previous section
+            if (currentHeading || currentContent.length > 0) {
+                sections.push({
+                    heading: currentHeading,
+                    content: currentContent.join('\n').trim(),
+                });
+            }
+            currentHeading = headingMatch[2];
+            currentContent = [];
+        }
+        else {
+            currentContent.push(line);
+        }
+    }
+    // Save last section
+    if (currentHeading || currentContent.length > 0) {
+        sections.push({
+            heading: currentHeading,
+            content: currentContent.join('\n').trim(),
+        });
+    }
+    return { sections, raw: content };
+}
+//# sourceMappingURL=rules.js.map

package/dist/src/integrations/utilities/rules.js.map

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

package/dist/src/integrations/utilities/sourcegraph.d.ts

@@ -0,0 +1,169 @@
+/**
+ * Sourcegraph Integration
+ *
+ * Cross-repository code search using Sourcegraph API.
+ * Enables searching across multiple codebases for patterns, references, and definitions.
+ *
+ * @example
+ * ```typescript
+ * const sg = createSourcegraphClient();
+ * const results = await sg.search('context:global repo:^github.com/org func:handleAuth');
+ * ```
+ */
+/**
+ * Sourcegraph client configuration.
+ */
+export interface SourcegraphConfig {
+    /** Sourcegraph instance URL (default: sourcegraph.com) */
+    endpoint?: string;
+    /** Access token (from SOURCEGRAPH_ACCESS_TOKEN env or explicit) */
+    accessToken?: string;
+    /** Default search context */
+    defaultContext?: string;
+    /** Request timeout in ms (default: 30000) */
+    timeout?: number;
+}
+/**
+ * Search query options.
+ */
+export interface SearchOptions {
+    /** Search context (e.g., 'global', '@myorg') */
+    context?: string;
+    /** Maximum number of results */
+    maxResults?: number;
+    /** Pattern type: literal, regexp, structural */
+    patternType?: 'literal' | 'regexp' | 'structural';
+    /** Case sensitivity */
+    caseSensitive?: boolean;
+    /** Repository filter pattern */
+    repoFilter?: string;
+    /** File filter pattern */
+    fileFilter?: string;
+    /** Language filter */
+    language?: string;
+}
+/**
+ * A single search result.
+ */
+export interface SearchResult {
+    /** Repository name */
+    repository: string;
+    /** File path within repository */
+    filePath: string;
+    /** File URL on Sourcegraph */
+    fileUrl: string;
+    /** Matching line numbers */
+    lineNumbers: number[];
+    /** Preview content (with highlights) */
+    preview: string;
+    /** Match type */
+    matchType: 'content' | 'path' | 'symbol' | 'commit';
+    /** Match score/rank */
+    score?: number;
+}
+/**
+ * Search response.
+ */
+export interface SearchResponse {
+    /** Search results */
+    results: SearchResult[];
+    /** Total match count */
+    matchCount: number;
+    /** Search duration in ms */
+    durationMs: number;
+    /** Whether results were limited */
+    limitHit: boolean;
+    /** Alert messages (e.g., query suggestions) */
+    alerts?: string[];
+}
+/**
+ * Symbol information.
+ */
+export interface SymbolInfo {
+    /** Symbol name */
+    name: string;
+    /** Symbol kind (function, class, variable, etc.) */
+    kind: string;
+    /** Container name (parent class/module) */
+    containerName?: string;
+    /** File path */
+    filePath: string;
+    /** Repository */
+    repository: string;
+    /** Line range */
+    range: {
+        start: {
+            line: number;
+            character: number;
+        };
+        end: {
+            line: number;
+            character: number;
+        };
+    };
+}
+/**
+ * Sourcegraph API client.
+ */
+export declare class SourcegraphClient {
+    private config;
+    constructor(config?: SourcegraphConfig);
+    /**
+     * Check if the client is configured with valid credentials.
+     */
+    isConfigured(): boolean;
+    /**
+     * Search code across repositories.
+     */
+    search(query: string, options?: SearchOptions): Promise<SearchResponse>;
+    /**
+     * Search for symbols (functions, classes, etc.).
+     */
+    searchSymbols(query: string, options?: SearchOptions): Promise<SymbolInfo[]>;
+    /**
+     * Find references to a symbol.
+     */
+    findReferences(symbolName: string, options?: SearchOptions): Promise<SearchResponse>;
+    /**
+     * Find definition of a symbol.
+     */
+    findDefinition(symbolName: string, language?: string): Promise<SymbolInfo[]>;
+    /**
+     * Search for files by path pattern.
+     */
+    searchFiles(pathPattern: string, options?: SearchOptions): Promise<SearchResponse>;
+    /**
+     * Get repository information.
+     */
+    getRepository(repoName: string): Promise<{
+        name: string;
+        description?: string;
+        url: string;
+        defaultBranch?: string;
+    } | null>;
+    /**
+     * Build a full query string with options.
+     */
+    private buildQuery;
+    /**
+     * Execute a GraphQL query.
+     */
+    private graphql;
+    /**
+     * Escape special regex characters.
+     */
+    private escapeRegex;
+}
+/**
+ * Create a Sourcegraph client.
+ */
+export declare function createSourcegraphClient(config?: SourcegraphConfig): SourcegraphClient;
+/**
+ * Format search results for display.
+ */
+export declare function formatSearchResults(response: SearchResponse, maxPreviewLines?: number): string;
+/**
+ * Check if Sourcegraph is configured.
+ */
+export declare function isSourcegraphConfigured(): boolean;
+//# sourceMappingURL=sourcegraph.d.ts.map

package/dist/src/integrations/utilities/sourcegraph.d.ts.map

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