ghcralph 0.1.0

package/dist/core/config-manager.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Configuration Manager
+ *
+ * Handles loading, saving, and merging configuration from multiple sources
+ */
+import { DEFAULT_CONFIG, isValidConfigKey, validateConfigValue, parseConfigValue, type RalphConfiguration, type ConfigKey } from './config-schema.js';
+/**
+ * Get the global configuration file path
+ */
+export declare function getGlobalConfigPath(): string;
+/**
+ * Get the local configuration file path
+ */
+export declare function getLocalConfigPath(projectRoot?: string): string;
+/**
+ * Configuration manager class
+ */
+export declare class ConfigManager {
+    private config;
+    private projectRoot;
+    constructor(projectRoot?: string);
+    /**
+     * Load configuration from all sources
+     * Priority: CLI flags > Env vars > Local config > Global config > Defaults
+     */
+    load(cliOverrides?: Partial<RalphConfiguration>): Promise<RalphConfiguration>;
+    /**
+     * Get the current configuration
+     */
+    getConfig(): RalphConfiguration;
+    /**
+     * Get a specific configuration value
+     */
+    get<K extends ConfigKey>(key: K): RalphConfiguration[K];
+    /**
+     * Set a configuration value (in memory)
+     */
+    set<K extends ConfigKey>(key: K, value: RalphConfiguration[K]): void;
+    /**
+     * Save configuration to local config file
+     */
+    saveLocal(): Promise<void>;
+    /**
+     * Save configuration to global config file
+     */
+    saveGlobal(): Promise<void>;
+    /**
+     * Reset configuration to defaults
+     */
+    reset(): void;
+    /**
+     * Check if local configuration exists
+     */
+    hasLocalConfig(): Promise<boolean>;
+    /**
+     * Initialize local configuration directory
+     */
+    initLocal(): Promise<string>;
+}
+export { isValidConfigKey, validateConfigValue, parseConfigValue, DEFAULT_CONFIG };
+export type { RalphConfiguration, ConfigKey };
+//# sourceMappingURL=config-manager.d.ts.map

package/dist/core/config-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-manager.d.ts","sourceRoot":"","sources":["../../src/core/config-manager.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,mBAAmB,EACnB,gBAAgB,EAChB,KAAK,kBAAkB,EACvB,KAAK,SAAS,EACf,MAAM,oBAAoB,CAAC;AAoE5B;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,CAE5C;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAE/D;AAED;;GAEG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,WAAW,CAAqB;gBAE5B,WAAW,CAAC,EAAE,MAAM;IAKhC;;;OAGG;IACG,IAAI,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC,kBAAkB,CAAC,GAAG,OAAO,CAAC,kBAAkB,CAAC;IA6BnF;;OAEG;IACH,SAAS,IAAI,kBAAkB;IAI/B;;OAEG;IACH,GAAG,CAAC,CAAC,SAAS,SAAS,EAAE,GAAG,EAAE,CAAC,GAAG,kBAAkB,CAAC,CAAC,CAAC;IAIvD;;OAEG;IACH,GAAG,CAAC,CAAC,SAAS,SAAS,EAAE,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,kBAAkB,CAAC,CAAC,CAAC,GAAG,IAAI;IAQpE;;OAEG;IACG,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAMhC;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAMjC;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;OAEG;IACG,cAAc,IAAI,OAAO,CAAC,OAAO,CAAC;IASxC;;OAEG;IACG,SAAS,IAAI,OAAO,CAAC,MAAM,CAAC;CAMnC;AAGD,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,cAAc,EAAE,CAAC;AACnF,YAAY,EAAE,kBAAkB,EAAE,SAAS,EAAE,CAAC"}

package/dist/core/config-manager.js

@@ -0,0 +1,184 @@
+/**
+ * Configuration Manager
+ *
+ * Handles loading, saving, and merging configuration from multiple sources
+ */
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { getConfigDir, getLocalStateDir } from '../utils/paths.js';
+import { debug } from '../utils/output.js';
+import { DEFAULT_CONFIG, isValidConfigKey, validateConfigValue, parseConfigValue, } from './config-schema.js';
+/**
+ * Configuration file names
+ */
+const GLOBAL_CONFIG_FILE = 'config.json';
+const LOCAL_CONFIG_FILE = 'config.json';
+/**
+ * Environment variable prefix
+ */
+const ENV_PREFIX = 'GHCRALPH_';
+/**
+ * Load configuration from a JSON file
+ */
+async function loadConfigFile(filePath) {
+    try {
+        const content = await fs.readFile(filePath, 'utf-8');
+        return JSON.parse(content);
+    }
+    catch {
+        return {};
+    }
+}
+/**
+ * Save configuration to a JSON file
+ */
+async function saveConfigFile(filePath, config) {
+    const dir = path.dirname(filePath);
+    await fs.mkdir(dir, { recursive: true });
+    await fs.writeFile(filePath, JSON.stringify(config, null, 2) + '\n');
+}
+/**
+ * Load configuration from environment variables
+ */
+function loadEnvConfig() {
+    const config = {};
+    const envMappings = {
+        [`${ENV_PREFIX}PLAN_SOURCE`]: 'planSource',
+        [`${ENV_PREFIX}MAX_ITERATIONS`]: 'maxIterations',
+        [`${ENV_PREFIX}MAX_TOKENS`]: 'maxTokens',
+        [`${ENV_PREFIX}DEFAULT_MODEL`]: 'defaultModel',
+        [`${ENV_PREFIX}AUTO_COMMIT`]: 'autoCommit',
+        [`${ENV_PREFIX}BRANCH_PREFIX`]: 'branchPrefix',
+        [`${ENV_PREFIX}GITHUB_REPO`]: 'githubRepo',
+        [`${ENV_PREFIX}LOCAL_PLAN_FILE`]: 'localPlanFile',
+    };
+    for (const [envVar, configKey] of Object.entries(envMappings)) {
+        const value = process.env[envVar];
+        if (value !== undefined) {
+            const parsed = parseConfigValue(configKey, value);
+            const validation = validateConfigValue(configKey, parsed);
+            if (validation.valid) {
+                config[configKey] = parsed;
+            }
+        }
+    }
+    return config;
+}
+/**
+ * Get the global configuration file path
+ */
+export function getGlobalConfigPath() {
+    return path.join(getConfigDir(), GLOBAL_CONFIG_FILE);
+}
+/**
+ * Get the local configuration file path
+ */
+export function getLocalConfigPath(projectRoot) {
+    return path.join(getLocalStateDir(projectRoot), LOCAL_CONFIG_FILE);
+}
+/**
+ * Configuration manager class
+ */
+export class ConfigManager {
+    config;
+    projectRoot;
+    constructor(projectRoot) {
+        this.config = { ...DEFAULT_CONFIG };
+        this.projectRoot = projectRoot;
+    }
+    /**
+     * Load configuration from all sources
+     * Priority: CLI flags > Env vars > Local config > Global config > Defaults
+     */
+    async load(cliOverrides) {
+        // Start with defaults
+        this.config = { ...DEFAULT_CONFIG };
+        // Load global config
+        const globalConfigPath = getGlobalConfigPath();
+        const globalConfig = await loadConfigFile(globalConfigPath);
+        debug(`Loaded global config from ${globalConfigPath}`);
+        // Load local config
+        const localConfigPath = getLocalConfigPath(this.projectRoot);
+        const localConfig = await loadConfigFile(localConfigPath);
+        debug(`Loaded local config from ${localConfigPath}`);
+        // Load env config
+        const envConfig = loadEnvConfig();
+        // Merge in priority order
+        this.config = {
+            ...this.config,
+            ...globalConfig,
+            ...localConfig,
+            ...envConfig,
+            ...cliOverrides,
+        };
+        return this.config;
+    }
+    /**
+     * Get the current configuration
+     */
+    getConfig() {
+        return { ...this.config };
+    }
+    /**
+     * Get a specific configuration value
+     */
+    get(key) {
+        return this.config[key];
+    }
+    /**
+     * Set a configuration value (in memory)
+     */
+    set(key, value) {
+        const validation = validateConfigValue(key, value);
+        if (!validation.valid) {
+            throw new Error(validation.error);
+        }
+        this.config[key] = value;
+    }
+    /**
+     * Save configuration to local config file
+     */
+    async saveLocal() {
+        const configPath = getLocalConfigPath(this.projectRoot);
+        await saveConfigFile(configPath, this.config);
+        debug(`Saved local config to ${configPath}`);
+    }
+    /**
+     * Save configuration to global config file
+     */
+    async saveGlobal() {
+        const configPath = getGlobalConfigPath();
+        await saveConfigFile(configPath, this.config);
+        debug(`Saved global config to ${configPath}`);
+    }
+    /**
+     * Reset configuration to defaults
+     */
+    reset() {
+        this.config = { ...DEFAULT_CONFIG };
+    }
+    /**
+     * Check if local configuration exists
+     */
+    async hasLocalConfig() {
+        try {
+            await fs.access(getLocalConfigPath(this.projectRoot));
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Initialize local configuration directory
+     */
+    async initLocal() {
+        const stateDir = getLocalStateDir(this.projectRoot);
+        await fs.mkdir(stateDir, { recursive: true });
+        await this.saveLocal();
+        return stateDir;
+    }
+}
+// Export for convenience
+export { isValidConfigKey, validateConfigValue, parseConfigValue, DEFAULT_CONFIG };
+//# sourceMappingURL=config-manager.js.map

package/dist/core/config-manager.js.map

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

package/dist/core/config-schema.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Configuration Schema
+ *
+ * Type definitions for GitHub Copilot Ralph CLI configuration
+ */
+/**
+ * Plan source type
+ */
+export type PlanSource = 'github' | 'local';
+/**
+ * MCP Server configuration for custom tools
+ */
+export interface MCPServerConfiguration {
+    /** Name of the MCP server */
+    name: string;
+    /** Command to run the server */
+    command: string;
+    /** Arguments to pass to the command */
+    args?: string[];
+    /** Transport type (stdio or http) */
+    transport?: 'stdio' | 'http';
+    /** HTTP endpoint (for http transport) */
+    endpoint?: string;
+}
+/**
+ * GitHub Copilot Ralph CLI configuration
+ */
+export interface RalphConfiguration {
+    /** Source for the plan: GitHub Issues or local Markdown */
+    planSource: PlanSource;
+    /** Maximum number of loop iterations */
+    maxIterations: number;
+    /** Maximum token budget for the session */
+    maxTokens: number;
+    /** Default Copilot model to use (gpt-4.1 has 0x multiplier) */
+    defaultModel: string;
+    /** Whether to auto-commit after each iteration */
+    autoCommit: boolean;
+    /** Prefix for GitHub Copilot Ralph branches */
+    branchPrefix: string;
+    /** GitHub repository (owner/repo) for GitHub plan source */
+    githubRepo?: string;
+    /** Local plan file path for local plan source */
+    localPlanFile?: string;
+    /** Custom prompt template */
+    promptTemplate?: string;
+    /** MCP servers for custom tools */
+    mcpServers?: MCPServerConfiguration[];
+}
+/**
+ * Default configuration values
+ */
+export declare const DEFAULT_CONFIG: RalphConfiguration;
+/**
+ * Configuration keys for validation
+ */
+export declare const CONFIG_KEYS: readonly ["planSource", "maxIterations", "maxTokens", "defaultModel", "autoCommit", "branchPrefix", "githubRepo", "localPlanFile", "promptTemplate", "mcpServers"];
+export type ConfigKey = (typeof CONFIG_KEYS)[number];
+/**
+ * Check if a string is a valid config key
+ */
+export declare function isValidConfigKey(key: string): key is ConfigKey;
+/**
+ * Validate a configuration value for a key
+ */
+export declare function validateConfigValue(key: ConfigKey, value: unknown): {
+    valid: boolean;
+    error?: string;
+};
+/**
+ * Parse a string value to the appropriate type for a config key
+ */
+export declare function parseConfigValue(key: ConfigKey, value: string): unknown;
+//# sourceMappingURL=config-schema.d.ts.map

package/dist/core/config-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-schema.d.ts","sourceRoot":"","sources":["../../src/core/config-schema.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,OAAO,CAAC;AAE5C;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,6BAA6B;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,gCAAgC;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,uCAAuC;IACvC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,qCAAqC;IACrC,SAAS,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IAC7B,yCAAyC;IACzC,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,2DAA2D;IAC3D,UAAU,EAAE,UAAU,CAAC;IACvB,wCAAwC;IACxC,aAAa,EAAE,MAAM,CAAC;IACtB,2CAA2C;IAC3C,SAAS,EAAE,MAAM,CAAC;IAClB,+DAA+D;IAC/D,YAAY,EAAE,MAAM,CAAC;IACrB,kDAAkD;IAClD,UAAU,EAAE,OAAO,CAAC;IACpB,+CAA+C;IAC/C,YAAY,EAAE,MAAM,CAAC;IACrB,4DAA4D;IAC5D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iDAAiD;IACjD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,6BAA6B;IAC7B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,mCAAmC;IACnC,UAAU,CAAC,EAAE,sBAAsB,EAAE,CAAC;CACvC;AAED;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,kBAO5B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,WAAW,oKAWd,CAAC;AAEX,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC;AAErD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,IAAI,SAAS,CAE9D;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,SAAS,EACd,KAAK,EAAE,OAAO,GACb;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CA4BpC;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAUvE"}

package/dist/core/config-schema.js

@@ -0,0 +1,84 @@
+/**
+ * Configuration Schema
+ *
+ * Type definitions for GitHub Copilot Ralph CLI configuration
+ */
+/**
+ * Default configuration values
+ */
+export const DEFAULT_CONFIG = {
+    planSource: 'local',
+    maxIterations: 10,
+    maxTokens: 100000,
+    defaultModel: 'gpt-4.1',
+    autoCommit: true,
+    branchPrefix: 'ghcralph/',
+};
+/**
+ * Configuration keys for validation
+ */
+export const CONFIG_KEYS = [
+    'planSource',
+    'maxIterations',
+    'maxTokens',
+    'defaultModel',
+    'autoCommit',
+    'branchPrefix',
+    'githubRepo',
+    'localPlanFile',
+    'promptTemplate',
+    'mcpServers',
+];
+/**
+ * Check if a string is a valid config key
+ */
+export function isValidConfigKey(key) {
+    return CONFIG_KEYS.includes(key);
+}
+/**
+ * Validate a configuration value for a key
+ */
+export function validateConfigValue(key, value) {
+    switch (key) {
+        case 'planSource':
+            if (value !== 'github' && value !== 'local') {
+                return { valid: false, error: 'planSource must be "github" or "local"' };
+            }
+            break;
+        case 'maxIterations':
+        case 'maxTokens':
+            if (typeof value !== 'number' || value < 1) {
+                return { valid: false, error: `${key} must be a positive number` };
+            }
+            break;
+        case 'autoCommit':
+            if (typeof value !== 'boolean') {
+                return { valid: false, error: 'autoCommit must be a boolean' };
+            }
+            break;
+        case 'defaultModel':
+        case 'branchPrefix':
+        case 'githubRepo':
+        case 'localPlanFile':
+            if (typeof value !== 'string') {
+                return { valid: false, error: `${key} must be a string` };
+            }
+            break;
+    }
+    return { valid: true };
+}
+/**
+ * Parse a string value to the appropriate type for a config key
+ */
+export function parseConfigValue(key, value) {
+    switch (key) {
+        case 'maxIterations':
+        case 'maxTokens':
+            return parseInt(value, 10);
+        case 'autoCommit':
+            return value.toLowerCase() === 'true';
+        default:
+            return value;
+    }
+}
+//# sourceMappingURL=config-schema.js.map

package/dist/core/config-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-schema.js","sourceRoot":"","sources":["../../src/core/config-schema.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAiDH;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAuB;IAChD,UAAU,EAAE,OAAO;IACnB,aAAa,EAAE,EAAE;IACjB,SAAS,EAAE,MAAM;IACjB,YAAY,EAAE,SAAS;IACvB,UAAU,EAAE,IAAI;IAChB,YAAY,EAAE,WAAW;CAC1B,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,YAAY;IACZ,eAAe;IACf,WAAW;IACX,cAAc;IACd,YAAY;IACZ,cAAc;IACd,YAAY;IACZ,eAAe;IACf,gBAAgB;IAChB,YAAY;CACJ,CAAC;AAIX;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,GAAW;IAC1C,OAAO,WAAW,CAAC,QAAQ,CAAC,GAAgB,CAAC,CAAC;AAChD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CACjC,GAAc,EACd,KAAc;IAEd,QAAQ,GAAG,EAAE,CAAC;QACZ,KAAK,YAAY;YACf,IAAI,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,OAAO,EAAE,CAAC;gBAC5C,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,wCAAwC,EAAE,CAAC;YAC3E,CAAC;YACD,MAAM;QACR,KAAK,eAAe,CAAC;QACrB,KAAK,WAAW;YACd,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;gBAC3C,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,GAAG,4BAA4B,EAAE,CAAC;YACrE,CAAC;YACD,MAAM;QACR,KAAK,YAAY;YACf,IAAI,OAAO,KAAK,KAAK,SAAS,EAAE,CAAC;gBAC/B,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,8BAA8B,EAAE,CAAC;YACjE,CAAC;YACD,MAAM;QACR,KAAK,cAAc,CAAC;QACpB,KAAK,cAAc,CAAC;QACpB,KAAK,YAAY,CAAC;QAClB,KAAK,eAAe;YAClB,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;gBAC9B,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,GAAG,mBAAmB,EAAE,CAAC;YAC5D,CAAC;YACD,MAAM;IACV,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;AACzB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,GAAc,EAAE,KAAa;IAC5D,QAAQ,GAAG,EAAE,CAAC;QACZ,KAAK,eAAe,CAAC;QACrB,KAAK,WAAW;YACd,OAAO,QAAQ,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QAC7B,KAAK,YAAY;YACf,OAAO,KAAK,CAAC,WAAW,EAAE,KAAK,MAAM,CAAC;QACxC;YACE,OAAO,KAAK,CAAC;IACjB,CAAC;AACH,CAAC"}

package/dist/core/context-builder.d.ts

@@ -0,0 +1,116 @@
+/**
+ * Context Builder
+ *
+ * Builds rich context for AI agent prompts including relevant files,
+ * git history, and previous iteration results.
+ */
+import type { Task } from '../types/index.js';
+import type { IterationRecord } from './loop-state.js';
+/**
+ * Context builder configuration
+ */
+export interface ContextBuilderConfig {
+    /** Maximum tokens to allow for context */
+    maxContextTokens: number;
+    /** Glob patterns for explicit context files */
+    contextGlobs?: string[];
+    /** Custom prompt template */
+    promptTemplate?: string;
+    /** Whether to include git diff in context */
+    includeGitDiff?: boolean;
+    /** Whether to include git history in context */
+    includeGitHistory?: boolean;
+    /** Number of git history entries to include */
+    gitHistoryLimit?: number;
+    /** Whether to include project structure */
+    includeProjectStructure?: boolean;
+    /**
+     * Fresh context per iteration (Ralph pattern core principle)
+     * When true, previous iteration summaries are NOT included.
+     * The AI should rely on filesystem state (git diff) instead.
+     */
+    freshContextPerIteration?: boolean;
+    /**
+     * Whether to include meta info like iteration counts in prompt.
+     * Default: false (Ralph pattern recommendation)
+     * Set to true for legacy behavior with iteration/token counts
+     */
+    includeMetaInfo?: boolean;
+    /**
+     * Model name for prompt customization.
+     * Used to determine how many examples to include.
+     * Weaker models get more detailed examples.
+     * Default: 'gpt-4.1'
+     */
+    model?: string;
+}
+/**
+ * Built context result
+ */
+export interface BuiltContext {
+    /** The complete prompt */
+    prompt: string;
+    /** Estimated token count */
+    estimatedTokens: number;
+    /** Files included in context */
+    filesIncluded: string[];
+    /** Whether context was truncated due to limits */
+    truncated: boolean;
+}
+/**
+ * Context builder for creating rich AI prompts
+ */
+export declare class ContextBuilder {
+    private config;
+    private cwd;
+    constructor(config?: Partial<ContextBuilderConfig>, cwd?: string);
+    /**
+     * Build a complete context prompt for the current iteration
+     */
+    buildContext(task: Task, iteration: number, maxIterations: number, tokensUsed: number, maxTokens: number, previousIterations?: IterationRecord[], feedbackSection?: string): Promise<BuiltContext>;
+    /**
+     * Get explicit context files from glob patterns
+     */
+    private getExplicitContextFiles;
+    /**
+     * Find relevant files based on task keywords
+     */
+    private findRelevantFiles;
+    /**
+     * Extract keywords from text
+     */
+    private extractKeywords;
+    /**
+     * Get current git diff
+     */
+    private getGitDiff;
+    /**
+     * Get recent git history
+     */
+    private getGitHistory;
+    /**
+     * Get project structure overview
+     */
+    private getProjectStructure;
+    /**
+     * Build previous progress section
+     */
+    private buildPreviousProgress;
+    /**
+     * Check if adding content would exceed token limit
+     */
+    private exceedsTokenLimit;
+    /**
+     * Estimate token count (rough approximation: ~4 chars per token)
+     */
+    private estimateTokens;
+    /**
+     * Truncate prompt to fit within limits
+     */
+    private truncatePrompt;
+}
+/**
+ * Create a context builder with custom configuration
+ */
+export declare function createContextBuilder(config?: Partial<ContextBuilderConfig>, cwd?: string): ContextBuilder;
+//# sourceMappingURL=context-builder.d.ts.map

package/dist/core/context-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-builder.d.ts","sourceRoot":"","sources":["../../src/core/context-builder.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAQH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAC9C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AA+CvD;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,0CAA0C;IAC1C,gBAAgB,EAAE,MAAM,CAAC;IACzB,+CAA+C;IAC/C,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,6BAA6B;IAC7B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,6CAA6C;IAC7C,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,gDAAgD;IAChD,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,+CAA+C;IAC/C,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,2CAA2C;IAC3C,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAClC;;;;OAIG;IACH,wBAAwB,CAAC,EAAE,OAAO,CAAC;IACnC;;;;OAIG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B;;;;;OAKG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAgBD;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,0BAA0B;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,4BAA4B;IAC5B,eAAe,EAAE,MAAM,CAAC;IACxB,gCAAgC;IAChC,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,kDAAkD;IAClD,SAAS,EAAE,OAAO,CAAC;CACpB;AAED;;GAEG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,GAAG,CAAS;gBAER,MAAM,GAAE,OAAO,CAAC,oBAAoB,CAAM,EAAE,GAAG,CAAC,EAAE,MAAM;IAKpE;;OAEG;IACG,YAAY,CAChB,IAAI,EAAE,IAAI,EACV,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE,MAAM,EACrB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EACjB,kBAAkB,GAAE,eAAe,EAAO,EAC1C,eAAe,CAAC,EAAE,MAAM,GACvB,OAAO,CAAC,YAAY,CAAC;IAmHxB;;OAEG;YACW,uBAAuB;IAuCrC;;OAEG;YACW,iBAAiB;IA0D/B;;OAEG;IACH,OAAO,CAAC,eAAe;IAqBvB;;OAEG;YACW,UAAU;IAqBxB;;OAEG;YACW,aAAa;IAc3B;;OAEG;YACW,mBAAmB;IAcjC;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAc7B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAKzB;;OAEG;IACH,OAAO,CAAC,cAAc;IAItB;;OAEG;IACH,OAAO,CAAC,cAAc;CAiBvB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,CAAC,EAAE,OAAO,CAAC,oBAAoB,CAAC,EACtC,GAAG,CAAC,EAAE,MAAM,GACX,cAAc,CAEhB"}