mirror of https://github.com/meteor/meteor.git synced 2026-05-02 03:01:46 -04:00

Files

Harry Adel cec38c47a2 Docs: guide LLMs to use test-in-console/run.sh for package tests

AGENTS.md listed `./meteor test-packages` but not the headless
alternative. That command starts a web server and waits for a browser,
producing no terminal output, which causes LLM agents to hang.

Add `./packages/test-in-console/run.sh` alongside the existing
test-packages command in AGENTS.md with a note explaining the
difference. Also add package name examples and the PUPPETEER_DOWNLOAD_PATH
hint to the testing skill.

2026-03-12 21:12:51 +02:00

2.6 KiB

Raw Permalink Blame History

Meteor

Full-stack JavaScript platform for modern web and mobile applications.

Commands

./meteor run                                 # Run from source
./meteor create my-app                       # Create app
./meteor self-test                           # CLI tests
./meteor test-packages ./packages/<name>     # Package tests (browser UI at localhost:3000)
./packages/test-in-console/run.sh "<name>"   # Package tests (terminal output via Puppeteer)
npm run test:unit                            # Unit tests (Jest)
npm run test:e2e                             # E2E tests (Jest + Playwright)

Note: ./meteor test-packages starts a web server and waits for a browser — it produces no terminal output. For automated/headless runs, use ./packages/test-in-console/run.sh "<package>" instead, which runs the same tests via Puppeteer and prints pass/fail results to stdout.

Structure

packages/          # Core Meteor packages (~100+)
tools/             # CLI & build system (Isobuild)
npm-packages/      # Published @meteorjs/* packages
scripts/           # Build & release automation

Key Entry Points

Task	Location
CLI commands	`tools/cli/commands.js`
Build system	`tools/isobuild/bundler.js`
Package lookup	`packages/<name>/package.js`
Modern bundler	`packages/rspack/`, `packages/tools-core/`

Skills

Load these for detailed context on specific topics:

Skill	When to use
codebase	Build system, CLI, isobuild, tools/ directory
conventions	Writing packages, CLI commands, code patterns
testing	Writing tests, debugging failures, test infrastructure
packages	Finding packages by feature, understanding dependencies
modern-tools	tools-core utilities, rspack, modern integrations
ai-context	Creating, updating, or maintaining AI documentation files

Package Domains

Category	Packages
Auth	`accounts-base`, `accounts-password`, `accounts-oauth`
Database	`mongo`, `minimongo`, `ddp-server`, `ddp-client`
Build	`babel-compiler`, `ecmascript`, `typescript`, `rspack`
Web	`webapp`, `autoupdate`, `reload`
Reactivity	`tracker`, `reactive-var`, `reactive-dict`

Notes

docs/ and guide/ are the public documentation website, not agent context
v3-docs/ contains Meteor 3.x documentation
See DEVELOPMENT.md for contributor setup

2.6 KiB Raw Permalink Blame History