Skip to content

docs(agents): sync local CI guidance#5960

Merged
killagu merged 6 commits into
nextfrom
agent/egg-doc/ef7e2d11
Jun 28, 2026
Merged

docs(agents): sync local CI guidance#5960
killagu merged 6 commits into
nextfrom
agent/egg-doc/ef7e2d11

Conversation

@killagu

@killagu killagu commented Jun 2, 2026

Copy link
Copy Markdown
Contributor

Summary

  • Align GitHub Copilot instructions with the canonical AGENTS.md Local CI guidance: Node/pnpm versions, pnpm run ci meaning, and avoiding builds immediately before unit tests.
  • Add tegg-specific Claude guidance for duplicate proto failures after local builds.
  • Add a durable wiki workflow page for local CI artifact cleanup and link it from the wiki index/log.

Validation

  • pnpm run fmtcheck passed.
  • git diff --check passed.
  • Pre-commit hook was bypassed for the commit because oxlint --type-aware --fix fails on a markdown-only staged set with No files found to lint; full repo formatting passed before commit.

Summary by CodeRabbit

  • Documentation
    • Updated contribution guidance: Node.js minimum bumped to >= 22.18.0, added an explicit lint step, and refined the recommended build vs. test sequence.
    • Improved CI wording and local validation workflow, emphasizing tests from clean sources and building only when validating build outputs or generated artifacts.
    • Added/expanded local CI troubleshooting for duplicate proto errors via stale artifact cleanup guidance, and recorded the change in the release log.
    • Refreshed local command examples and added guidance to keep local tool versions aligned with repo settings.

Copilot AI review requested due to automatic review settings June 2, 2026 18:05
@coderabbitai

coderabbitai Bot commented Jun 2, 2026

Copy link
Copy Markdown
Contributor

Review Change Stack

Caution

Review failed

The pull request is closed.

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: bf5bc0ec-4901-4148-93ec-90dc849f48d7

📥 Commits

Reviewing files that changed from the base of the PR and between 2abbb5d and 1c3fbfc.

📒 Files selected for processing (1)
  • AGENTS.md

📝 Walkthrough

Walkthrough

Documentation-only updates revise Eggjs contribution and local CI guidance: Node.js minimum version increases to 22.18.0, validation order changes to lint → clean-tree tests → conditional build, and stale dist/ cleanup is added for duplicate proto failures.

Changes

Local CI Validation Workflow Documentation

Layer / File(s) Summary
Node.js version and bootstrap
.github/copilot-instructions.md
Node.js minimum version is raised to >= 22.18.0, and fresh-clone bootstrap guidance adds an explicit lint step before build and test steps.
CI command and development workflow
.github/copilot-instructions.md
pnpm run ci is described as tests with coverage only, and development guidance shifts to working from the source tree first.
Validation steps and troubleshooting
.github/copilot-instructions.md
The validation checklist is reordered to lint, clean-tree tests, and conditional build, with troubleshooting added for stale dist/ artifacts causing duplicate proto failures.
Agent command examples
AGENTS.md
Core command examples switch to ut-based equivalents, and version-alignment guidance expands to include utoo.
Distributed docs and local CI guide
tegg/CLAUDE.md, wiki/index.md, wiki/log.md, wiki/workflows/local-ci.md
TeGG guidance, wiki index, changelog, and a new local CI page document clean-source testing and stale artifact cleanup steps.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

Possibly related PRs

  • eggjs/egg#5509: Direct overlap in AGENTS.md repository guidance updates and command example changes.
  • eggjs/egg#5830: Similar local CI workflow documentation and ut/ut run command migration.
  • eggjs/egg#5958: Overlapping guidance for clean-source testing and stale dist/ cleanup around duplicate proto failures.

Suggested reviewers

  • fengmk2
  • elrrrrrrr

Poem

🐰 I hopped through lint, then tests ran clean,
Old dist/ crumbs vanished from the scene.
Build when needed, not before the cheer,
The burrow’s CI is bright and clear.

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title accurately summarizes the main doc-only change: syncing local CI guidance across agents and wiki docs.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch agent/egg-doc/ef7e2d11

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@gemini-code-assist gemini-code-assist Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

This pull request updates the repository's documentation—including Copilot instructions, CLAUDE.md, and wiki pages—to guide developers to run unit tests from clean sources rather than immediately after a build. This prevents stale build artifacts in dist/ directories from causing duplicate proto errors during tegg test execution. It also updates the required Node.js and pnpm versions. The review feedback correctly points out a typo in two files where ut run ci was referenced instead of pnpm run ci, offering clear, actionable code suggestions to resolve the issue.

Important

The consumer version of Gemini Code Assist on GitHub is being sunset. Starting June 18, 2026, new organization installations will be blocked, and all code review activity will officially cease on July 17, 2026.
For more details on the timeline and next steps, please review the Help Documentation.

Comment thread .github/copilot-instructions.md Outdated
Comment thread wiki/workflows/local-ci.md Outdated
@cloudflare-workers-and-pages

cloudflare-workers-and-pages Bot commented Jun 2, 2026

Copy link
Copy Markdown

Deploying egg with  Cloudflare Pages  Cloudflare Pages

Latest commit: 2abbb5d
Status: ✅  Deploy successful!
Preview URL: https://f6342260.egg-cci.pages.dev
Branch Preview URL: https://agent-egg-doc-ef7e2d11.egg-cci.pages.dev

View logs

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR syncs contributor/agent-facing documentation around “local CI” to match the canonical guidance in AGENTS.md, and records that guidance durably in the repo wiki—especially the requirement to run unit tests from clean sources to avoid tegg duplicate proto failures caused by stale build artifacts.

Changes:

  • Added a new wiki workflow page documenting Local CI expectations and stale dist/ artifact cleanup for tegg.
  • Linked the new workflow page from the wiki index and recorded the update in the wiki log.
  • Updated agent instructions (.github/copilot-instructions.md and tegg/CLAUDE.md) to reflect current Node/pnpm requirements and the fact that CI tests run without building first.

Reviewed changes

Copilot reviewed 5 out of 5 changed files in this pull request and generated no comments.

Show a summary per file
File Description
wiki/workflows/local-ci.md New workflow page documenting Local CI parity with GitHub Actions and stale dist/ cleanup for tegg.
wiki/log.md Adds a dated log entry recording the new Local CI workflow documentation.
wiki/index.md Links the new Local CI workflow page from the Workflows section.
tegg/CLAUDE.md Adds tegg-specific guidance about avoiding builds immediately before tests and handling duplicate proto via cleanup.
.github/copilot-instructions.md Updates Node/pnpm version guidance and clarifies that CI tests run without a preceding build; adjusts local validation sequencing accordingly.

@cloudflare-workers-and-pages

cloudflare-workers-and-pages Bot commented Jun 2, 2026

Copy link
Copy Markdown

Deploying egg-v3 with  Cloudflare Pages  Cloudflare Pages

Latest commit: 1c3fbfc
Status:⚡️  Build in progress...

View logs

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In @.github/copilot-instructions.md:
- Around line 28-29: Change the inconsistent wording that marks linting as
optional: update the “Run linting (optional but recommended) - takes ~2 seconds”
line to state linting is required and use the canonical instruction "Run pnpm
run lint to check code quality across all packages." Then make the same wording
consistent with the validation steps around the later section (the block that
currently describes required validation) so both places use the required
phrasing and the exact command "pnpm run lint".
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 52b399f7-0efa-48fa-ad0c-13a90d19952a

📥 Commits

Reviewing files that changed from the base of the PR and between 7e6be0e and 0a03cc0.

📒 Files selected for processing (5)
  • .github/copilot-instructions.md
  • tegg/CLAUDE.md
  • wiki/index.md
  • wiki/log.md
  • wiki/workflows/local-ci.md

Comment thread .github/copilot-instructions.md Outdated
Copilot AI review requested due to automatic review settings June 2, 2026 18:13

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Copilot reviewed 5 out of 5 changed files in this pull request and generated no new comments.

Copilot AI review requested due to automatic review settings June 28, 2026 11:23

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot was unable to review this pull request because the user who requested the review has reached their quota limit.

The repository migrated install/run tooling to utoo (ut) in #5830, but
the Core Commands section still documented pnpm. Align it with package.json
scripts and CI (ut install --from pnpm, ut run build/test/lint/typecheck),
and note that pnpm-workspace.yaml still defines the workspace.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@killagu killagu merged commit 3d08163 into next Jun 28, 2026
6 of 9 checks passed
@killagu killagu deleted the agent/egg-doc/ef7e2d11 branch June 28, 2026 11:33
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.

2 participants