karthiek390/CICD Stats Watcher

GitHub Action for tracking self-hosted runner CI stats.

Trust Signals

name	description	required	default
mode	Action mode: start, track, or finalize.	yes	—
job-id	Logical job identifier for tracked-step decisions.	no	—
step-name	Named GitHub Actions step to track.	no	—
stats-dir	Optional explicit stats directory. If omitted, the action resolves a default path.	no	—
metrics	Comma-separated metric names such as storage,docker,cpu,memory,inode.	no	—
command	Command to execute when mode=track.	no	—
working-directory	Optional working directory used when mode=track.	no	—
manifest-path	Optional path to the watcher manifest for GitHub Actions step tracking.	no	—
inline-config	Reserved for future inline configuration payloads.	no	—
run-server	Reserved flag for future live server startup behavior.	no	false

name	description
mode	Validated action mode.
resolved-stats-dir	Resolved stats directory for this run.
report-path	Expected report path for the run artifact.
artifact-path	Artifact-ready directory path for this run.
metrics	Normalized metrics input.
manifest-path	Manifest path that will be used by later mode implementations.
meta-path	Path to the generated meta.json file.
state-path	Path to the watcher runtime state file.
stage-file	Path to the stage file used by the watcher runtime.
watcher-pid	PID of the watcher background process when mode=start.
server-pid	PID of the live server background process when mode=start and run-server=true.
exit-code	Exit code returned by the tracked command when mode=track.
finalized	Whether finalize mode found watcher state and completed its cleanup path.
generated-report	Whether finalize mode generated report.html successfully.