@windagency/valora 2.0.1

package/dist/executor/variables.js

@@ -0,0 +1,306 @@
+/**
+ * Variable resolver - resolves $ARG_*, $STAGE_*, $CONTEXT_* placeholders
+ */
+import { ValidationError } from '../utils/error-handler.js';
+export class VariableResolver {
+    context;
+    strict;
+    constructor(context, strict = true) {
+        this.context = context;
+        this.strict = strict;
+    }
+    /**
+     * Resolve all variables in a value (string, object, or array)
+     */
+    resolve(value) {
+        if (typeof value === 'string') {
+            return this.resolveString(value);
+        }
+        if (Array.isArray(value)) {
+            return value.map((item) => this.resolve(item));
+        }
+        if (typeof value === 'object' && value !== null) {
+            return this.resolveObject(value);
+        }
+        return value;
+    }
+    /**
+     * Resolve variables in a string
+     */
+    resolveString(str) {
+        // Match $SCOPE_path or $SCOPE_path.nested.property
+        // Note: supports hyphens in argument names for CLI flags like --concept-file
+        const variablePattern = /\$([A-Z]+)_([a-zA-Z0-9_-]+(?:\.[a-zA-Z0-9_-]+)*)/g;
+        return str.replace(variablePattern, (match, scope, path) => {
+            try {
+                const value = this.resolveVariable(scope, path);
+                return this.valueToString(value);
+            }
+            catch (error) {
+                if (this.strict) {
+                    throw error;
+                }
+                // In non-strict mode, leave unresolved variables as-is
+                return match;
+            }
+        });
+    }
+    /**
+     * Resolve variables in an object
+     */
+    resolveObject(obj) {
+        return Object.entries(obj).reduce((acc, [key, value]) => {
+            acc[key] = this.resolve(value);
+            return acc;
+        }, {});
+    }
+    /**
+     * Resolve a single variable
+     */
+    resolveVariable(scope, path) {
+        // Map scope to resolver method
+        const scopeResolverMap = new Map([
+            ['ARG', () => this.resolveArg(path)],
+            ['CONTEXT', () => this.resolveContext(path)],
+            ['ENV', () => this.resolveEnv(path)],
+            ['STAGE', () => this.resolveStage(path)]
+        ]);
+        const resolver = scopeResolverMap.get(scope);
+        if (!resolver) {
+            throw new ValidationError(`Unknown variable scope: ${scope}`, {
+                path,
+                scope
+            });
+        }
+        return resolver();
+    }
+    /**
+     * Resolve argument variable ($ARG_name)
+     */
+    resolveArg(path) {
+        // Handle positional args like $ARG_1, $ARG_2
+        if (/^\d+$/.test(path)) {
+            const index = parseInt(path, 10);
+            const value = this.context.args[index.toString()];
+            if (value === undefined) {
+                // Return 'Not specified' for optional positional arguments
+                // consistent with named argument handling in resolvePath
+                return 'Not specified';
+            }
+            return value;
+        }
+        // Handle named args
+        const value = this.resolvePath(this.context.args, path, `$ARG_${path}`);
+        return value;
+    }
+    /**
+     * Resolve nested path in an object
+     */
+    resolvePath(obj, path, fullVariable) {
+        const parts = path.split('.');
+        return parts.reduce((current, part) => {
+            if (typeof current !== 'object' || current === null) {
+                throw new ValidationError(`Cannot access property ${part} on non-object`, {
+                    path,
+                    variable: fullVariable
+                });
+            }
+            // Safe access to the property
+            const next = current[part];
+            if (next === undefined) {
+                // Special handling for optional arguments and context variables
+                if (fullVariable.startsWith('$ARG_') || fullVariable.startsWith('$CONTEXT_')) {
+                    return 'Not specified';
+                }
+                // Enhanced error message for stage outputs with recovery suggestions
+                const availableKeys = typeof current === 'object' && current !== null ? Object.keys(current) : [];
+                // For stage outputs, provide more context about potential LLM parsing issues
+                if (fullVariable.startsWith('$STAGE_')) {
+                    throw new ValidationError(`Stage output property not found: ${part}. This may indicate the LLM response was incomplete or malformed. ` +
+                        `Available properties: ${availableKeys.length > 0 ? availableKeys.join(', ') : 'none'}`, {
+                        availableKeys,
+                        path,
+                        suggestion: 'The LLM may not have provided all required outputs. Consider re-running the command or adjusting the prompt.',
+                        variable: fullVariable
+                    });
+                }
+                throw new ValidationError(`Property not found: ${part}`, {
+                    availableKeys,
+                    path,
+                    variable: fullVariable
+                });
+            }
+            return next;
+        }, obj);
+    }
+    /**
+     * Resolve stage variable ($STAGE_stageName.outputName)
+     * Returns null for missing stages (e.g., skipped due to conditional)
+     */
+    resolveStage(path) {
+        const [stageName, ...rest] = path.split('.');
+        if (!stageName) {
+            throw new ValidationError('Stage name is required', {
+                variable: `$STAGE_${path}`
+            });
+        }
+        const stageOutputs = this.context.stages[stageName];
+        if (!stageOutputs) {
+            // Return null for missing stages (e.g., skipped due to conditional)
+            // This allows downstream stages to handle skipped stages gracefully
+            return null;
+        }
+        if (rest.length === 0) {
+            return stageOutputs;
+        }
+        return this.resolvePath(stageOutputs, rest.join('.'), `$STAGE_${path}`);
+    }
+    /**
+     * Resolve context variable ($CONTEXT_key)
+     */
+    resolveContext(path) {
+        return this.resolvePath(this.context.context, path, `$CONTEXT_${path}`);
+    }
+    /**
+     * Resolve environment variable ($ENV_NAME)
+     */
+    resolveEnv(path) {
+        const envVars = this.context.env ?? process.env;
+        const value = envVars[path];
+        if (value === undefined) {
+            throw new ValidationError(`Environment variable not found: ${path}`, {
+                variable: `$ENV_${path}`
+            });
+        }
+        return value;
+    }
+    /**
+     * Convert value to string for replacement
+     */
+    valueToString(value) {
+        if (value === null || value === undefined) {
+            return '';
+        }
+        if (typeof value === 'string') {
+            return value;
+        }
+        if (typeof value === 'number' || typeof value === 'boolean') {
+            return value.toString();
+        }
+        if (typeof value === 'object') {
+            return JSON.stringify(value);
+        }
+        return String(value);
+    }
+    /**
+     * Update context with new values
+     */
+    updateContext(updates) {
+        if (updates.args) {
+            this.context.args = { ...this.context.args, ...updates.args };
+        }
+        if (updates.stages) {
+            this.context.stages = { ...this.context.stages, ...updates.stages };
+        }
+        if (updates.context) {
+            this.context.context = { ...this.context.context, ...updates.context };
+        }
+        if (updates.env) {
+            this.context.env = { ...this.context.env, ...updates.env };
+        }
+    }
+    /**
+     * Add stage outputs to context
+     */
+    addStageOutputs(stageName, outputs) {
+        this.context.stages[stageName] = outputs;
+    }
+    /**
+     * Get current context
+     */
+    getContext() {
+        return this.context;
+    }
+    /**
+     * Extract variable references from a string
+     */
+    static extractVariables(str) {
+        const variablePattern = /\$([A-Z]+)_([a-zA-Z0-9_-]+(?:\.[a-zA-Z0-9_-]+)*)/g;
+        const variables = [];
+        let match;
+        while ((match = variablePattern.exec(str)) !== null) {
+            const fullMatch = match[0];
+            const scopeMatch = match[1];
+            const pathMatch = match[2];
+            if (fullMatch && scopeMatch && pathMatch) {
+                variables.push({
+                    full: fullMatch,
+                    path: pathMatch,
+                    scope: scopeMatch
+                });
+            }
+        }
+        return variables;
+    }
+    /**
+     * Check if a string contains any variables
+     */
+    static hasVariables(str) {
+        return /\$[A-Z]+_[a-zA-Z0-9_-]+/.test(str);
+    }
+    /**
+     * Validate that all required variables can be resolved
+     */
+    validateVariables(value) {
+        const errors = [];
+        const validate = (val, path = '') => {
+            if (typeof val === 'string') {
+                const variables = VariableResolver.extractVariables(val);
+                const variableErrors = variables
+                    .map((variable) => {
+                    try {
+                        this.resolveVariable(variable.scope, variable.path);
+                        return null;
+                    }
+                    catch (error) {
+                        return `${path ? path + ': ' : ''}${error.message}`;
+                    }
+                })
+                    .filter((error) => error !== null);
+                errors.push(...variableErrors);
+            }
+            else if (Array.isArray(val)) {
+                val.forEach((item, idx) => validate(item, `${path}[${idx}]`));
+            }
+            else if (typeof val === 'object' && val !== null) {
+                Object.entries(val).forEach(([key, value]) => {
+                    validate(value, path ? `${path}.${key}` : key);
+                });
+            }
+        };
+        validate(value);
+        return errors;
+    }
+}
+/**
+ * Helper function to create a variable resolver with common context
+ */
+export function createVariableResolver(args, flags, stageOutputs = {}, sessionContext = {}, strict = true) {
+    // Convert positional args to indexed object
+    const argsObj = args.reduce((acc, arg, idx) => {
+        acc[(idx + 1).toString()] = arg;
+        return acc;
+    }, {});
+    // Merge flags into args
+    const mergedArgs = Object.entries(flags).reduce((acc, [key, value]) => {
+        acc[key] = value;
+        return acc;
+    }, argsObj);
+    const context = {
+        args: mergedArgs,
+        context: sessionContext,
+        stages: stageOutputs
+    };
+    return new VariableResolver(context, strict);
+}
+//# sourceMappingURL=variables.js.map

package/dist/executor/variables.js.map

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

package/dist/exploration/collaboration-coordinator.d.ts

@@ -0,0 +1,130 @@
+/**
+ * Collaboration Coordinator - Manage shared insights and collaborative decisions
+ *
+ * Enables active collaboration between agents in different worktrees
+ */
+import type { Decision, Insight } from '../types/exploration.types.js';
+export interface ProposeDecisionOptions {
+    options: Array<{
+        cons?: string[];
+        description: string;
+        label: string;
+        pros?: string[];
+    }>;
+    rationale?: string;
+    topic: string;
+    worktree_id: string;
+}
+export interface PublishInsightOptions {
+    content: string;
+    metadata?: Record<string, unknown>;
+    tags?: string[];
+    title: string;
+    type: Insight['type'];
+    worktree_id: string;
+}
+export interface VoteOnDecisionOptions {
+    decision_id: string;
+    option_index: number;
+    worktree_id: string;
+}
+export declare class CollaborationCoordinator {
+    private decisionsPoolPath;
+    private explorationId;
+    private insightsPoolPath;
+    private lockManager;
+    constructor(insightsPoolPath: string, decisionsPoolPath: string, explorationId: string);
+    /**
+     * Publish an insight to the shared pool
+     */
+    publishInsight(options: PublishInsightOptions): Promise<Insight>;
+    /**
+     * Get all insights from the pool
+     */
+    getAllInsights(): Promise<Insight[]>;
+    /**
+     * Get insights by type
+     */
+    getInsightsByType(type: Insight['type']): Promise<Insight[]>;
+    /**
+     * Get insights by tags
+     */
+    getInsightsByTags(tags: string[]): Promise<Insight[]>;
+    /**
+     * Get insights from other worktrees (exclude own insights)
+     */
+    getInsightsFromOthers(worktreeId: string): Promise<Insight[]>;
+    /**
+     * Get recent insights (last N)
+     */
+    getRecentInsights(count?: number): Promise<Insight[]>;
+    /**
+     * Search insights by keyword
+     */
+    searchInsights(keyword: string): Promise<Insight[]>;
+    /**
+     * Propose a decision for collaborative voting
+     */
+    proposeDecision(options: ProposeDecisionOptions): Promise<Decision>;
+    /**
+     * Vote on a decision
+     */
+    voteOnDecision(options: VoteOnDecisionOptions): Promise<Decision | null>;
+    /**
+     * Get all decisions
+     */
+    getAllDecisions(): Promise<Decision[]>;
+    /**
+     * Get pending decisions (not yet resolved)
+     */
+    getPendingDecisions(): Promise<Decision[]>;
+    /**
+     * Get resolved decisions
+     */
+    getResolvedDecisions(): Promise<Decision[]>;
+    /**
+     * Get decision by ID
+     */
+    getDecision(decisionId: string): Promise<Decision | null>;
+    /**
+     * Get collaboration statistics
+     */
+    getStats(): Promise<{
+        insights_by_type: Record<string, number>;
+        insights_by_worktree: Record<string, number>;
+        participation_rate: number;
+        pending_decisions: number;
+        resolved_decisions: number;
+        total_decisions: number;
+        total_insights: number;
+    }>;
+    /**
+     * Clear all insights (for testing or cleanup)
+     */
+    clearInsights(): Promise<void>;
+    /**
+     * Clear all decisions (for testing or cleanup)
+     */
+    clearDecisions(): Promise<void>;
+    /**
+     * Export insights to JSON
+     */
+    exportInsights(): Promise<string>;
+    /**
+     * Export decisions to JSON
+     */
+    exportDecisions(): Promise<string>;
+    /**
+     * Get insights summary (for display)
+     */
+    getInsightsSummary(): Promise<string>;
+    /**
+     * Get decisions summary (for display)
+     */
+    getDecisionsSummary(): Promise<string>;
+    /**
+     * Count votes for a decision
+     */
+    private countVotes;
+}
+//# sourceMappingURL=collaboration-coordinator.d.ts.map

package/dist/exploration/collaboration-coordinator.d.ts.map

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