doc: add docs for new options

Author: HerringtonDarkholme

website/reference/cli.md

@@ -27,13 +27,15 @@ sg run [OPTIONS] --pattern <PATTERN> [PATHS]...
 |   | --debug-query`[=<format>]` |  Print query pattern's tree-sitter AST. Requires lang be set explicitly. |
 |   | --strictness `<STRICTNESS>`   |  The strictness of the pattern [possible values: cst, smart, ast, relaxed, signature] |
 |   | --follow   |  Follow symbolic links |
+|   |  --no-ignore `<NO_IGNORE>`  | Do not respect hidden file system or ignore files (.gitignore, .ignore, etc.) [possible values: hidden, dot, exclude, global, parent, vcs] |
+|   |  --stdin           | Enable search code from StdIn. See [link](/guide/tooling-overview.html#enable-stdin-mode) |
+|   | --globs `<GLOBS>`   | Include or exclude file paths
 | -i| --interactive         |  Start interactive edit session. Code rewrite only happens inside a session. |
 | -U|  --update-all         |  Apply all rewrite without confirmation if true. |
 |   | --json`[=<style>]`    | Output matches in structured JSON  [possible values: pretty, stream, compact] |
-|   |   --heading `<WHEN>`  | Controls whether to print the file name as heading [default: auto] [possible values: auto, always, never] |
 |   |  --color `<WHEN>`     | Controls output color [default: auto] |
-|   |  --no-ignore `<NO_IGNORE>`  | Do not respect hidden file system or ignore files (.gitignore, .ignore, etc.) [possible values: hidden, dot, exclude, global, parent, vcs] |
-|   |  --stdin           | Enable search code from StdIn. See [link](/guide/tooling-overview.html#enable-stdin-mode) |
+|   |  --tracing `<LEVEL>`  | Show tracing information for file/rule discovery and scanning [default: nothing] [possible values: nothing, summary]
+|   | --heading `<WHEN>`    | Controls whether to print the file name as heading [default: auto] [possible values: auto, always, never] |
 | -A| --after `<NUM>`      | Show NUM lines after each match [default: 0] |
 | -B| --before `<NUM>`     | Show NUM lines before each match [default: 0] |
 | -C| --context `<NUM>`    | Show NUM lines around each match [default: 0] |
@@ -68,6 +70,8 @@ sg scan [OPTIONS] [PATHS]...
 | -U | --update-all | Apply all rewrite without confirmation |
 | | --no-ignore `<NO_IGNORE>` | Do not respect ignore files. (.gitignore, .ignore, etc.) [possible values: hidden, dot, exclude, global, parent, vcs] |
 |   |  --stdin           | Enable search code from StdIn. See [link](/guide/tooling-overview.html#enable-stdin-mode) |
+|   | --globs `<GLOBS>`   | Include or exclude file paths
+|   |  --tracing `<LEVEL>`  | Show tracing information for file/rule discovery and scanning [default: nothing] [possible values: nothing, summary]
 | -h| --help|Print help|
 
 ## `sg test`
@@ -135,6 +139,13 @@ Start a language server to [report diagnostics](/guide/scan-project.html) in you
 sg lsp
 ```
 
+### Options
+
+| Short | Long | Description |
+|-------|------|-------------|
+| -c | --config `<CONFIG_FILE>`| Path to ast-grep root config, default is `sgconfig.yml` |
+| -h| `--help`                | Print help (see more with '--help') |
+
 ## `sg completions`
 
 Generate shell completion script.

website/reference/cli/run.md

@@ -87,6 +87,12 @@ Enable search code from StdIn.
 
 Use this if you need to take code stream from standard input.
 
+### `--globs <GLOBS>`
+
+Include or exclude file paths.
+
+Include or exclude files and directories for searching that match the given glob. This always overrides any other ignore logic. Multiple glob flags may be used. Globbing rules match .gitignore globs. Precede a glob with a `!` to exclude it. If multiple globs match a file or directory, the glob given later in the command line takes precedence.
+
 ### `--follow`
 
 Follow symbolic links.
@@ -141,6 +147,18 @@ Possible values:
 - **always**: Always print heading regardless of output type
 - **never**:  Never print heading regardless of output type
 
+### `--tracing <LEVEL>`
+
+Show tracing information for file/rule discovery and scanning.
+
+This flag helps user to inspect ast-grep's internal filtering of files and rules. tracing will output how many and why files and rules are scanned and skipped. tracing information outputs to stderr and does not affect the result of the search.
+
+[default: nothing]
+
+Possible values:
+- **nothing**: Do not show any tracing information
+- **summary**: Show summary about how many files are scanned and skipped
+
 ## Context Options
 
 ### `-A, --after <NUM>`

website/reference/cli/scan.md

@@ -67,6 +67,12 @@ Follow symbolic links.
 
 This flag instructs ast-grep to follow symbolic links while traversing directories. This behavior is disabled by default. Note that ast-grep will check for symbolic link loops and report errors if it finds one. ast-grep will also report errors for broken links.
 
+### `--globs <GLOBS>`
+
+Include or exclude file paths.
+
+Include or exclude files and directories for searching that match the given glob. This always overrides any other ignore logic. Multiple glob flags may be used. Globbing rules match .gitignore globs. Precede a glob with a `!` to exclude it. If multiple globs match a file or directory, the glob given later in the command line takes precedence.
+
 ## Output Options
 
 ### `-i, --interactive`
@@ -88,6 +94,18 @@ Possible values:
 - stream:  Prints each match as a separate JSON object, followed by a newline character. This is useful for streaming the output to other programs that can read one object per line
 - compact: Prints the matches as a single-line JSON array, without any whitespace. This is useful for saving space and minimizing the output size
 
+### `--tracing <LEVEL>`
+
+Show tracing information for file/rule discovery and scanning.
+
+This flag helps user to inspect ast-grep's internal filtering of files and rules. tracing will output how many and why files and rules are scanned and skipped. tracing information outputs to stderr and does not affect the result of the search.
+
+[default: nothing]
+
+Possible values:
+- **nothing**: Do not show any tracing information
+- **summary**: Show summary about how many files are scanned and skipped
+
 ### `--format <FORMAT>`
 Output warning/error messages in GitHub Action format.