libra stats

Historical design for showing file statistics for the current working directory.

Status: unpublished. libra stats is not registered in the public CLI in the current release. Running it returns the standard unknown-command error (LBR-CLI-001). The interface below describes preserved design material, not a user-visible command contract.

The unpublished design is a Libra-only extension (it has no git equivalent). It is a read-only command that recursively scans the current working directory, counts regular files, and groups them by file extension. The .libra/ metadata directory and the target/ build directory are skipped.

Synopsis

libra stats

Description

• Walks the current working directory recursively.
• Counts every regular file and buckets it by extension. Files without an extension are reported under no_extension.
• Skips the .libra/ and target/ directories.
• Prints a human-readable summary by default, or a structured envelope with the global --json / --machine flags.

The command does not read the index or any commit; it reports the on-disk working tree exactly as it is.

Options

If this command is published in a future release, it should take no command-specific options and honor the global output flags:

Flag	Description
--json[=<FORMAT>]	Emit the result as JSON (pretty, compact, or ndjson).
--machine	Strict machine mode (--json=ndjson --no-pager --color=never --quiet).
--quiet	Suppress stdout.

Output

Human-readable:

File statistics:
total: 42
no_extension: 3
md: 7
rs: 32

JSON (--json):

{
  "total": 42,
  "extensions": {
    "md": 7,
    "no_extension": 3,
    "rs": 32
  }
}

Examples

# Count working-tree files grouped by extension
libra stats

# Structured JSON output for agents/tooling
libra stats --json