Test Guide: Card #9998

forge-xray | script | ralph/forge-xray-phase-1-t1-create-opt-forge-scripts-xray-forge-xra-20260406_202904 | 2026-04-06 21:39:13

What Was Built

A new script called forge-xray.sh was created to dispatch various diagnostic steps for Forge X-Ray. It accepts positional arguments for different steps and optional flags for date and quiet mode.

What This Unlocks

You can now run diagnostic steps for Forge X-Ray from the command line using the forge-xray.sh script. This enables you to automate and schedule these diagnostics, and also provides a centralized entry point for running them.

How To Verify

Follow each step. In the dashboard /verify tab, mark each as passed or failed, then submit your verdict.

Step 1. Run the forge-xray.sh script with the --help flag to see the usage and available steps.

forge-xray.sh --help

Expected: You should see a usage message with the available steps, options, and examples.

Step 2. Run the forge-xray.sh script with the snapshot step to capture the current system state.

forge-xray.sh snapshot

Expected: You should see a message indicating that the snapshot has been captured, and a new directory should be created in /opt/forge/exports/forge-xray/latest.

Step 3. Run the forge-xray.sh script with the --date flag to set a custom date context.

forge-xray.sh --date 2026-04-01 diff

Expected: You should see a message indicating that the diff has been run with the specified date context, and the output should reflect the differences between the two snapshots.

QA Gate Results

No QA gate log found.

Diff Summary

 exports/forge-xray/.gitkeep        |   0
 exports/forge-xray/latest/.gitkeep |   0
 scripts/xray/forge-xray.sh         | 152 +++++++++++++++++++++++++++++++++++++
 3 files changed, 152 insertions(+)