codanna 0.9.19

Code Intelligence for Large Language Models
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
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180

//! CLI command definitions for profile management

use clap::Parser;
use std::path::PathBuf;

/// Profile management actions
#[derive(Debug, Clone, Parser)]
pub enum ProfileAction {
    /// Initialize project with a profile
    #[command(
        about = "Initialize project with a profile",
        after_help = "Examples:\n  codanna profile init claude\n  codanna profile init claude --source ~/.codanna/profiles"
    )]
    Init {
        /// Profile name to initialize
        profile_name: String,

        /// Profile source directory (defaults to ~/.codanna/profiles)
        #[arg(long)]
        source: Option<PathBuf>,

        /// Force initialization even if .codanna exists
        #[arg(short, long)]
        force: bool,
    },

    /// Install a profile to current workspace
    #[command(
        about = "Install a profile to current workspace",
        after_help = "Examples:\n  codanna profile install claude\n  codanna profile install claude --source git@github.com:codanna/profiles.git"
    )]
    Install {
        /// Profile name to install
        profile_name: String,

        /// Profile source (git URL or local directory)
        #[arg(long)]
        source: Option<String>,

        /// Git reference (branch, tag, or commit SHA)
        #[arg(long)]
        r#ref: Option<String>,

        /// Force installation even if profile exists
        #[arg(short, long)]
        force: bool,
    },

    /// List available profiles
    #[command(
        about = "List available profiles",
        after_help = "Example:\n  codanna profile list\n  codanna profile list --verbose"
    )]
    List {
        /// Show detailed information
        #[arg(short, long)]
        verbose: bool,

        /// Output in JSON format
        #[arg(long)]
        json: bool,
    },

    /// Show profile status for current workspace
    #[command(
        about = "Show active profile and installation status",
        after_help = "Example:\n  codanna profile status"
    )]
    Status {
        /// Show detailed file tracking information
        #[arg(short, long)]
        verbose: bool,
    },

    /// Sync team configuration
    #[command(
        about = "Register providers and install profiles from team configuration",
        after_help = "Examples:\n  codanna profile sync\n  codanna profile sync --force"
    )]
    Sync {
        /// Force installation even if profiles exist or files conflict
        #[arg(short, long)]
        force: bool,
    },

    /// Update an installed profile
    #[command(
        about = "Update an installed profile from its provider",
        after_help = "Examples:\n  codanna profile update codanna\n  codanna profile update codanna --force"
    )]
    Update {
        /// Profile name to update
        profile_name: String,

        /// Force update even if already at latest commit
        #[arg(short, long)]
        force: bool,
    },

    /// Remove an installed profile
    #[command(
        about = "Remove an installed profile from workspace",
        after_help = "Examples:\n  codanna profile remove codanna\n  codanna profile remove codanna --verbose"
    )]
    Remove {
        /// Profile name to remove
        profile_name: String,

        /// Show detailed removal information
        #[arg(short, long)]
        verbose: bool,
    },

    /// Manage profile providers
    #[command(
        about = "Manage profile providers",
        after_help = "Examples:\n  codanna profile provider add codanna/claude-provider\n  codanna profile provider add ./my-provider --id custom\n  codanna profile provider list\n  codanna profile provider list --verbose\n  codanna profile provider remove claude-provider"
    )]
    Provider {
        #[command(subcommand)]
        action: ProviderAction,
    },

    /// Verify profile integrity
    #[command(
        about = "Verify profile integrity",
        after_help = "Examples:\n  codanna profile verify claude\n  codanna profile verify --all\n  codanna profile verify --all --verbose"
    )]
    Verify {
        /// Profile name to verify (omit for --all)
        profile_name: Option<String>,

        /// Verify all installed profiles
        #[arg(long, conflicts_with = "profile_name")]
        all: bool,

        /// Show detailed verification information
        #[arg(short, long)]
        verbose: bool,
    },
}

/// Provider management actions
#[derive(Debug, Clone, Parser)]
pub enum ProviderAction {
    /// Add a provider to the global registry
    #[command(
        about = "Add a provider to the global registry",
        after_help = "Examples:\n  codanna profile provider add codanna/claude-provider\n  codanna profile provider add https://github.com/codanna/profiles.git\n  codanna profile provider add ./my-provider --id custom"
    )]
    Add {
        /// Provider source (GitHub shorthand, git URL, or local path)
        source: String,

        /// Custom provider ID (defaults to derived from source)
        #[arg(long)]
        id: Option<String>,
    },

    /// Remove a provider from the global registry
    #[command(
        about = "Remove a provider from the global registry",
        after_help = "Example:\n  codanna profile provider remove claude-provider"
    )]
    Remove {
        /// Provider ID to remove
        provider_id: String,
    },

    /// List registered providers
    #[command(
        about = "List registered providers",
        after_help = "Examples:\n  codanna profile provider list\n  codanna profile provider list --verbose"
    )]
    List {
        /// Show detailed information including available profiles
        #[arg(short, long)]
        verbose: bool,
    },
}