This repo contains reusable GitHub composite actions for the Async organization. Keep each action small, explicit, and callable from generated workflows.
- Do not add secrets to examples, logs, fixtures, or README snippets.
- Prefer Node.js ESM helper scripts under
scripts/; keeppackage.jsonwith"type": "module". - Keep action behavior step-level. Workflow triggers, job matrices, permissions,
environments, concurrency, and secret mapping belong to the caller workflow,
normally generated by
@async/pipeline. - Publishing and release behavior should use standard CLIs (
npmandgh). Do not add a bundled GitHub API client unless a CLI cannot express the job. - Composite actions must expose all privileged inputs explicitly. Do not infer write access or token names.
- Executable changes are owner-only: external reports may come through issues
or advisories, but maintainers write action metadata, helper scripts, and
package metadata before
@async/pipelinepins a reviewed commit SHA. - When editing action metadata, run
npm run check.