Function builtin_du

builtin_du(
    args: string[],
): Promise<
    {
        errors?: { message: string; type: "error"
        | "warning" }[];
        model?: { data: unknown; kind: string };
        rendered: string;
        renderedErr?: string;
        status: "error" | "ok";
        trace?: {
            executed?: string;
            input: string;
            proposed: string;
            validated: boolean;
        };
    },
>
Displays disk usage statistics for ChRIS filesystem directories. Mimics standard Linux du command behavior and flags. Uses chili's scan_do machinery for recursive filesystem traversal.
Parameters
- args: string[]
  Command line arguments (optional path and flags).
Returns Promise<
    {
        errors?: { message: string; type: "error"
        | "warning" }[];
        model?: { data: unknown; kind: string };
        rendered: string;
        renderedErr?: string;
        status: "error" | "ok";
        trace?: {
            executed?: string;
            input: string;
            proposed: string;
            validated: boolean;
        };
    },
>
A Promise that resolves when disk usage is displayed.
Example
```
du                      # Disk usage of current directory
du -h                   # Human-readable sizes
du -s /home/user/data   # Summary only
du -a                   # Show all files, not just directories
du -c                   # Show grand total
du -d 2                 # Max depth of 2 levels
```
- Defined in packages/brasa/src/builtins/fs/du.ts:227