Implement automated Copilot Setup Steps with GitHub Actions workflows and scripts

[Copilot]

This PR implements comprehensive automated setup steps for the Onchain Test Kit project, addressing the "Copilot Setup Steps" requirement by providing GitHub Actions workflows, setup scripts, and npm command integration.

What's New

🔄 GitHub Actions Workflows

• .github/workflows/copilot-setup.yml - Main CI/CD workflow that automatically runs all essential setup commands in the correct order on push/PR
• .github/workflows/development.yml - Development-focused workflow with separate jobs for linting, building, testing, and wallet preparation
• .github/workflows/manual-setup-test.yml - Manual testing workflow with configurable options for testing different setup scenarios

🛠️ Automated Setup Scripts

• scripts/quick-setup.sh - Executes all essential commands from .github/copilot-instructions.md in the correct sequence with colored output and proper error handling
• scripts/validate-setup.sh - Comprehensive environment validation including Node.js version checking, step-by-step validation, and detailed reporting

📦 NPM Command Integration

Added convenient npm commands for easy access:

npm run copilot:setup          # Quick automated setup
npm run copilot:validate       # Full validation
npm run copilot:full-setup     # Combined setup and validation

Implementation Details

Essential Commands Automated

Based on the guidelines in .github/copilot-instructions.md, the following essential commands are automated in the correct order:

1. npm install (dependencies first)
2. npm run build (required before testing)
3. npm run lint (code quality checks)
4. npm run format (with graceful handling of extension file warnings)
5. npm run test (validation)
6. npm run prepare-metamask (works correctly)
7. npm run prepare-coinbase (gracefully handles known broken downloads)
8. npm run prepare-phantom (gracefully handles known broken downloads)

Robust Error Handling

• Node.js version validation ensures >=14.0.0 requirement is met
• Known issue handling for broken Coinbase/Phantom wallet preparations with clear warnings
• Graceful continuation where appropriate with informative messages
• Clear success/failure indicators with colored output for better visibility

CI/CD Integration

• Workflows trigger on push to main/develop/copilot branches and PRs
• Uses Node.js 18 with npm caching for performance
• Parallel job execution where safe
• Test artifact upload on failures for debugging

Documentation Updates

Updated README.md

Added a comprehensive "Copilot Setup Steps" section with:

• Quick reference commands for developers
• Manual setup instructions with the essential command sequence
• GitHub Actions integration details
• Links to AI agent instruction files

New Documentation

• docs/copilot-setup-guide.md - Complete implementation guide with technical details, usage examples, and future enhancement opportunities
• .github/ISSUE_TEMPLATE/setup.yml - Structured issue template for setup-related problems

Benefits

For Developers

• One-command setup with npm run copilot:setup
• Comprehensive validation with detailed feedback
• Clear error messages with resolution guidance

For AI Coding Agents

• Automated adherence to instruction file guidelines
• Consistent environment setup across different agents
• Reference to existing instruction files (AGENTS.md, CLAUDE.md, GEMINI.md)

For CI/CD

• Automated validation on every push and PR
• Early detection of setup issues
• Consistent build environment across all workflows

Validation

All existing functionality is preserved:

• ✅ Build compiles without errors (TypeScript strict mode)
• ✅ Linting passes (27 files checked with Biome)
• ✅ Tests pass (3 tests in ~750ms)
• ✅ Scripts are executable and functional
• ✅ NPM commands work correctly

The implementation follows the exact command sequence from .github/copilot-instructions.md and integrates seamlessly with the existing development workflow while providing robust automation for the essential setup steps.

Original prompt

</issue_description>name: "Copilot Setup Steps"# Automatically run the set...<issue_title>copilot-setup-steps</issue_title>
<issue_description>/.github/copilot-instructions.md
/.github/instructions/**/*.instructions.md
**/AGENTS.md
/CLAUDE.md
/GEMINI.md</issue_description>

---

✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.

[joe10832]

@copilot

[Copilot]

@Copilot-setup-steps ## Pull Request Overview

This PR implements comprehensive automated setup steps for the Onchain Test Kit project, addressing the GitHub Copilot setup requirements by providing GitHub Actions workflows, setup scripts, and npm command integration. The implementation automates the essential command sequence from .github/copilot-instructions.md while handling known issues gracefully.

Key Changes:

• Added GitHub Actions workflows for automated CI/CD setup validation and development workflow checks
• Created shell scripts for quick setup and comprehensive validation with proper error handling
• Integrated new npm commands for easy access to setup automation

Reviewed Changes

Copilot reviewed 9 out of 9 changed files in this pull request and generated 3 comments.

Show a summary per file

File	Description
scripts/validate-setup.sh	Comprehensive validation script with Node.js version checking, step-by-step validation, and known issue handling
scripts/quick-setup.sh	Quick setup automation script that runs essential commands in correct sequence with colored output
package.json	Added three new npm commands for copilot setup, validation, and full setup workflows
docs/copilot-setup-guide.md	Complete implementation guide with technical details, usage examples, and future enhancement opportunities
README.md	Added comprehensive "Copilot Setup Steps" section with quick reference and manual setup instructions
.github/workflows/manual-setup-test.yml	Manual testing workflow with configurable options for testing setup scenarios
.github/workflows/development.yml	Development-focused workflow with separate jobs for linting, building, testing, and wallet preparation
.github/workflows/copilot-setup.yml	Main CI/CD workflow that runs essential setup commands with proper error handling
.github/ISSUE_TEMPLATE/setup.yml	Structured issue template for setup-related problems with comprehensive information collection

[joe10832]

-@copilot

[joe10832]

@copilot

[joe10832]

d5d2a7b

[joe10832]

.github/copilot-instructions.md