a3s 0.10.4

a3s — A3S coding agent CLI; `a3s code` launches the interactive TUI
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118

//! Facts accepted by the inquiry reducer.

use serde::{Deserialize, Serialize};

use super::{
    EvidenceRef, Perspective, Question, ResearchContractAssessment, ResearchMethod,
    ResearchObligation, ResearchOutline,
};

#[derive(Clone, Debug, Deserialize, Eq, PartialEq, Serialize)]
#[serde(tag = "type", rename_all = "snake_case")]
pub enum InquiryEvent {
    StrategySelected {
        method: ResearchMethod,
    },
    ResearchObligationsCommitted {
        obligations: Vec<ResearchObligation>,
        stop_conditions: Vec<String>,
    },
    /// Legacy journal replay only. New inquiries begin with planner-authored
    /// questions and never execute a scout phase.
    ScoutCompleted {
        source_ids: Vec<String>,
    },
    /// Legacy journal replay only. The active runtime has a fixed bounded
    /// coverage loop and no perspective-wave budget.
    PerspectiveBudgetSelected {
        total_retrieval_waves: u8,
    },
    /// Legacy journal replay only. New plans use stable research obligations
    /// and questions directly.
    PerspectivesCommitted {
        perspectives: Vec<Perspective>,
    },
    QuestionsQueued {
        questions: Vec<Question>,
    },
    EvidenceAccepted {
        evidence: EvidenceRef,
    },
    QuestionAnswered {
        question_id: String,
        answer: String,
        evidence_ids: Vec<String>,
    },
    /// A traceable answer that materially advances the question but retains a
    /// consequential evidence limitation. The projection keeps it answerable
    /// for material-evidence purposes while `bound_reason` preserves why the
    /// linked completion criterion remains qualified.
    QuestionPartiallyAnswered {
        question_id: String,
        answer: String,
        limitation: String,
        evidence_ids: Vec<String>,
    },
    /// Legacy journal replay only. The active closed-evidence review resolves
    /// every question exactly once as answered or bounded.
    QuestionDeferred {
        question_id: String,
        reason: String,
    },
    QuestionBounded {
        question_id: String,
        reason: String,
    },
    ResearchContractAssessed {
        assessment: ResearchContractAssessment,
    },
    OutlineCommitted {
        outline: ResearchOutline,
    },
    SectionDrafted {
        section_id: String,
        content: String,
        citation_ids: Vec<String>,
    },
    SectionRevisionStarted {
        round: usize,
        section_ids: Vec<String>,
        input_digest: String,
    },
    SectionRevisionCommitted {
        round: usize,
        input_digest: String,
    },
    AuditCompleted {
        passed: bool,
        issues: Vec<String>,
    },
    BudgetExhausted {
        reason: String,
    },
}

impl InquiryEvent {
    pub fn name(&self) -> &'static str {
        match self {
            Self::StrategySelected { .. } => "strategy_selected",
            Self::ResearchObligationsCommitted { .. } => "research_obligations_committed",
            Self::ScoutCompleted { .. } => "scout_completed",
            Self::PerspectiveBudgetSelected { .. } => "perspective_budget_selected",
            Self::PerspectivesCommitted { .. } => "perspectives_committed",
            Self::QuestionsQueued { .. } => "questions_queued",
            Self::EvidenceAccepted { .. } => "evidence_accepted",
            Self::QuestionAnswered { .. } => "question_answered",
            Self::QuestionPartiallyAnswered { .. } => "question_partially_answered",
            Self::QuestionDeferred { .. } => "question_deferred",
            Self::QuestionBounded { .. } => "question_bounded",
            Self::ResearchContractAssessed { .. } => "research_contract_assessed",
            Self::OutlineCommitted { .. } => "outline_committed",
            Self::SectionDrafted { .. } => "section_drafted",
            Self::SectionRevisionStarted { .. } => "section_revision_started",
            Self::SectionRevisionCommitted { .. } => "section_revision_committed",
            Self::AuditCompleted { .. } => "audit_completed",
            Self::BudgetExhausted { .. } => "budget_exhausted",
        }
    }
}