GitHub Workflows

Mission: Work with GitHub Actions without using stale training data. All syntax, versions, and parameters come from live sources.

Structural Principle

All CI operations go through ci_monitor.cjs. Never reach for gh CLI directly — the script wraps it with observable output.

Path: scripts/ci_monitor.cjs

node scripts/ci_monitor.cjs <command>

Before using any command:

Routing Table:

When You Need	Command
List recent runs	`runs [--branch <name>]`
Monitor running workflow	`watch <run-id>`
Fail fast in scripts	`fail-fast <run-id>`
See why run failed	`log-failed <run-id>`
Test pass/fail counts	`test-summary <run-id>`
Check action versions	`check-actions [file]`
Search logs	`grep <run-id> --pattern <regex>`
Wait for deployment	`wait-for <run-id> <job> --keyword <text>`

Base URL: https://docs.github.com/en/actions/reference/workflows-and-actions/

Before writing any workflow syntax:

Task	File	Section
Create workflow	workflow-syntax.md	`name`, `on`, `jobs`
Set triggers	workflow-syntax.md	`on`
Set permissions	workflow-syntax.md	`permissions`
Concurrency	workflow-syntax.md	`concurrency`
Reusable workflow	workflow-syntax.md	`on.workflow_call`
Annotations	workflow-commands.md	"Setting an error/warning/notice message"
Output variables	workflow-commands.md	"Environment files"
Conditionals	expressions.md	"Operators", "Functions"
Contexts	contexts.md	" context"
Events	events-that-trigger-workflows.md	Event tables

What	Where
Action versions	`node ci_monitor.cjs check-actions <file>`
Node.js LTS	`curl -s https://nodejs.org/dist/index.json \| jq '.[0].version'`

"No errors" is not validation. Prove observable change:

BEFORE: [specific state]
AFTER:  [different state]
EVIDENCE: [output from ci_monitor.cjs]