| 149 | /// useful for checking status in large repositories. |
| 150 | #[derive(Parser, Debug)] |
| 151 | pub struct Status { |
| 152 | /// Show status for specific path only. |
| 153 | /// |
| 154 | /// When provided, only files under this path will be included in |
| 155 | /// the status output. The path is relative to the repository root. |
| 156 | #[arg(value_name = "PATH")] |
| 157 | pub path: Option<String>, |
| 158 | |
| 159 | /// Show short/porcelain output. |
| 160 | /// |
| 161 | /// The short format displays one line per file with a two-character |
| 162 | /// status code followed by the file path. This format is designed |
| 163 | /// for machine parsing and scripts. |
| 164 | /// |
| 165 | /// Status codes: |
| 166 | /// - `A ` - Added (new tracked file) |
| 167 | /// - `M ` - Modified |
| 168 | /// - `D ` - Deleted |
| 169 | /// - `R ` - Renamed |
| 170 | /// - `C ` - Conflicted |
| 171 | /// - `T ` - Type changed |
| 172 | /// - `P ` - Permissions changed |
| 173 | /// - `??` - Untracked |
| 174 | #[arg(short = 's', long = "short")] |
| 175 | pub short: bool, |
| 176 | |
| 177 | /// Emit a versioned JSON document for IDEs and other integrations. |
| 178 | #[arg(long, conflicts_with_all = ["short", "debug_ignore", "no_reconcile"])] |
| 179 | pub json: bool, |
| 180 | |
| 181 | /// Don't show untracked files. |
| 182 | /// |
| 183 | /// By default, untracked files are shown in the status output. |
| 184 | /// Use this flag to hide them, showing only tracked files that |
| 185 | /// have changes. |
| 186 | #[arg(long = "no-untracked")] |
| 187 | pub no_untracked: bool, |
| 188 | |
| 189 | /// Debug ignore pattern matching. |
| 190 | /// |
| 191 | /// Shows diagnostic information about how .atomicignore patterns |
| 192 | /// are being applied. Useful for troubleshooting why files are |
| 193 | /// or aren't being ignored. |
| 194 | #[arg(long = "debug-ignore", hide = true)] |
| 195 | pub debug_ignore: bool, |
| 196 | |
| 197 | /// Rebuild the FILE_INDEX before computing status. |
| 198 | /// |
| 199 | /// Walks every tracked file, hashes its content, and updates the |
| 200 | /// FILE_INDEX cache so that subsequent `status` calls use the fast |
| 201 | /// stat-comparison path instead of reconstructing graph content. |
| 202 | /// |
| 203 | /// This is useful after `git import` where file mtimes are reset, |
| 204 | /// invalidating the cached entries. |
| 205 | #[arg(long = "reindex", conflicts_with = "no_reconcile")] |
| 206 | pub reindex: bool, |
| 207 | |
| 208 | /// Print read-only Git/Atomic checkpoint evidence without reconciliation. |