Skip to content

docs(agents): sync local CI guidance#5960

Open
killagu wants to merge 4 commits into
nextfrom
agent/egg-doc/ef7e2d11
Open

docs(agents): sync local CI guidance#5960
killagu wants to merge 4 commits into
nextfrom
agent/egg-doc/ef7e2d11

Conversation

@killagu
Copy link
Copy Markdown
Contributor

@killagu killagu commented Jun 2, 2026

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 workflow: Node.js minimum bumped to >=22.18.0 and bootstrap now includes an explicit lint step.
    • Clarified CI wording to mean “tests with coverage” and recommend building less eagerly (work from source first).
    • Prescribed validation order: lint → tests from a clean tree → build → docs site.
    • Added local CI guidance, troubleshooting for stale build artifacts causing duplicate proto failures, and updated release log.

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

coderabbitai Bot commented Jun 2, 2026

Review Change Stack

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: b659fc07-8dca-4260-b1f9-c072835a653a

📥 Commits

Reviewing files that changed from the base of the PR and between d3c6ace and 4331daa.

📒 Files selected for processing (2)
  • .github/copilot-instructions.md
  • wiki/workflows/local-ci.md
✅ Files skipped from review due to trivial changes (1)
  • .github/copilot-instructions.md
🚧 Files skipped from review as they are similar to previous changes (1)
  • wiki/workflows/local-ci.md

📝 Walkthrough

Walkthrough

Documentation-only PR updating Eggjs contribution and testing guidance: Node.js version bumped to 22.18.0, CI validation workflow reordered to lint → clean-tree tests → conditional build, and new troubleshooting for duplicate proto errors caused by stale dist/ artifacts. Changes span copilot instructions, tegg docs, and a new local CI guide.

Changes

Local CI Validation Workflow Documentation

Layer / File(s) Summary
Node.js version and bootstrap requirements
.github/copilot-instructions.md
Node.js minimum version raised to >= 22.18.0; fresh-clone bootstrap sequence adjusted to include an explicit pnpm run lint step and clarified test/build ordering.
CI command and development workflow
.github/copilot-instructions.md
pnpm run ci description clarified to "Run tests with coverage" only; development guidance changed to "work from the source tree first" and build only when needed for validation.
Validation steps and artifact cleanup troubleshooting
.github/copilot-instructions.md
Validation checklist reordered to run lint → clean-tree tests → conditional build; troubleshooting added for duplicate proto failures caused by stale dist/ artifacts with cleanup guidance.
Distributed documentation and new local CI guide
tegg/CLAUDE.md, wiki/index.md, wiki/log.md, wiki/workflows/local-ci.md
tegg CLAUDE.md, wiki index, and changelog updated; new wiki/workflows/local-ci.md added to document matching local validation to CI, clean-source expectations, and stale dist/ cleanup steps.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

Possibly related PRs

  • eggjs/egg#5958: Related local CI/stale-dist/ artifact cleanup guidance referenced across AGENTS.md and wiki updates.
  • eggjs/egg#5891: Prior docs/workflow changes that overlap with local CI/testing guidance and wiki scaffolding.
  • eggjs/egg#5509: Earlier repository guidelines and AGENTS.md updates that introduced cleanup guidance referenced here.

Suggested reviewers

  • fengmk2

Poem

🐰 I nibbled stale builds in a hidden mist,
Cleared dist/ crumbs so protos don't twist,
Lint first, test clean, then build if it's due,
Node 22.18 hops the path anew,
Local CI hums — the burrow's refreshed and true.

🚥 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 clearly summarizes the main change: syncing local CI guidance across multiple documentation files (agents, tegg, wiki) as described in the objectives.
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.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ 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 and usage tips.

Copy link
Copy Markdown
Contributor

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

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
Copy link
Copy Markdown

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

Deploying egg with  Cloudflare Pages  Cloudflare Pages

Latest commit: 4331daa
Status: ✅  Deploy successful!
Preview URL: https://807872f2.egg-cci.pages.dev
Branch Preview URL: https://agent-egg-doc-ef7e2d11.egg-cci.pages.dev

View logs

Copy link
Copy Markdown
Contributor

Copilot AI left a comment

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
Copy link
Copy Markdown

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

Deploying egg-v3 with  Cloudflare Pages  Cloudflare Pages

Latest commit: 4331daa
Status: ✅  Deploy successful!
Preview URL: https://feaa2303.egg-v3.pages.dev
Branch Preview URL: https://agent-egg-doc-ef7e2d11.egg-v3.pages.dev

View logs

Copy link
Copy Markdown
Contributor

@coderabbitai coderabbitai Bot left a comment

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
Copy link
Copy Markdown
Contributor

Copilot AI left a comment

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.

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