Skip to content

chore: add agent skills (pr-quality-gate, portal-ponder-release) + Portal coverage tooling#7

Merged
mo4islona merged 1 commit into
mainfrom
chore/agent-skills
Jul 3, 2026
Merged

chore: add agent skills (pr-quality-gate, portal-ponder-release) + Portal coverage tooling#7
mo4islona merged 1 commit into
mainfrom
chore/agent-skills

Conversation

@mo4islona

@mo4islona mo4islona commented Jul 3, 2026

Copy link
Copy Markdown
Collaborator

Adds two agent skills under .agents/skills/ plus the Portal-layer coverage tooling the pr-quality-gate skill drives — so the skill and its tooling ship together and this PR is self-contained.

Skills

pr-quality-gate

Runs before creating a PR: verifies changed Portal code has co-located tests, runs the suite the repo's way (scripts/sync-upstream.sh <ver> --test, grafted onto a ponder checkout), generates a Portal-layer coverage diff for the PR body, and enforces the Biome lint/code-style gate.

portal-ponder-release

End-to-end release procedure for @subsquid/ponder (the Portal fork), versioned <ponder-version>-sqd.<rev>, published via release.yml + npm Trusted Publishing. Includes release-template.md for the (now required) GitHub release notes.

Coverage tooling (supports the pr-quality-gate coverage guard)

  • portal/vite.portal.config.ts — v8 coverage block scoped to the Portal source; inert unless --coverage is passed (also converts the file to single quotes per Biome).
  • scripts/sync-upstream.sh--coverage mode: installs the matching v8 provider (standalone, since the renamed core breaks a workspace-wide pnpm add) and emits portal-coverage/coverage-summary.json.
  • scripts/coverage-diff.mjs — renders a base-vs-head Portal coverage table for the PR body (head-only absolute fallback when the base branch predates the tooling).

Verified end-to-end: a fresh graft reports 90.4% stmts / 77.1% branch / 94.0% funcs, and the diff renderer produces the table + a decrease warning.

🤖 Generated with Claude Code

@mo4islona mo4islona force-pushed the chore/agent-skills branch from 93689eb to e9e65b0 Compare July 3, 2026 11:45
mo4islona added a commit that referenced this pull request Jul 3, 2026
Makes PR #7 self-contained: the coverage-guard step now ships with its tooling.
- portal/vite.portal.config.ts: v8 coverage block scoped to the Portal source
  (inert unless --coverage; also converts the file to single quotes per Biome)
- scripts/sync-upstream.sh: --coverage mode (installs the matching v8 provider,
  emits portal-coverage/coverage-summary.json)
- scripts/coverage-diff.mjs: renders a base-vs-head Portal coverage table for a
  PR body (head-only fallback when base predates the tooling)

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@mo4islona mo4islona changed the title chore: add pr-quality-gate and portal-ponder-release agent skills chore: add agent skills (pr-quality-gate, portal-ponder-release) + Portal coverage tooling Jul 3, 2026
@mo4islona mo4islona force-pushed the chore/agent-skills branch from c3774b6 to b8e1923 Compare July 3, 2026 13:00
Two agent skills under .agents/skills/, plus the Portal-layer coverage tooling
the pr-quality-gate skill drives (so the skill and its tooling ship together).

Skills:
- pr-quality-gate: pre-PR gate — verifies changed Portal code has co-located
  tests, runs the suite via scripts/sync-upstream.sh <ver> --test (grafted ponder
  tree), generates a Portal-layer coverage diff for the PR body, and enforces the
  Biome lint/code-style gate.
- portal-ponder-release: end-to-end release for @subsquid/ponder (the Portal
  fork), versioned <ponder-version>-sqd.<rev>, via release.yml + npm Trusted
  Publishing; includes release-template.md for the required GitHub release notes.

Coverage tooling (supports the pr-quality-gate coverage guard):
- portal/vite.portal.config.ts: v8 coverage block scoped to the Portal source
  (inert unless --coverage; also converts the file to single quotes per Biome).
- scripts/sync-upstream.sh: --coverage mode (installs the matching v8 provider,
  emits portal-coverage/coverage-summary.json).
- scripts/coverage-diff.mjs: renders a base-vs-head Portal coverage table for a
  PR body (head-only fallback when base predates the tooling).

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@mo4islona mo4islona force-pushed the chore/agent-skills branch from b8e1923 to 7445611 Compare July 3, 2026 13:14
@mo4islona mo4islona merged commit 28dcb79 into main Jul 3, 2026
6 of 8 checks passed
@mo4islona mo4islona deleted the chore/agent-skills branch July 3, 2026 13:15
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