SuperAPI AI Directory

validate-release-green

General & other

View repository

Updated 10-15 21:10

About this skill

Validate Release-Green

Read ../_shared/base-green.md before interpreting remote status or attributing a failure. Resolve the current base and candidate SHA; use an isolated worktree. The observer validates that working tree, not an abstract branch name.

Select and execute the actual profile

Inspect scripts/quality/validate-release-green.mjs, its npm entrypoint and the candidate's workflows before choosing flags. On candidates that provide them:

  • npm run check:release-green -- --quick: partial fast diagnosis.
  • npm run check:release-green -- --full-ci --with-build --hermetic --json: the observer's broader static/test/package profile; this is still not a promise of parity with every workflow lane.

The versioned static gate manifest, if present, describes static scan membership, not all observer or admission jobs. Report unmodeled coverage explicitly.

Build in a worktree with physical dependencies, never an external node_modules symlink. Preserve stdout/stderr, process receipts and the validator's own exit. Read the report even when the outer job is green. Missing, contradictory, stale, cancelled or timed-out evidence cannot establish PASS.

Interpret and compare

HARD is the observer's blocking classification; DRIFT is its diagnostic bucket. Neither class alone proves causality. Compare the same requirement on the exact base before calling a defect contributor-introduced. A ratchet classified as advisory locally can still block in the applicable CI workflow.

A green local profile means only that profile passed. Record remaining lanes, including relevant Node/Vitest suites, coverage, security, build, package/boot and external checks. Do not stamp merge-ready or pre-greened based on a focused run, a draft skip, a closed incident or an old head SHA.

For machine reports, use scripts/ci/release-green-result.mjs when available on the candidate. It checks the observed exit, exact SHA and event/profile; supply the values from the run rather than inventing an exit code. The report verifier does not establish that omitted workflow requirements ran.

Handoff

Report SHA, profile, command, versions, raw log/artifact locations, hard failures, drift, incomplete lanes and causal confidence. Re-query live refs before using the result for a later decision. A full-current observer PASS may resolve its own incident only through the authorized workflow; it cannot close unrelated requirements or authorize a merge, baseline change, release or deployment.

This skill is diagnostic. Implement fixes only when the user requested changes. Keep thresholds, assertions, contributor credit and action boundaries intact.