Skip to content

chore: add dev ergonomics scripts and release guardrails#2

Merged
a-essawy merged 1 commit into
mainfrom
chore/dev-ergonomics-and-release-guardrails
Apr 13, 2026
Merged

chore: add dev ergonomics scripts and release guardrails#2
a-essawy merged 1 commit into
mainfrom
chore/dev-ergonomics-and-release-guardrails

Conversation

@a-essawy
Copy link
Copy Markdown
Contributor

Summary

Improves DX for agents + devs working across the rendobar/cli ↔ rendobar/rendobar boundary, and adds automated guardrails so releases cannot silently fail.

Dev ergonomics

  • `pnpm dev:sdk-local` — pnpm-links `@rendobar/sdk` from `../rendobar/packages/sdk` (configurable via `RENDOBAR_MONOREPO` env). Builds the SDK first, then links globally.
  • `pnpm dev:sdk-npm` — restores the npm-published version from package.json.
  • Pre-commit guard (`scripts/check-no-linked-sdk.mjs`) — rejects commits while SDK is dev-linked. Distinguishes normal pnpm store symlinks (contain `/.pnpm/`) from dev-link targets.
  • AGENTS.md — dev loop, release flow, cross-repo workflow, guardrails table, agent dos/don'ts.

Release guardrails

  • Watchdog (`watchdog.yml`, runs every 6h) — scans commits since last `v*` tag. If any are `feat:`/`fix:`/`perf:` and no release-please PR is open, opens an issue. Catches silent skips from non-conventional commits or workflow failures.
  • Drift check (`drift-check.yml`, runs daily) — compares `@rendobar/sdk` in package.json vs npm registry latest. Opens an issue when drifted. Backs up Renovate if configured, or stands alone if not.
  • Both scripts are idempotent: they check for an existing open issue before opening a new one.
  • Branch protection on `main` already live via GH API: requires `test` + `lint` checks, linear history, no force push. No subscription needed — public repos get this free.

Test plan

  • `pnpm typecheck` — green
  • `pnpm test` — 48/48 passing
  • `node scripts/check-no-linked-sdk.mjs` — passes on normal pnpm install
  • Watchdog + drift-check scripts validated syntactically (not scheduled-run yet — will fire on schedule)

Notes

  • No changes to `cli-binaries.yml` or release flow — they already work end-to-end from the v1.0.0 ship.
  • Bypass for pre-commit (emergency only): `git commit --no-verify` or `lefthook run pre-commit --force`.

Developer experience:
- Add pnpm dev:sdk-local / dev:sdk-npm scripts for cross-repo SDK development
- Add pre-commit guard rejecting commits while @rendobar/sdk is pnpm-linked
- Write AGENTS.md with full dev loop, release flow, and cross-repo workflow

Release guardrails:
- Add watchdog workflow (every 6h) to detect silent release skips
- Add drift-check workflow (daily) to catch stale @rendobar/sdk dep vs npm
- Both open GH issues automatically when they detect drift

All workflows use pinned action SHAs. Branch protection on main already
enabled via GH API (required checks: test, lint; linear history; no force push).
@a-essawy a-essawy merged commit cac968e into main Apr 13, 2026
2 checks passed
@a-essawy a-essawy deleted the chore/dev-ergonomics-and-release-guardrails branch April 13, 2026 05:54
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.

1 participant