a3s 0.10.5

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
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151

use a3s::components::ComponentId;
use clap::{Args, Subcommand, ValueEnum};

#[derive(Clone, Debug, Args)]
pub(crate) struct InfoArgs {
    #[arg(value_name = "COMPONENT")]
    pub component: ComponentId,
    /// Query and include known versions.
    #[arg(long)]
    pub versions: bool,
    /// Include every catalog-declared source.
    #[arg(long)]
    pub sources: bool,
}

#[derive(Clone, Debug, Default, Args)]
pub(crate) struct DoctorArgs {
    #[arg(value_name = "COMPONENT")]
    pub component: Option<ComponentId>,
}

#[derive(Clone, Debug, Args)]
#[command(subcommand_required = true, arg_required_else_help = true)]
pub(crate) struct RegistryArgs {
    #[command(subcommand)]
    pub command: RegistryCommand,
}

#[derive(Clone, Debug, Subcommand)]
pub(crate) enum RegistryCommand {
    /// List the official and explicitly trusted registries.
    List,
    /// Show one registry and its trust identity.
    Show(RegistryNameArgs),
    /// Trust and add a registry URL.
    Add(RegistryAddArgs),
    /// Remove an explicitly added registry.
    Remove(RegistryRemoveArgs),
    /// Check registry reachability and metadata freshness.
    Refresh(RegistryRefreshArgs),
}

#[derive(Clone, Debug, Args)]
pub(crate) struct RegistryNameArgs {
    #[arg(value_name = "NAME")]
    pub name: String,
}

#[derive(Clone, Debug, Args)]
pub(crate) struct RegistryAddArgs {
    #[arg(value_name = "URL")]
    pub url: String,
    /// TUF root file or sha256 digest establishing trust.
    #[arg(long, value_name = "FILE_OR_DIGEST")]
    pub trust_root: String,
    /// Accept the explicit trust operation without prompting.
    #[arg(long)]
    pub yes: bool,
}

#[derive(Clone, Debug, Args)]
pub(crate) struct RegistryRemoveArgs {
    #[arg(value_name = "NAME")]
    pub name: String,
    #[arg(long)]
    pub yes: bool,
}

#[derive(Clone, Debug, Default, Args)]
pub(crate) struct RegistryRefreshArgs {
    #[arg(value_name = "NAME")]
    pub name: Option<String>,
}

#[derive(Clone, Debug, Args)]
#[command(subcommand_required = true, arg_required_else_help = true)]
pub(crate) struct CacheArgs {
    #[command(subcommand)]
    pub command: CacheCommand,
}

#[derive(Clone, Debug, Subcommand)]
pub(crate) enum CacheCommand {
    /// Print the recreatable cache root.
    Path,
    /// Report cache size and entry counts.
    Status,
    /// Remove expired and unreferenced temporary entries.
    Prune(CacheMutationArgs),
    /// Remove all recreatable A3S cache content.
    Clean(CacheCleanArgs),
}

#[derive(Clone, Debug, Default, Args)]
pub(crate) struct CacheMutationArgs {
    #[arg(long)]
    pub dry_run: bool,
}

#[derive(Clone, Debug, Default, Args)]
pub(crate) struct CacheCleanArgs {
    #[arg(long)]
    pub dry_run: bool,
    #[arg(long)]
    pub yes: bool,
}

#[derive(Clone, Copy, Debug, Eq, PartialEq, ValueEnum)]
pub(crate) enum CompletionShell {
    Bash,
    Zsh,
    Fish,
    Powershell,
    Elvish,
}

#[derive(Clone, Debug, Args)]
pub(crate) struct CompletionArgs {
    #[arg(value_enum)]
    pub shell: CompletionShell,
}

#[derive(Clone, Debug, Default, Args)]
pub(crate) struct HelpArgs {
    #[arg(value_name = "COMMAND")]
    pub command: Vec<String>,
}

#[derive(Clone, Copy, Debug, Eq, PartialEq, ValueEnum)]
pub(crate) enum ComponentKindArg {
    #[value(name = "built-in")]
    BuiltIn,
    Product,
    Capability,
    Extension,
}

#[derive(Clone, Copy, Debug, Default, Eq, PartialEq, ValueEnum)]
pub(crate) enum ReleaseChannelArg {
    #[default]
    Stable,
    Beta,
    Nightly,
}

#[derive(Clone, Copy, Debug, Default, Eq, PartialEq, ValueEnum)]
pub(crate) enum InstallScopeArg {
    #[default]
    User,
    System,
}