@windagency/valora 2.0.1

package/dist/executor/pipeline-validator.js

@@ -0,0 +1,105 @@
+/**
+ * Pipeline Validator - Validates pipeline structure and dependencies
+ *
+ * MAINT-002: Large Files Need Splitting - Extracted from pipeline.ts
+ */
+export class PipelineValidator {
+    /**
+     * Validate pipeline structure and dependencies
+     */
+    validatePipeline(stages) {
+        const errors = [];
+        if (!Array.isArray(stages)) {
+            errors.push('Pipeline must be an array of stages');
+            return errors;
+        }
+        if (stages.length === 0) {
+            errors.push('Pipeline must contain at least one stage');
+            return errors;
+        }
+        // Validate each stage
+        const allStageErrors = stages.flatMap((stage, i) => this.validateStage(stage, i));
+        errors.push(...allStageErrors);
+        // Validate stage dependencies
+        const dependencyErrors = this.validateDependencies(stages);
+        errors.push(...dependencyErrors);
+        return errors;
+    }
+    /**
+     * Validate individual stage structure
+     */
+    validateStage(stage, index) {
+        const errors = [];
+        const prefix = `Stage ${index + 1}`;
+        // Check required properties
+        if (!stage || typeof stage !== 'object') {
+            errors.push(`${prefix}: Stage must be an object`);
+            return errors;
+        }
+        // Validate required fields
+        const requiredFieldErrors = this.validateRequiredFields(stage, prefix);
+        errors.push(...requiredFieldErrors);
+        // Validate optional properties
+        const optionalFieldErrors = this.validateOptionalFields(stage, prefix);
+        errors.push(...optionalFieldErrors);
+        return errors;
+    }
+    /**
+     * Validate required stage fields
+     */
+    validateRequiredFields(stage, prefix) {
+        const errors = [];
+        if (!stage.stage || typeof stage.stage !== 'string') {
+            errors.push(`${prefix}: Missing or invalid 'stage' property`);
+        }
+        if (!stage.prompt || typeof stage.prompt !== 'string') {
+            errors.push(`${prefix}: Missing or invalid 'prompt' property`);
+        }
+        return errors;
+    }
+    /**
+     * Validate optional stage fields
+     */
+    validateOptionalFields(stage, prefix) {
+        const errors = [];
+        if (stage.parallel !== undefined && typeof stage.parallel !== 'boolean') {
+            errors.push(`${prefix}: 'parallel' property must be a boolean`);
+        }
+        if (stage.required !== undefined && typeof stage.required !== 'boolean') {
+            errors.push(`${prefix}: 'required' property must be a boolean`);
+        }
+        return errors;
+    }
+    /**
+     * Validate stage dependencies and execution order
+     */
+    validateDependencies(stages) {
+        const errors = [];
+        // Check for duplicate stage names using reduce
+        const stageNameCounts = stages.reduce((acc, stage) => {
+            acc.set(stage.stage, (acc.get(stage.stage) ?? 0) + 1);
+            return acc;
+        }, new Map());
+        const duplicateErrors = Array.from(stageNameCounts.entries())
+            .filter(([, count]) => count > 1)
+            .map(([stageName]) => `Duplicate stage name: ${stageName}`);
+        errors.push(...duplicateErrors);
+        // Validate parallel execution constraints
+        stages.reduce((_inParallelGroup, stage, i) => {
+            const prevStage = i > 0 ? stages[i - 1] : null;
+            if (stage.parallel) {
+                // Starting or continuing a parallel group
+                return true;
+            }
+            // Ending a parallel group
+            // Check that parallel stages don't have dependencies on each other
+            if (prevStage?.parallel) {
+                // This is a basic check - in a real implementation you'd check variable dependencies
+                // For now, just warn about potential issues
+            }
+            return false;
+        }, false);
+        return errors;
+    }
+}
+//# sourceMappingURL=pipeline-validator.js.map

package/dist/executor/pipeline-validator.js.map

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

package/dist/executor/pipeline.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Pipeline executor - executes prompt pipelines with sequential/parallel stages
+ *
+ * MAINT-002: Large Files Need Splitting - Refactored to use extracted classes:
+ * - StageScheduler -> stage-scheduler.ts
+ * - PipelineValidator -> pipeline-validator.ts
+ * - StageExecutor -> stage-executor.ts
+ */
+import type { CommandResult, PipelineStage } from '../types/command.types.js';
+import type { AgentLoader } from './agent-loader.js';
+import type { PromptLoader } from './prompt-loader.js';
+import { type PipelineEventEmitter } from './pipeline-events.js';
+import { type PipelineExecutionContext } from './stage-executor.js';
+/**
+ * Detect if running in a git worktree and return its info
+ */
+export declare class PipelineExecutor {
+    private eventEmitter;
+    private inputPreResolver;
+    private interactiveQuestionHandler;
+    private pipelineValidator;
+    private preResolvedInputs;
+    private stageExecutor;
+    private stageScheduler;
+    constructor(promptLoader: PromptLoader, agentLoader: AgentLoader, eventEmitter?: PipelineEventEmitter);
+    /**
+     * Execute a pipeline of stages
+     */
+    execute(stages: PipelineStage[], context: PipelineExecutionContext): Promise<CommandResult>;
+    /**
+     * Validate pipeline stages
+     */
+    validatePipeline(stages: PipelineStage[]): string[];
+    /**
+     * Merge outputs from all stages
+     */
+    private mergeOutputs;
+    /**
+     * Get pre-resolved inputs for a stage if available
+     * Returns undefined if no pre-resolved inputs exist
+     */
+    private getPreResolvedInputsForStage;
+    /**
+     * Handle interactive questions from a stage output
+     * If the stage produced clarifying questions and interactive mode is enabled,
+     * prompt the user for answers and store them for subsequent stages.
+     *
+     * @param result - The stage output to check for questions
+     * @param context - The pipeline execution context
+     * @param stage - The pipeline stage that was executed
+     * @returns true if questions were handled, false otherwise
+     */
+    private handleInteractiveQuestions;
+}
+//# sourceMappingURL=pipeline.d.ts.map

package/dist/executor/pipeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline.d.ts","sourceRoot":"","sources":["../../src/executor/pipeline.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAe,MAAM,qBAAqB,CAAC;AAOrF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAOpD,OAAO,EAAsB,KAAK,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAElF,OAAO,EACN,KAAK,wBAAwB,EAI7B,MAAM,kBAAkB,CAAC;AAG1B;;GAEG;AACH,qBAAa,gBAAgB;IAC5B,OAAO,CAAC,YAAY,CAAuB;IAC3C,OAAO,CAAC,gBAAgB,CAAmB;IAC3C,OAAO,CAAC,0BAA0B,CAAoC;IACtE,OAAO,CAAC,iBAAiB,CAAoB;IAC7C,OAAO,CAAC,iBAAiB,CAAkC;IAC3D,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,cAAc,CAAiB;gBAE3B,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,YAAY,CAAC,EAAE,oBAAoB;IASrG;;OAEG;IACG,OAAO,CAAC,MAAM,EAAE,aAAa,EAAE,EAAE,OAAO,EAAE,wBAAwB,GAAG,OAAO,CAAC,aAAa,CAAC;IAiQjG;;OAEG;IACH,gBAAgB,CAAC,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,EAAE;IAInD;;OAEG;IACH,OAAO,CAAC,YAAY;IAMpB;;;OAGG;IACH,OAAO,CAAC,4BAA4B;IASpC;;;;;;;;;OASG;YACW,0BAA0B;CAmDxC"}

package/dist/executor/pipeline.js

@@ -0,0 +1,360 @@
+/**
+ * Pipeline executor - executes prompt pipelines with sequential/parallel stages
+ *
+ * MAINT-002: Large Files Need Splitting - Refactored to use extracted classes:
+ * - StageScheduler -> stage-scheduler.ts
+ * - PipelineValidator -> pipeline-validator.ts
+ * - StageExecutor -> stage-executor.ts
+ */
+import { execSync } from 'child_process';
+import { getLogger } from '../output/logger.js';
+import { getProcessingFeedback } from '../output/processing-feedback.js';
+import { ExecutionError } from '../utils/error-handler.js';
+import { getInputPreResolver } from './input-pre-resolver.js';
+import { getInteractiveQuestionHandler } from './interactive-question-handler.service.js';
+import { getPipelineEmitter } from './pipeline-events.js';
+import { PipelineValidator } from './pipeline-validator.js';
+import { StageExecutor } from './stage-executor.js';
+import { StageScheduler } from './stage-scheduler.js';
+/**
+ * Detect if running in a git worktree and return its info
+ */
+export class PipelineExecutor {
+    eventEmitter;
+    inputPreResolver;
+    interactiveQuestionHandler;
+    pipelineValidator;
+    preResolvedInputs = null;
+    stageExecutor;
+    stageScheduler;
+    constructor(promptLoader, agentLoader, eventEmitter) {
+        this.stageScheduler = new StageScheduler();
+        this.pipelineValidator = new PipelineValidator();
+        this.eventEmitter = eventEmitter ?? getPipelineEmitter();
+        this.stageExecutor = new StageExecutor(promptLoader, agentLoader, this.eventEmitter);
+        this.interactiveQuestionHandler = getInteractiveQuestionHandler();
+        this.inputPreResolver = getInputPreResolver();
+    }
+    /**
+     * Execute a pipeline of stages
+     */
+    async execute(stages, context) {
+        const logger = getLogger();
+        const startTime = Date.now();
+        const { executionContext } = context;
+        // Reset tool execution state for new command (e.g., write confirmation mode)
+        this.stageExecutor.resetForNewCommand();
+        // Detect worktree info once at pipeline start
+        const worktreeInfo = detectWorktreeInfo();
+        logger.info(`Executing pipeline: ${executionContext.commandName}`, {
+            agent: executionContext.agentRole,
+            hasArgs: !!executionContext.args?.length,
+            stageCount: stages.length,
+            worktree: worktreeInfo?.branch
+        });
+        // Emit pipeline start event with session info
+        this.eventEmitter.emitPipelineStart({
+            agent: executionContext.agentRole,
+            commandName: executionContext.commandName,
+            model: executionContext.model,
+            sessionInfo: executionContext.sessionInfo
+                ? {
+                    isResumed: executionContext.sessionInfo.isResumed,
+                    sessionId: executionContext.sessionInfo.sessionId
+                }
+                : undefined,
+            stageCount: stages.length
+        });
+        try {
+            // Validate pipeline structure first
+            const validationErrors = this.pipelineValidator.validatePipeline(stages);
+            if (validationErrors.length > 0) {
+                throw new ExecutionError(`Pipeline validation failed: ${validationErrors.join(', ')}`, { validationErrors });
+            }
+            // Pre-resolve static inputs for optimization
+            // This caches file contents and resolves $ARG_*, $CONTEXT_*, $ENV_* variables upfront
+            const variableResolver = executionContext.getVariableResolver();
+            this.preResolvedInputs = await this.inputPreResolver.preResolveStaticInputs(stages, variableResolver);
+            // Group stages by parallel execution
+            const stageGroups = this.stageScheduler.groupStages(stages);
+            // Process stage groups sequentially using reduce
+            await stageGroups.reduce(async (previousPromise, group) => {
+                await previousPromise;
+                // Check if all required stages from previous groups have succeeded
+                const stageOutputs = executionContext.getStageOutputs();
+                const failedRequiredStages = stageOutputs.filter((output) => !output.success && stages.find((s) => s.stage === output.stage)?.required);
+                if (failedRequiredStages.length > 0) {
+                    const failedStageNames = failedRequiredStages.map((output) => output.stage).join(', ');
+                    throw new Error(`Cannot execute stage group: Required prerequisite stages failed: ${failedStageNames}`);
+                }
+                if (group.parallel) {
+                    // Execute stages in parallel (filtering out stages with false conditionals)
+                    const stageIndexStart = executionContext.getStageOutputs().length;
+                    const options = { isParallel: true, worktreeInfo };
+                    // Filter stages based on conditional evaluation
+                    const variableResolver = executionContext.getVariableResolver();
+                    const feedback = getProcessingFeedback();
+                    const eligibleStages = group.stages.filter((stage) => {
+                        if (!stage.conditional) {
+                            return true; // No conditional, always execute
+                        }
+                        const conditionalValue = variableResolver.resolve(stage.conditional);
+                        const shouldExecute = evaluateConditional(conditionalValue);
+                        if (!shouldExecute) {
+                            feedback.showInfo(`Skipping stage: ${stage.stage}.${stage.prompt} (conditional: ${stage.conditional} = ${conditionalValue})`);
+                        }
+                        return shouldExecute;
+                    });
+                    const results = await Promise.all(eligibleStages.map((stage, index) => {
+                        const stageOptions = {
+                            ...options,
+                            preResolvedInputs: this.getPreResolvedInputsForStage(stage)
+                        };
+                        return this.stageExecutor.executeStage(stage, context, stageIndexStart + index, stageOptions);
+                    }));
+                    // Record completed stages in execution context
+                    results.forEach((result) => {
+                        executionContext.recordStageCompletion(result);
+                    });
+                    // Check if we should stop (guided completion)
+                    if (results.some((r) => r.metadata?.['stopPipeline'])) {
+                        logger.info('Pipeline execution stopped by stage signal');
+                        throw new Error('STOP_PIPELINE'); // Use exception for control flow
+                    }
+                }
+                else {
+                    // Execute stages sequentially
+                    const stageIndexStart = executionContext.getStageOutputs().length;
+                    const options = { isParallel: false, worktreeInfo };
+                    const variableResolver = executionContext.getVariableResolver();
+                    await group.stages.reduce(async (prevStagePromise, stage, index) => {
+                        await prevStagePromise;
+                        // Check conditional before executing
+                        if (stage.conditional) {
+                            const conditionalValue = variableResolver.resolve(stage.conditional);
+                            const shouldExecute = evaluateConditional(conditionalValue);
+                            if (!shouldExecute) {
+                                const feedback = getProcessingFeedback();
+                                feedback.showInfo(`Skipping stage: ${stage.stage}.${stage.prompt} (conditional: ${stage.conditional} = ${conditionalValue})`);
+                                return; // Skip this stage
+                            }
+                        }
+                        const stageOptions = {
+                            ...options,
+                            preResolvedInputs: this.getPreResolvedInputsForStage(stage)
+                        };
+                        const result = await this.stageExecutor.executeStage(stage, context, stageIndexStart + index, stageOptions);
+                        // Record completed stage in execution context
+                        executionContext.recordStageCompletion(result);
+                        // Handle interactive questions if present and interactive mode is enabled
+                        // This prompts the user for answers before proceeding to the next stage
+                        await this.handleInteractiveQuestions(result, context, stage);
+                        if (result.metadata?.['stopPipeline']) {
+                            logger.info('Pipeline execution stopped by stage signal');
+                            throw new Error('STOP_PIPELINE'); // Use exception for control flow
+                        }
+                        if (!result.success && stage.required) {
+                            throw new ExecutionError(`Required stage failed: ${stage.stage}.${stage.prompt}`, {
+                                error: result.error,
+                                prompt: stage.prompt,
+                                stage: stage.stage
+                            });
+                        }
+                    }, Promise.resolve());
+                }
+            }, Promise.resolve());
+            const duration = Date.now() - startTime;
+            const stageOutputs = executionContext.getStageOutputs();
+            const allSuccessful = stageOutputs.every((s) => s.success);
+            // Pipeline succeeds if all required stages that were executed succeed
+            // When pipeline stops early (e.g., guided completion), only check executed stages
+            const requiredStagesSuccessful = stages
+                .filter((s) => s.required)
+                .filter((requiredStage) => {
+                // Only check stages that were actually executed
+                return stageOutputs.some((o) => o.stage === requiredStage.stage && o.prompt === requiredStage.prompt);
+            })
+                .every((requiredStage) => {
+                const output = stageOutputs.find((o) => o.stage === requiredStage.stage && o.prompt === requiredStage.prompt);
+                return output?.success ?? false;
+            });
+            logger.info(`Pipeline completed: ${executionContext.commandName}`, {
+                allSuccessful,
+                duration: `${duration}ms`,
+                requiredSuccessful: requiredStagesSuccessful,
+                stageCount: stageOutputs.length,
+                success: requiredStagesSuccessful
+            });
+            // Emit pipeline complete event
+            this.eventEmitter.emitPipelineComplete(executionContext.commandName, duration, requiredStagesSuccessful);
+            // Flush any pending file writes with user confirmation
+            if (this.stageExecutor.hasPendingWrites()) {
+                await this.stageExecutor.flushPendingWrites();
+            }
+            return {
+                duration_ms: duration,
+                outputs: this.mergeOutputs(stageOutputs),
+                stages: stageOutputs,
+                success: requiredStagesSuccessful
+            };
+        }
+        catch (error) {
+            // Check if this is a controlled stop (STOP_PIPELINE)
+            if (error.message === 'STOP_PIPELINE') {
+                const duration = Date.now() - startTime;
+                const stageOutputs = executionContext.getStageOutputs();
+                const allSuccessful = stageOutputs.every((s) => s.success);
+                const requiredStagesSuccessful = stages
+                    .filter((s) => s.required)
+                    .filter((requiredStage) => {
+                    return stageOutputs.some((o) => o.stage === requiredStage.stage && o.prompt === requiredStage.prompt);
+                })
+                    .every((requiredStage) => {
+                    const output = stageOutputs.find((o) => o.stage === requiredStage.stage && o.prompt === requiredStage.prompt);
+                    return output?.success ?? false;
+                });
+                logger.info(`Pipeline completed: ${executionContext.commandName}`, {
+                    allSuccessful,
+                    duration: `${duration}ms`,
+                    requiredSuccessful: requiredStagesSuccessful,
+                    stageCount: stageOutputs.length,
+                    success: requiredStagesSuccessful
+                });
+                this.eventEmitter.emitPipelineComplete(executionContext.commandName, duration, requiredStagesSuccessful);
+                // Flush any pending file writes with user confirmation
+                if (this.stageExecutor.hasPendingWrites()) {
+                    await this.stageExecutor.flushPendingWrites();
+                }
+                return {
+                    duration_ms: duration,
+                    outputs: this.mergeOutputs(stageOutputs),
+                    stages: stageOutputs,
+                    success: requiredStagesSuccessful
+                };
+            }
+            const duration = Date.now() - startTime;
+            const stageOutputs = executionContext.getStageOutputs();
+            const validStageOutputs = stageOutputs.filter((s) => s != null && typeof s === 'object');
+            logger.error('Pipeline execution failed', error, {
+                command: executionContext.commandName,
+                completedStages: validStageOutputs.filter((s) => s.success).length,
+                duration: `${duration}ms`,
+                totalStages: stages.length
+            });
+            // Emit pipeline error event
+            this.eventEmitter.emitPipelineError(executionContext.commandName, error.message);
+            return {
+                duration_ms: duration,
+                error: error.message,
+                outputs: this.mergeOutputs(validStageOutputs),
+                stages: validStageOutputs,
+                success: false
+            };
+        }
+    }
+    /**
+     * Validate pipeline stages
+     */
+    validatePipeline(stages) {
+        return this.pipelineValidator.validatePipeline(stages);
+    }
+    /**
+     * Merge outputs from all stages
+     */
+    mergeOutputs(stageOutputs) {
+        return stageOutputs
+            .filter((output) => output && output.success && output.outputs)
+            .reduce((merged, output) => ({ ...merged, ...output.outputs }), {});
+    }
+    /**
+     * Get pre-resolved inputs for a stage if available
+     * Returns undefined if no pre-resolved inputs exist
+     */
+    getPreResolvedInputsForStage(stage) {
+        if (!this.preResolvedInputs) {
+            return undefined;
+        }
+        const stageKey = `${stage.stage}_${stage.prompt}`;
+        return this.preResolvedInputs.stages.get(stageKey);
+    }
+    /**
+     * Handle interactive questions from a stage output
+     * If the stage produced clarifying questions and interactive mode is enabled,
+     * prompt the user for answers and store them for subsequent stages.
+     *
+     * @param result - The stage output to check for questions
+     * @param context - The pipeline execution context
+     * @param stage - The pipeline stage that was executed
+     * @returns true if questions were handled, false otherwise
+     */
+    async handleInteractiveQuestions(result, context, stage) {
+        const logger = getLogger();
+        const { executionContext } = context;
+        // Only handle questions if:
+        // 1. Interactive mode is enabled
+        // 2. Stage succeeded
+        // 3. Stage has outputs
+        if (!executionContext.interactive || !result.success || !result.outputs) {
+            return false;
+        }
+        // Check if this stage has clarifying questions
+        const questions = this.interactiveQuestionHandler.extractQuestions(result.outputs);
+        if (questions.length === 0) {
+            return false;
+        }
+        logger.info(`Stage ${stage.stage}.${stage.prompt} produced ${questions.length} clarifying question(s)`);
+        // Prompt user for answers
+        const questionResult = await this.interactiveQuestionHandler.promptForAnswers(questions);
+        if (questionResult.skipped) {
+            return false;
+        }
+        // Store answers in the execution context for subsequent stages
+        const formattedAnswers = this.interactiveQuestionHandler.formatAnswersForStage(questionResult.answers);
+        // Add user answers as a pseudo-stage output so it can be referenced
+        // by subsequent stages using $STAGE_user_answers.{questionId}
+        executionContext.getVariableResolver().addStageOutputs('user_answers', {
+            answers: formattedAnswers,
+            count: questionResult.answeredCount,
+            summary: questionResult.summary
+        });
+        // Also add to the current stage's outputs so it's available in the result
+        result.outputs['user_answers'] = formattedAnswers;
+        result.outputs['user_answers_summary'] = questionResult.summary;
+        logger.info(`User answered ${questionResult.answeredCount} clarifying question(s)`);
+        return true;
+    }
+}
+/**
+ * Evaluate a conditional value, handling string "true"/"false" from variable resolution
+ * The variable resolver converts boolean values to strings, so we need to handle that case
+ */
+function detectWorktreeInfo() {
+    try {
+        // Check if we're in a worktree (not the main working tree)
+        const gitDir = execSync('git rev-parse --git-dir', { encoding: 'utf-8' }).trim();
+        // If git-dir contains 'worktrees', we're in a linked worktree
+        if (!gitDir.includes('worktrees')) {
+            return undefined;
+        }
+        // Get worktree details
+        const worktreePath = execSync('git rev-parse --show-toplevel', { encoding: 'utf-8' }).trim();
+        const branch = execSync('git rev-parse --abbrev-ref HEAD', { encoding: 'utf-8' }).trim();
+        const commit = execSync('git rev-parse HEAD', { encoding: 'utf-8' }).trim();
+        return {
+            branch,
+            commit,
+            path: worktreePath
+        };
+    }
+    catch {
+        return undefined;
+    }
+}
+function evaluateConditional(value) {
+    if (typeof value === 'string') {
+        // Handle string "true"/"false" from variable resolution
+        return value.toLowerCase() === 'true';
+    }
+    return Boolean(value);
+}
+//# sourceMappingURL=pipeline.js.map

package/dist/executor/pipeline.js.map

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

package/dist/executor/project-guidance-loader.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Project Guidance Loader - Loads high-level guidance files for AI agents
+ *
+ * This module searches for and loads high-level guidance files commonly used
+ * in AI-assisted coding projects (AGENTS.md, CLAUDE.md, etc.) to ensure
+ * all AI commands follow project-specific guidelines.
+ *
+ * IMPORTANT: This module distinguishes between:
+ * - GUIDANCE FILES (AGENTS.md, CLAUDE.md, etc.) - Always loaded, instruct AI behaviour
+ * - PROJECT KNOWLEDGE (knowledge-base/*) - Selectively loaded per command to save tokens
+ */
+/**
+ * Get the project root directory
+ */
+export declare function getProjectRoot(): string;
+/**
+ * Search for and load all guidance files in the project root
+ * Returns combined content of all found guidance files
+ *
+ * NOTE: This only loads GUIDANCE files (AGENTS.md, CLAUDE.md, etc.)
+ * Project knowledge from knowledge-base/ is loaded separately via loadProjectKnowledge()
+ */
+export declare function loadProjectGuidance(): Promise<null | string>;
+/**
+ * Clear the guidance cache (useful for testing or when files change)
+ */
+export declare function clearGuidanceCache(): void;
+/**
+ * Load project knowledge files selectively based on command requirements
+ *
+ * @param knowledgeFiles - Array of filenames to load from knowledge-base/ directory
+ *                         Examples: ['FUNCTIONAL.md', 'PRD.md', 'PLAN-*.md']
+ *                         Supports glob patterns for dynamic file matching
+ * @returns Combined content of requested knowledge files, or null if none found
+ *
+ * Usage:
+ * - create-prd command: loadProjectKnowledge(['FUNCTIONAL.md'])
+ * - create-backlog command: loadProjectKnowledge(['PRD.md'])
+ * - implement command: loadProjectKnowledge(['PLAN-*.md']) // loads latest plan
+ * - review-functional command: loadProjectKnowledge(['PRD.md', 'FUNCTIONAL.md'])
+ */
+export declare function loadProjectKnowledge(knowledgeFiles: string[]): Promise<null | string>;
+/**
+ * Clear only the knowledge cache (useful when knowledge files change)
+ */
+export declare function clearKnowledgeCache(): void;
+/**
+ * Check if any guidance files exist in the project
+ */
+export declare function hasProjectGuidance(): boolean;
+/**
+ * Get the list of guidance file patterns being searched for
+ */
+export declare function getGuidanceFilePatterns(): readonly string[];
+/**
+ * Load available agent definitions for pre-injection into the LLM context
+ *
+ * This pre-loads agent files so the LLM doesn't need to use read_file tool
+ * to access agent definitions. Agent files are loaded from data/agents/ directory.
+ *
+ * @param agentRoles - Array of agent role names to load (e.g., ['product-manager', 'lead'])
+ * @returns Combined content of requested agent files, or null if none found
+ */
+export declare function loadAvailableAgents(agentRoles: string[]): Promise<null | string>;
+/**
+ * Clear only the agent content cache (useful when agent files change)
+ */
+export declare function clearAgentContentCache(): void;
+//# sourceMappingURL=project-guidance-loader.d.ts.map

package/dist/executor/project-guidance-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-guidance-loader.d.ts","sourceRoot":"","sources":["../../src/executor/project-guidance-loader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAyCH;;GAEG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAGvC;AAwDD;;;;;;GAMG;AACH,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,IAAI,GAAG,MAAM,CAAC,CAuDlE;AAsCD;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,IAAI,CAIzC;AA2CD;;;;;;;;;;;;;GAaG;AACH,wBAAsB,oBAAoB,CAAC,cAAc,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,GAAG,MAAM,CAAC,CAwC3F;AA2KD;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,IAAI,CAE1C;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,OAAO,CAW5C;AAED;;GAEG;AACH,wBAAgB,uBAAuB,IAAI,SAAS,MAAM,EAAE,CAE3D;AAED;;;;;;;;GAQG;AACH,wBAAsB,mBAAmB,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,GAAG,MAAM,CAAC,CAkCtF;AAoHD;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,IAAI,CAE7C"}