soloforge 1.0.0

package/dist/types.d.ts

@@ -0,0 +1,724 @@
+export type Risk = "low" | "medium" | "high";
+export type Complexity = "low" | "medium" | "high";
+export type Ambiguity = "low" | "medium" | "high";
+export type TaskType = "feature" | "bugfix" | "refactor" | "hotfix" | "review" | "explain" | "optimize" | "document" | "test" | "scaffold" | "debug" | "passthrough";
+export type FailureType = "deterministic" | "fixable" | "scope_insufficient";
+export type ExecutionTier = "auto_execute" | "recommended_auto" | "must_confirm" | "forbidden_auto";
+export interface ExecutionContract {
+    goal: string;
+    scope: string[];
+    constraints: string[];
+    verification: string[];
+    stop_conditions: string[];
+}
+export type EvidenceLevel = "E0" | "E1" | "E2" | "E3";
+export interface EvidenceItem {
+    id: string;
+    level: EvidenceLevel;
+    description: string;
+    source: "command" | "file" | "runtime" | "static_analysis";
+    command?: string;
+    passed: boolean;
+    timestamp?: string;
+}
+export interface CoverageMatrix {
+    api_coverage: {
+        total: number;
+        tested: number;
+        gaps: string[];
+    };
+    page_coverage: {
+        total: number;
+        tested: number;
+        gaps: string[];
+    };
+    flow_coverage: {
+        total: number;
+        tested: number;
+        gaps: string[];
+    };
+}
+export interface RepairLoopState {
+    attempt: number;
+    max_attempts: number;
+    phase_origin: string;
+    auto_repairable: boolean;
+    escalation_reason?: string;
+    recurrence_count: number;
+}
+export interface UncertaintyTrigger {
+    trigger_type: string;
+    description: string;
+    options: Array<{
+        label: string;
+        tradeoff: string;
+    }>;
+    recommendation: string;
+}
+export type ReviewRole = "self_review" | "peer_review" | "gate_review";
+export interface DisputeItem {
+    finding_id: string;
+    implementer_position: string;
+    reviewer_position: string;
+    resolution?: string;
+}
+export type PhaseDirective = "continue_current" | "advance_next" | "repair_reverify" | "rework_upstream" | "stop_escalate" | "completed";
+export interface ReworkHistory {
+    from_phase: string;
+    to_phase: string;
+    reason: string;
+    timestamp: string;
+}
+export interface ProjectConfig {
+    name: string;
+    tech_stack: {
+        backend: {
+            lang: string;
+            framework: string;
+            version: string;
+        };
+        frontend: {
+            lang: string;
+            framework: string;
+            version: string;
+        };
+    };
+    product_profile: string;
+    repos: RepoConfig[];
+    build_commands: {
+        backend: BuildCommands;
+        frontend: BuildCommands;
+    };
+    scope: {
+        backend: string[];
+        frontend: string[];
+    };
+    conventions_file?: string;
+    verify_timeout?: {
+        build: number;
+        test: number;
+    };
+    product_mapping?: Record<string, string>;
+    scaffold?: {
+        base_package?: string;
+        templates?: string;
+        custom_templates_dir?: string;
+    };
+    /** @internal resolved at runtime, not from config file */
+    _projectPath?: string;
+}
+export interface BuildCommands {
+    build: string;
+    test: string;
+    full: string;
+}
+export interface RepoConfig {
+    name: string;
+    path: string;
+    lang: string;
+    framework: string;
+    scope: string[];
+}
+export interface TaskContext {
+    task_id: string;
+    created_at: string;
+    intent: string;
+    product_profile: string;
+    status: "classifying" | "expanding" | "executing" | "verifying" | "retrying" | "learning" | "reworking" | "done" | "failed";
+    classification?: ClassifyResult;
+    expansion?: ExpandResult;
+    execution?: {
+        changed_files: string[];
+        attempt_count: number;
+        max_attempts: number;
+        failure_history: FailureRecord[];
+        repair_loop?: RepairLoopState;
+    };
+    verification?: VerifyResult;
+    planning?: PlanResult;
+    code_review?: CodeReviewResult;
+    delivery?: DeliveryResult;
+    phase_directive?: PhaseDirective;
+    rework_history?: ReworkHistory[];
+}
+export interface FailureRecord {
+    attempt: number;
+    type: FailureType;
+    message: string;
+    timestamp: string;
+    phase?: string;
+}
+export interface ClassifyResult {
+    task_type: TaskType;
+    risk: Risk;
+    complexity: Complexity;
+    ambiguity: Ambiguity;
+    affected_repos: string[];
+    mode: "autonomous" | "supervised" | "passthrough";
+    strategy: "full_pipeline" | "quick_fix" | "skip_soloForge";
+    clarification?: {
+        summary: string;
+        questions?: string[];
+    };
+    execution_tier?: ExecutionTier;
+    uncertainty_triggers?: UncertaintyTrigger[];
+}
+export interface ExpandResult {
+    task_id: string;
+    prompt: string;
+    scope: ScopeResult;
+    acceptance: {
+        automated: AcceptanceItem[];
+        manual: AcceptanceItem[];
+    };
+    matched_patterns: string[];
+    matched_knowledge: string[];
+    is_legacy_code: boolean;
+    legacy_conventions?: string[];
+    degraded: boolean;
+    contract?: ExecutionContract;
+    uncertainty_triggers?: UncertaintyTrigger[];
+}
+export interface ScopeResult {
+    allowed_paths: string[];
+    readonly_paths: string[];
+    new_files_allowed: boolean;
+    new_file_patterns?: string[];
+}
+export interface AcceptanceItem {
+    id: string;
+    description: string;
+    type: "automated" | "manual";
+    check_command?: string;
+}
+export interface ScopeCheckResult {
+    allowed: boolean;
+    reason?: string;
+    has_secrets: boolean;
+    secret_details?: Array<{
+        file: string;
+        line: number;
+        type: string;
+    }>;
+    severity: "ok" | "warning" | "blocked";
+}
+export interface VerifyResult {
+    task_id: string;
+    checks: {
+        build: VerifyCommand[];
+        tests: VerifyCommand[];
+        acceptance?: AcceptanceCheckResult[];
+    };
+    summary: string;
+    manual_items: string[];
+    evidence?: EvidenceItem[];
+    coverage?: CoverageMatrix;
+}
+export interface VerifyCommand {
+    command: string;
+    cwd: string;
+    timeout_hint: number;
+    description: string;
+}
+export interface AcceptanceCheckResult {
+    id: string;
+    description: string;
+    check_command: string;
+    cwd: string;
+}
+export interface LearnResult {
+    task_id: string;
+    learned: boolean;
+    new_knowledge?: {
+        type: "pattern" | "procedure" | "rule_upgrade" | "prompt_optimization" | "acceptance_supplement";
+        content: string;
+        scope: string[];
+        products: string[];
+    };
+    confidence: number;
+    status: "accepted" | "staged" | "skipped";
+    staged_path?: string;
+    retry_hint?: string;
+}
+export interface FailureClassifyResult {
+    failure_type: FailureType;
+    is_same_error: boolean;
+    retry_remaining: number;
+    action: "retry" | "expand_scope" | "escalate";
+    phase_origin?: string;
+    auto_repairable?: boolean;
+    escalation_reason?: string;
+    recurrence_count?: number;
+}
+export interface KnowledgeEntry {
+    id: string;
+    file_path: string;
+    name: string;
+    type: "pattern" | "procedure" | "domain" | "acceptance_template" | "review_rule" | "pipeline_procedure";
+    when: string;
+    body?: string;
+    scope: string[];
+    products: string[];
+    tech_stack?: string;
+    last_used_at?: string;
+    created_at: string;
+    updated_at: string;
+    usage_count: number;
+    confidence: number;
+    status: "active" | "staged" | "deprecated" | "pending_review";
+}
+export interface KnowledgeIndex {
+    version: number;
+    built_at: string;
+    global_entries: KnowledgeEntry[];
+    project_entries: KnowledgeEntry[];
+}
+export interface SubTask {
+    id: string;
+    title: string;
+    description: string;
+    intent: string;
+    depends_on: string[];
+    affected_repos: string[];
+    estimated_complexity: Complexity;
+    output_template?: string;
+    output_path?: string;
+    suggested_tools?: string[];
+}
+export interface PlanResult {
+    task_id: string;
+    original_intent: string;
+    sub_tasks: SubTask[];
+    execution_order: string[];
+    parallel_groups: string[][];
+    summary: string;
+    skipped_reason?: string;
+    current_step_index: number;
+}
+export interface ImpactFile {
+    path: string;
+    reason: string;
+    confidence: "high" | "medium" | "low";
+}
+export interface ImpactAnalysisResult {
+    task_id: string;
+    intent: string;
+    affected_files: ImpactFile[];
+    declared_scope: string[];
+    out_of_scope_files: ImpactFile[];
+    scope_sufficient: boolean;
+    recommendation: "proceed" | "expand_scope" | "confirm";
+    summary: string;
+    expand_suggestion?: string[];
+}
+export type ReviewDimension = "quality" | "security" | "performance" | "debt" | "architecture";
+export type ReviewSeverity = "info" | "warning" | "critical";
+export interface ReviewFinding {
+    id: string;
+    file: string;
+    line?: number;
+    dimension: ReviewDimension;
+    severity: ReviewSeverity;
+    title: string;
+    description: string;
+    suggestion?: string;
+    is_debt: boolean;
+}
+export interface CodeReviewResult {
+    task_id: string;
+    findings: ReviewFinding[];
+    summary: {
+        total: number;
+        by_dimension: Record<ReviewDimension, number>;
+        by_severity: Record<ReviewSeverity, number>;
+        debt_items: number;
+    };
+    overall_assessment: string;
+    skip_reason?: string;
+    review_role?: ReviewRole;
+    confidence_adjustment?: number;
+    disputes?: DisputeItem[];
+    uncertainty_violations?: string[];
+    risk_adjusted?: boolean;
+}
+export interface DebtItem {
+    id: string;
+    task_id: string;
+    file: string;
+    line?: number;
+    title: string;
+    description: string;
+    severity: ReviewSeverity;
+    discovered_at: string;
+    status: "open" | "acknowledged" | "resolved";
+    resolved_at?: string;
+    category?: "complexity" | "duplication" | "missing_test" | "outdated_dep" | "security" | "performance" | "other";
+    effort_estimate?: "small" | "medium" | "large";
+    impact?: "low" | "medium" | "high";
+}
+export interface ScaffoldFile {
+    path: string;
+    content: string;
+    description: string;
+    is_template: boolean;
+    template_vars?: Record<string, string>;
+}
+export interface ScaffoldResult {
+    task_id: string;
+    module_name: string;
+    files: ScaffoldFile[];
+    summary: string;
+    total_files: number;
+    warnings: string[];
+}
+export type DeliveryAction = "commit" | "push" | "pr" | "changelog";
+export interface DeliveryConfig {
+    auto_commit: boolean;
+    auto_push: boolean;
+    auto_pr: boolean;
+    pr_labels: string[];
+    require_approval: boolean;
+}
+export interface DeliveryResult {
+    task_id: string;
+    actions_performed: DeliveryAction[];
+    commit_hash?: string;
+    commit_message: string;
+    branch: string;
+    pr_url?: string;
+    changelog?: string;
+    skipped_actions: Array<{
+        action: DeliveryAction;
+        reason: string;
+    }>;
+    errors: string[];
+}
+export interface ChangelogEntry {
+    type: "feat" | "fix" | "refactor" | "test" | "docs" | "chore";
+    scope: string;
+    description: string;
+    task_id: string;
+}
+export type ConflictRisk = "none" | "low" | "medium" | "high";
+export interface ConflictWarning {
+    file: string;
+    risk: ConflictRisk;
+    reason: string;
+    other_branch?: string;
+    other_author?: string;
+}
+export interface CrossRepoHint {
+    repo_a: string;
+    repo_b: string;
+    shared_contract: string;
+    description: string;
+}
+export interface CoordinationCheckResult {
+    branch: string;
+    local_changes: string[];
+    conflict_warnings: ConflictWarning[];
+    cross_repo_hints: CrossRepoHint[];
+    commits_ahead: number;
+    stale_main_warning: boolean;
+    summary: string;
+}
+export interface TeamActivityEntry {
+    author: string;
+    date: string;
+    message: string;
+    short_hash: string;
+    files_changed: number;
+}
+export interface TeamMemberWorkload {
+    author: string;
+    commit_count: number;
+    active_files: string[];
+    last_active: string;
+}
+export interface TeamStatusResult {
+    activity_feed: TeamActivityEntry[];
+    member_workloads: TeamMemberWorkload[];
+    recent_knowledge: Array<{
+        name: string;
+        type: string;
+        updated: string;
+    }>;
+    stale_branches: Array<{
+        name: string;
+        last_commit_date: string;
+    }>;
+    summary: string;
+}
+export type ContractChangeType = "path_added" | "path_removed" | "method_changed" | "field_added" | "field_removed" | "field_type_changed";
+export type ContractChangeSeverity = "breaking" | "compatible";
+export interface ContractChange {
+    file: string;
+    change_type: ContractChangeType;
+    severity: ContractChangeSeverity;
+    description: string;
+    before?: string;
+    after?: string;
+}
+export interface ContractCheckResult {
+    changes: ContractChange[];
+    breaking_count: number;
+    compatible_count: number;
+    cross_service_impact: Array<{
+        service: string;
+        endpoints: string[];
+    }>;
+    requires_review: boolean;
+    summary: string;
+}
+export type OnboardingStep = "project_overview" | "code_tour" | "knowledge_review" | "first_task";
+export interface CodeTourItem {
+    path: string;
+    description: string;
+}
+export interface OnboardingResult {
+    current_step: OnboardingStep;
+    completed_steps: OnboardingStep[];
+    project_overview?: {
+        name: string;
+        tech_stack: string;
+        repos: Array<{
+            name: string;
+            lang: string;
+            framework: string;
+        }>;
+        conventions: string[];
+    };
+    code_tour?: {
+        key_modules: CodeTourItem[];
+        entry_points: string[];
+    };
+    knowledge_summary?: {
+        total: number;
+        patterns: number;
+        procedures: number;
+        key_topics: string[];
+    };
+    first_task_suggestion?: {
+        intent: string;
+        reason: string;
+        difficulty: Complexity;
+    };
+    next_action_hint: string;
+}
+export type FeasibilityLevel = "feasible" | "risky" | "infeasible";
+export interface FeasibilityResult {
+    level: FeasibilityLevel;
+    reasons: string[];
+    recommendations: string[];
+    blocked: false;
+}
+export interface ParsedError {
+    error_type: "compilation" | "test_failure" | "runtime" | "unknown";
+    file?: string;
+    line?: number;
+    message: string;
+    stack_frames: string[];
+}
+export interface CallChainItem {
+    file: string;
+    function?: string;
+    line?: number;
+}
+export interface RootCauseAnalysis {
+    failure_type: FailureType;
+    phase_origin?: string;
+    summary: string;
+    confidence: number;
+}
+export interface FixProposal {
+    description: string;
+    files_to_check: string[];
+    approach: string;
+    risk: Risk;
+}
+export interface TestSuggestion {
+    scenario: string;
+    covers: string;
+    priority: "high" | "medium" | "low";
+}
+export interface DebugSession {
+    task_id: string;
+    error_output: string;
+    parsed_error: ParsedError;
+    call_chain: CallChainItem[];
+    root_cause: RootCauseAnalysis;
+    fix_proposal: FixProposal;
+    test_supplement: TestSuggestion[];
+}
+export interface MetricsSnapshot {
+    timestamp: string;
+    total_tasks: number;
+    pass_rate: number;
+    retry_rate: number;
+    avg_duration_ms: number;
+    knowledge_hit_rate: number;
+}
+export interface AlertItem {
+    level: "warning" | "critical";
+    metric: string;
+    current: number;
+    threshold: number;
+    message: string;
+}
+export interface ObservabilityReport {
+    period: {
+        start: string;
+        end: string;
+    };
+    snapshot: MetricsSnapshot;
+    alerts: AlertItem[];
+    trends: Array<{
+        metric: string;
+        values: number[];
+    }>;
+    summary: string;
+}
+export type DegradationLevel = "full" | "partial" | "minimal";
+export interface DegradationStatus {
+    component: string;
+    level: DegradationLevel;
+    reason: string;
+    since: string;
+}
+export interface TraceSubTask {
+    id: string;
+    title: string;
+    changed_files: string[];
+    test_coverage: "full" | "partial" | "none";
+    review_status: "passed" | "issues" | "skipped";
+    verified: boolean;
+}
+export interface TraceabilityChain {
+    task_id: string;
+    intent: string;
+    sub_tasks: TraceSubTask[];
+    coverage: {
+        total_subtasks: number;
+        covered: number;
+        gaps: string[];
+    };
+    summary: string;
+}
+export interface ADRDraft {
+    id: string;
+    title: string;
+    status: "draft";
+    context: string;
+    decision: string;
+    consequences: string;
+    related_task: string;
+    detected_changes: string[];
+    created_at: string;
+}
+export interface MigrationStatement {
+    line: number;
+    type: string;
+    table?: string;
+    risk: "safe" | "warning" | "critical";
+    description: string;
+}
+export interface MigrationAnalysis {
+    file: string;
+    risk_level: "safe" | "warning" | "critical";
+    statements: MigrationStatement[];
+    rollback_suggestions: string[];
+    summary: string;
+}
+export interface TestScenario {
+    name: string;
+    given: string;
+    when: string;
+    then: string;
+    priority: "high" | "medium" | "low";
+}
+export interface TestGenGuide {
+    source_file: string;
+    test_type: "unit" | "integration" | "e2e";
+    test_file_suggestion: string;
+    scenarios: TestScenario[];
+    fixtures_needed: string[];
+    mock_points: string[];
+}
+export interface TestQualityCheck {
+    dimension: "assertion_density" | "boundary_coverage" | "naming" | "duplication" | "scenario_coverage";
+    passed: boolean;
+    detail: string;
+}
+export interface TestQualityReport {
+    file: string;
+    score: number;
+    checks: TestQualityCheck[];
+    suggestions: string[];
+}
+export interface VulnerabilityItem {
+    package: string;
+    installed_version: string;
+    severity: "low" | "medium" | "high" | "critical";
+    issue: string;
+    fixed_in: string;
+}
+export interface DependencyScanResult {
+    file: string;
+    dependencies_scanned: number;
+    vulnerabilities: VulnerabilityItem[];
+    unscoped_versions: string[];
+    summary: string;
+}
+export interface DebtReport {
+    total_open: number;
+    by_category: Record<string, number>;
+    by_severity: Record<string, number>;
+    oldest_debt_days: number;
+    trend_30d: {
+        created: number;
+        resolved: number;
+        net: number;
+    };
+    top_priority: DebtItem[];
+    summary: string;
+}
+export interface WorkspaceProduct {
+    name: string;
+    profile: string;
+    paths: string[];
+    knowledge_scope: "isolated" | "shared";
+}
+export interface WorkspaceConfig {
+    products: WorkspaceProduct[];
+    shared_knowledge: string[];
+}
+export interface CostBudget {
+    daily_token_limit: number;
+    weekly_token_limit: number;
+    monthly_token_limit: number;
+}
+export interface CostAlert {
+    level: "warning" | "critical";
+    period: "daily" | "weekly" | "monthly";
+    used: number;
+    limit: number;
+    message: string;
+}
+export interface PromptExperiment {
+    id: string;
+    knowledge_entry: string;
+    variant_a: string;
+    variant_b: string;
+    metrics: string[];
+    status: "draft" | "running" | "completed";
+    created_at: string;
+}
+export interface ExperimentResult {
+    experiment_id: string;
+    variant_a_metrics: Record<string, number>;
+    variant_b_metrics: Record<string, number>;
+    winner: "a" | "b" | "inconclusive";
+    confidence: number;
+    summary: string;
+}
+//# sourceMappingURL=types.d.ts.map