Skip to content

build: add a Makefile exposing the verify/check/ci gate triad (ADR-0044) - #121

Merged
bketelsen merged 1 commit into
mainfrom
cockpit/worker-91c0e5ffb0984d9d
Aug 25, 2026
Merged

build: add a Makefile exposing the verify/check/ci gate triad (ADR-0044)#121
bketelsen merged 1 commit into
mainfrom
cockpit/worker-91c0e5ffb0984d9d

Conversation

@bketelsen

Copy link
Copy Markdown
Contributor

Summary

Resolves #120.

  • Adds a root Makefile with verify, check, and ci targets (each wraps the like-named npm script), .PHONY: verify check ci, SHELL := /usr/bin/env bash. No other targets — the npm scripts remain the implementation.
  • .github/workflows/ci.yml: the docs-gate job's gate step now runs make ci instead of npm run check (one line change; npm ci, SHA pins, permissions: {}, persist-credentials: false, and the fleet-conventions/scaffold-e2e jobs are unchanged).
  • AGENTS.md "Code conventions": documents make verify/make check/make ci as the entry points CI, workers, reviewers, and the organization gate invoke (ADR-0044), wrapping the like-named npm scripts.
  • .agents/skills/frostyard-onboard-repo/SKILL.md step 2 audit bullet: the canonical-surfaces bullet now also names a root Makefile with verify/check/ci targets (ADR-0044).

This lands ADR-0044, which core#118's round-2 review incident cited (a reviewer ran make verify here and got No rule to make target 'verify').

Risk tier

Touches .github/workflows/**, which policies/agent-governance.json's workflow-and-permissions boundary marks review-required at minimum_risk_tier: high. Declaring this PR at that tier — a human needs to mark it ready for review.

Verification

  • grep -cE '^(verify|check|ci):' Makefile3
  • grep -c 'run: make ci' .github/workflows/ci.yml1
  • grep -c 'run: npm run check$' .github/workflows/ci.yml0
  • node scripts/check-docs.mjs → green (ok docs_index_coverage, ok link_integrity, ok symlink_resolution; 58 docs, 429 links, 10 symlinks)
  • make verify on a clean checkout (after npm ci): check:docs, check:organization, check:scripts all green; npm test is 24/26 passing — the 2 failures (sync-skills-containment.test.mjs) are rsync: command not found in this local sandbox only (no rsync binary present here), not caused by this change; unrelated to the Makefile/CI/docs edits in this PR. git status --porcelain after the run shows only this PR's own diff — no side effects from running verify.
  • The PR's own docs-gate GitHub Actions job will confirm make ci runs and is green on this head; fleet-conventions and scaffold-e2e are untouched by this change and expected to stay green.

Resolves #120. Adds a root Makefile wrapping the existing npm scripts
(verify, check, ci) so make verify/check/ci work at the repository
root, the only entry points CI, workers, reviewers, and the
organization gate invoke per ADR-0044. Points docs-gate's CI step at
make ci and documents the wrapper in AGENTS.md and the onboard-repo
skill's audit bullet.
@bketelsen
bketelsen marked this pull request as ready for review August 25, 2026 00:36
@bketelsen
bketelsen added this pull request to the merge queue Aug 25, 2026
Merged via the queue into main with commit ead897e Aug 25, 2026
3 checks passed
@bketelsen
bketelsen deleted the cockpit/worker-91c0e5ffb0984d9d branch August 25, 2026 00:39
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

build: add a Makefile exposing the verify/check/ci gate triad over the npm scripts (ADR-0044)

1 participant