edsger 0.43.0 → 0.45.0

package/dist/services/lifecycle-agent/types.d.ts

@@ -1,190 +0,0 @@
-/**
- * Lifecycle Agent Types
- *
- * Type definitions for the AI-powered lifecycle agent that manages
- * product feature lifecycle decisions: when to advance to the next phase,
- * when to re-run the current phase, and when to escalate to a human.
- *
- * The lifecycle agent evaluates phase outputs against quality criteria
- * and makes transition decisions, reducing reliance on manual human
- * intervention while preserving the ability to escalate when needed.
- */
-import type { FeatureStatus } from '../../types/index.js';
-import type { ExecutionMode } from '../../types/pipeline.js';
-/**
- * Decision the lifecycle agent can make after evaluating a phase
- *
- * - advance: Phase output meets quality criteria, proceed to next phase
- * - rerun: Phase output needs improvement, re-run with generated feedback
- * - escalate: Agent is uncertain or output requires human judgment
- */
-export type LifecycleDecision = 'advance' | 'rerun' | 'escalate';
-/**
- * Result of evaluating a single quality criterion
- */
-export interface CriterionEvaluation {
-    /** Criterion identifier matching a CriterionDefinition.id */
-    readonly criterionId: string;
-    /** Score from 0-100 for this criterion */
-    readonly score: number;
-    /** Whether the criterion meets its minimum threshold */
-    readonly passed: boolean;
-    /** Explanation of the evaluation result */
-    readonly reasoning: string;
-    /** Specific issues found, if any */
-    readonly issues?: readonly string[];
-}
-/**
- * Complete evaluation result for a phase execution
- * This is the primary output of the lifecycle agent's evaluation step
- */
-export interface PhaseEvaluationResult {
-    /** The phase that was evaluated */
-    readonly phase: string;
-    /** Feature being evaluated */
-    readonly featureId: string;
-    /** Overall quality score (weighted average of criteria scores, 0-100) */
-    readonly qualityScore: number;
-    /** Decision: advance, rerun, or escalate */
-    readonly decision: LifecycleDecision;
-    /** Agent's confidence in its decision (0-100) */
-    readonly confidence: number;
-    /** Individual criterion evaluations */
-    readonly criteria: readonly CriterionEvaluation[];
-    /** Summary reasoning for the decision */
-    readonly reasoning: string;
-    /** If decision is 'rerun', suggested feedbacks to inject */
-    readonly suggestedFeedbacks?: readonly SuggestedFeedback[];
-    /** How many times this phase has been re-run in the current cycle */
-    readonly rerunCount: number;
-    /** Timestamp of the evaluation */
-    readonly evaluatedAt: string;
-}
-/**
- * Feedback suggested by the lifecycle agent when deciding to re-run a phase
- * These mirror the existing Feedback structure so they can be injected
- * into the feedback system seamlessly
- */
-export interface SuggestedFeedback {
-    /** Type of feedback, matching existing FeedbackType */
-    readonly feedbackType: 'requirement' | 'constraint' | 'preference' | 'context' | 'quality_criteria' | 'issue' | 'suggestion';
-    /** Short title describing the feedback */
-    readonly title: string;
-    /** Detailed content of the feedback */
-    readonly content: string;
-    /** Priority from 1-10 (higher = more important) */
-    readonly priority: number;
-    /** Which phase this feedback targets */
-    readonly phase: string;
-}
-/**
- * Definition of a quality criterion for phase evaluation
- * Each phase has its own set of criteria that the agent uses to evaluate outputs
- */
-export interface CriterionDefinition {
-    /** Unique identifier for this criterion */
-    readonly id: string;
-    /** Human-readable name */
-    readonly name: string;
-    /** Description of what this criterion measures */
-    readonly description: string;
-    /** Relative importance weight (0-1, all weights for a phase should sum to ~1) */
-    readonly weight: number;
-    /** Minimum score (0-100) needed to pass this criterion */
-    readonly minimumScore: number;
-    /** Prompt instructions for how the AI should evaluate this criterion */
-    readonly evaluationGuidance: string;
-}
-/**
- * Quality criteria configuration for a specific phase
- * Defines the thresholds and criteria used to evaluate that phase's outputs
- */
-export interface PhaseQualityCriteria {
-    /** Phase name (underscore format, e.g., 'user_stories_analysis') */
-    readonly phase: string;
-    /** Minimum overall quality score needed to auto-advance (0-100) */
-    readonly advanceThreshold: number;
-    /** Overall score below which the agent should escalate to human (0-100) */
-    readonly escalateThreshold: number;
-    /** Maximum number of automatic re-runs before escalating */
-    readonly maxAutoRetries: number;
-    /** Individual quality criteria for this phase */
-    readonly criteria: readonly CriterionDefinition[];
-}
-/**
- * A transition rule that maps phase evaluation outcomes to actions
- */
-export interface TransitionRule {
-    /** Phase this rule applies to (underscore format) */
-    readonly fromPhase: string;
-    /** Target phase if advancing */
-    readonly toPhase: string;
-    /** Execution mode to use when advancing to the target phase */
-    readonly executionMode: ExecutionMode;
-    /** Feature status to set when advancing */
-    readonly targetStatus: FeatureStatus;
-}
-/**
- * Configuration for the lifecycle agent
- * Controls behavior and thresholds for automated lifecycle management
- */
-export interface LifecycleAgentConfig {
-    /** Whether the lifecycle agent is enabled for this product */
-    readonly enabled: boolean;
-    /** Allow agent to auto-advance phases without human approval */
-    readonly autoAdvanceEnabled: boolean;
-    /** Allow agent to auto-rerun phases with generated feedback */
-    readonly autoRerunEnabled: boolean;
-    /** Global maximum auto-retries (overrides per-phase if lower) */
-    readonly maxAutoRetries: number;
-    /** When confidence is below this threshold, always escalate (0-100) */
-    readonly confidenceThreshold: number;
-    /** Per-phase quality criteria overrides (falls back to defaults if not set) */
-    readonly phaseOverrides?: Partial<Record<string, Partial<PhaseQualityCriteria>>>;
-}
-/**
- * Runtime state for the lifecycle agent managing a specific feature
- * Tracks re-run counts and evaluation history
- */
-export interface LifecycleAgentState {
-    /** Feature being managed */
-    readonly featureId: string;
-    /** Number of re-runs per phase in current cycle */
-    readonly rerunCounts: Readonly<Record<string, number>>;
-    /** History of evaluation results */
-    readonly evaluationHistory: readonly PhaseEvaluationResult[];
-}
-/**
- * Input to the lifecycle agent's evaluate function
- * Contains all context needed to evaluate a phase's output
- */
-export interface PhaseEvaluationInput {
-    /** Feature ID */
-    readonly featureId: string;
-    /** Phase that was just executed */
-    readonly phase: string;
-    /** Current feature status */
-    readonly currentStatus: FeatureStatus;
-    /** The phase execution result data (varies by phase) */
-    readonly phaseOutput: unknown;
-    /** Quality criteria to evaluate against */
-    readonly qualityCriteria: PhaseQualityCriteria;
-    /** Current re-run count for this phase */
-    readonly rerunCount: number;
-    /** Agent configuration */
-    readonly config: LifecycleAgentConfig;
-}
-/**
- * Output from the lifecycle agent's decide function
- * Contains the decision and all information needed to execute it
- */
-export interface LifecycleDecisionResult {
-    /** The evaluation that led to this decision */
-    readonly evaluation: PhaseEvaluationResult;
-    /** The transition to execute if advancing */
-    readonly transition?: TransitionRule;
-    /** Execution mode to use (for both advance and rerun scenarios) */
-    readonly executionMode?: ExecutionMode;
-    /** Feature status to set */
-    readonly targetStatus?: FeatureStatus;
-}

package/dist/services/lifecycle-agent/types.js

@@ -1,12 +0,0 @@
-/**
- * Lifecycle Agent Types
- *
- * Type definitions for the AI-powered lifecycle agent that manages
- * product feature lifecycle decisions: when to advance to the next phase,
- * when to re-run the current phase, and when to escalate to a human.
- *
- * The lifecycle agent evaluates phase outputs against quality criteria
- * and makes transition decisions, reducing reliance on manual human
- * intervention while preserving the ability to escalate when needed.
- */
-export {};