chore(docs): improved site metadata and tests

- Enhanced metadata handling in various layout files to improve SEO and user experience.
- Introduced a new skill to verify the availability of NVIDIA Elements packages on npm and check the documentation site status.
- Added a deterministic script for generating the availability report, including npm metadata checks and temporary project management.
- Updated the pre-tool use hook to warn about destructive git operations in isolated VM environments.
Signed-off-by: Cory Rylan <crylan@nvidia.com>

Author: coryrylan

.agents/hooks/pre-tool-use-bash.sh

@@ -7,11 +7,25 @@ source "$HOOK_DIR/lib/project-root.sh"
 COMMAND=$(hook_command_from_input "$INPUT"|| true)
 GIT_PREFIX='(^|[;&|][[:space:]]*)git([[:space:]]+(-C[[:space:]]+[^[:space:];&|]+|--no-pager|-c[[:space:]]+[^[:space:];&|]+|--work-tree(=|[[:space:]]+)[^[:space:];&|]+))*[[:space:]]+'
 
+if [[ -z"${NVE_AGENT:-}"&&-n"${CURSOR_AGENT+x}"&&-z"${CURSOR_SANDBOX+x}" ]];then
+export NVE_AGENT="cursor-cloud-agent"
+fi
+
 # Exit early if not a git command
 if [[ -z"$COMMAND" ]] ||!echo"$COMMAND"| grep -qE '(^|[;&|][[:space:]]*)git([[:space:]]|$)';then
 exit 0
 fi
 
+warn() {
+echo"WARNING: Destructive git operation detected.">&2
+echo" Command: $COMMAND">&2
+echo" Reason: $1.">&2
+echo"">&2
+echo"Per AGENTS.md policy, destructive git operations require explicit user confirmation on user machines.">&2
+echo"In isolated VM environments, this hook is warning instead of blocking.">&2
+exit 0
+}
+
 block() {
 echo"BLOCKED: Destructive git operation detected.">&2
 echo" Command: $COMMAND">&2
@@ -22,19 +36,27 @@ block() {
 exit 2
 }
 
-echo"$COMMAND"| grep -qF "reset --hard"&& block "git reset --hard discards all uncommitted changes irreversibly"
-echo"$COMMAND"| grep -qF "push --force"&& block "git push --force can overwrite remote history and destroy teammates' work"
-echo"$COMMAND"| grep -qF "push -f"&& block "git push -f can overwrite remote history and destroy teammates' work"
-echo"$COMMAND"| grep -qF "clean -f"&& block "git clean -f permanently deletes untracked files"
-echo"$COMMAND"| grep -qF "checkout -- ."&& block "git checkout -- . discards all unstaged changes irreversibly"
-echo"$COMMAND"| grep -qF "branch -D"&& block "git branch -D force-deletes a branch without merge checks"
-
-echo"$COMMAND"| grep -qE "${GIT_PREFIX}(add|stage)([[:space:]]|$)"&& block "git add/stage modifies the index"
-echo"$COMMAND"| grep -qE "${GIT_PREFIX}restore([[:space:]][^;&|]*)?[[:space:]]--staged([[:space:]]|$)"&& block "git restore --staged removes files from the index"
-echo"$COMMAND"| grep -qE "${GIT_PREFIX}reset([[:space:]]|$)"&& block "git reset modifies the index or moves HEAD"
-echo"$COMMAND"| grep -qE "${GIT_PREFIX}rm([[:space:]][^;&|]*)?[[:space:]]--cached([[:space:]]|$)"&& block "git rm --cached removes files from the index"
-echo"$COMMAND"| grep -qE "${GIT_PREFIX}rm([[:space:]]|$)"&& block "git rm stages file removals"
-echo"$COMMAND"| grep -qE "${GIT_PREFIX}mv([[:space:]]|$)"&& block "git mv stages file renames"
-echo"$COMMAND"| grep -qE "${GIT_PREFIX}update-index([[:space:]]|$)"&& block "git update-index modifies the index"
+handle_blocked_operation() {
+if [[ "${NVE_AGENT:-}"==*cloud* ]];then
+ warn "$1"
+fi
+
+ block "$1"
+}
+
+echo"$COMMAND"| grep -qF "reset --hard"&& handle_blocked_operation "git reset --hard discards all uncommitted changes irreversibly"
+echo"$COMMAND"| grep -qF "push --force"&& handle_blocked_operation "git push --force can overwrite remote history and destroy teammates' work"
+echo"$COMMAND"| grep -qF "push -f"&& handle_blocked_operation "git push -f can overwrite remote history and destroy teammates' work"
+echo"$COMMAND"| grep -qF "clean -f"&& handle_blocked_operation "git clean -f permanently deletes untracked files"
+echo"$COMMAND"| grep -qF "checkout -- ."&& handle_blocked_operation "git checkout -- . discards all unstaged changes irreversibly"
+echo"$COMMAND"| grep -qF "branch -D"&& handle_blocked_operation "git branch -D force-deletes a branch without merge checks"
+
+echo"$COMMAND"| grep -qE "${GIT_PREFIX}(add|stage)([[:space:]]|$)"&& handle_blocked_operation "git add/stage modifies the index"
+echo"$COMMAND"| grep -qE "${GIT_PREFIX}restore([[:space:]][^;&|]*)?[[:space:]]--staged([[:space:]]|$)"&& handle_blocked_operation "git restore --staged removes files from the index"
+echo"$COMMAND"| grep -qE "${GIT_PREFIX}reset([[:space:]]|$)"&& handle_blocked_operation "git reset modifies the index or moves HEAD"
+echo"$COMMAND"| grep -qE "${GIT_PREFIX}rm([[:space:]][^;&|]*)?[[:space:]]--cached([[:space:]]|$)"&& handle_blocked_operation "git rm --cached removes files from the index"
+echo"$COMMAND"| grep -qE "${GIT_PREFIX}rm([[:space:]]|$)"&& handle_blocked_operation "git rm stages file removals"
+echo"$COMMAND"| grep -qE "${GIT_PREFIX}mv([[:space:]]|$)"&& handle_blocked_operation "git mv stages file renames"
+echo"$COMMAND"| grep -qE "${GIT_PREFIX}update-index([[:space:]]|$)"&& handle_blocked_operation "git update-index modifies the index"
 
 exit 0

.agents/skills/availability-report/SKILL.md

@@ -0,0 +1,71 @@
+---
+name: availability-report
+description: Generate a production availability report for NVIDIA Elements packages and documentation.
+---
+
+# Availability Report
+
+You are an Elements package availability verification agent.
+
+## Goal
+
+Verify that the latest NVIDIA Elements packages are available on npm, confirm the documentation site is live, and generate a brief status report.
+
+## Deterministic Script
+
+Run the deterministic report script:
+
+```shell
+node .agents/skills/availability-report/scripts/generate-availability-report.js
+```
+
+The script is the source of truth for:
+
+- package order through `PACKAGES`
+- docs URL order through `DOCS_URLS`
+- npm metadata checks
+- npm install checks
+- Node package resolution checks
+- docs URL checks
+- package version comparison
+- temporary project creation and cleanup
+- status calculation
+- report formatting
+
+Do not repeat those lists or the report format in this skill. Update `scripts/generate-availability-report.js` instead.
+
+## Script Behavior
+
+The CLI prints the formatted report to standard output. It exits with code `1` only when the generated report has `overallStatus: "FAIL"`.
+
+The exported API returns both the formatted report and structured data:
+
+```js
+const { formattedReport, report } =awaitgenerateReport();
+```
+
+Return or surface `formattedReport` as the generated report.
+
+The script creates a temporary npm project with:
+
+-`mkdtemp(path.join(os.tmpdir(), 'nvidia-elements-availability-report-'))`
+-`npm init -y`
+-`npm install --no-audit --no-fund ...`
+
+It removes the temporary project before returning the report.
+
+## Report Workflow
+
+1. Run the deterministic script from the repository root.
+2. Return or surface the exact formatted report produced by the script.
+3. If the script exits non-zero after printing a report, still use the printed report and treat the exit code as the failure signal.
+
+Do not rewrite, summarize, or recompute the generated report.
+
+Report delivery is outside this skill.
+
+## Debugging
+
+- Use `--json` to print structured report data.
+- Use `--timestamp <iso-utc>` only for deterministic verification.
+- Stop early only for environment-level problems, such as missing `npm`.