chore: update generated docs

Author: alexeagle

buildinfo/bazel_stamp_info.sh

@@ -0,0 +1,27 @@
+#!/bin/bash
+# This script is called by Bazel when it needs info about the git state.
+# The --workspace_status_command flag tells Bazel the location of this script.
+# This is configured in `/.bazelrc`.
+set -o pipefail -o errexit -o nounset
+
+function has_local_changes {
+    if [ "$(git status --porcelain)" != "" ]; then
+        echo dirty
+    else
+        echo clean
+    fi
+}
+
+# "volatile" keys, these will not cause a re-build because they're assumed to change on every build
+# and its okay to use a stale value in a stamped binary
+echo "BUILD_TIME $(date "+%Y-%m-%d %H:%M:%S %Z")"
+
+# "stable" keys, should remain constant over rebuilds, therefore changed values will cause a
+# rebuild of any stamped action that uses ctx.info_file or genrule with stamp = True
+# Note, BUILD_USER is automatically available in the stable-status.txt, it matches $USER
+echo "STABLE_BUILD_SCM_SHA $(git rev-parse HEAD)"
+echo "STABLE_BUILD_SCM_LOCAL_CHANGES $(has_local_changes)"
+
+if [ "$(git tag | wc -l)" -gt 0 ]; then
+    echo "STABLE_BUILD_SCM_TAG $(git describe --tags)"
+fi

docs/aspect.md

@@ -30,5 +30,5 @@ Aspect CLI is a better frontend for running bazel
 * [aspect run](aspect_run.md)	 - Build a single target and run it with the given arguments
 * [aspect shutdown](aspect_shutdown.md)	 - Stop the bazel server
 * [aspect test](aspect_test.md)	 - Build the specified targets and run all test targets among them
-* [aspect version](aspect_version.md)	 - Print the versions of Aspect CLI, Bazelisk, and Bazel
+* [aspect version](aspect_version.md)	 - Print the versions of Aspect CLI and Bazel
 

docs/aspect_clean.md

@@ -47,16 +47,7 @@ aspect clean [--expunge] [all] [flags]
 ### Options
 
 ```
-      --expunge         Remove the entire output_base tree.
-                        This removes all build output, external repositories,
-                        and temp files created by Bazel.
-                        It also stops the Bazel server after the clean,
-                        equivalent to the shutdown command.
-      --expunge_async   Expunge in the background.
-                        It is safe to invoke a Bazel command in the same
-                        workspace while the asynchronous expunge continues to run.
-                        Note, however, that this may introduce IO contention.
-  -h, --help            help for clean
+  -h, --help   help for clean
 ```
 
 ### Options inherited from parent commands

docs/aspect_info.md

@@ -31,9 +31,7 @@ aspect info [keys] [flags]
 ### Options
 
 ```
-  -h, --help            help for info
-      --show_make_env   include the set of key/value pairs in the "Make" environment,
-                        accessible within BUILD files
+  -h, --help   help for info
 ```
 
 ### Options inherited from parent commands

docs/aspect_version.md

@@ -1,6 +1,6 @@
 ## aspect version
 
-Print the versions of Aspect CLI, Bazelisk, and Bazel
+Print the versions of Aspect CLI and Bazel
 
 ### Synopsis
 
@@ -13,8 +13,7 @@ aspect version [flags]
 ### Options
 
 ```
-      --gnu_format   format space-separated following GNU convention
-  -h, --help         help for version
+  -h, --help   help for version
 ```
 
 ### Options inherited from parent commands

nogo_config.json

@@ -27,7 +27,8 @@
   },
   "sigchanyzer": {
     "exclude_files": {
-      "(third_party|vendor|external)/.*": "only run for first-party code"
+      "(third_party|vendor|external)/.*": "only run for first-party code",
+      "pkg/bazel/bazelisk.go": "copied third-party code"
     }
   },
   "stdmethods": {