Marcus/amp init command

[marcusrein]

Add amp init command with extensible template system

Overview

Introduces amp init, a new CLI command that bootstraps Amp projects from templates. Provides a minimal and streamlined onboarding experience with an architecture designed to eventually support multiple templates.

Initial template is specific to local development. If this shape of amp init is approved, other templates that spin up various permutations of Amp may be built, for example evm-firehose-mulichain, evm-rpc-multichain-multicontract, etc.

Usage

Interactive Mode (Recommended)

npx @edgeandnode/amp init

Prompts for template selection, dataset name, version, and project name with validation.

Non-Interactive Mode

# Custom configuration
npx @edgeandnode/amp init --dataset-name my_data --project-name "My Project"

# Quick start with defaults
npx @edgeandnode/amp init -y

Template: local-evm-rpc

A complete learning environment for developers new to Amp. Generates 11 files including:

What's Generated

.
├── amp.config.ts              # TypeScript dataset config
├── amp.toml                   # Amp daemon config
├── manifests/anvil_rpc.json   # Raw dataset definition
├── providers/anvil.toml       # Anvil RPC endpoint config
├── contracts/
│   ├── src/EventEmitter.sol   # Sample contract (emits 500 events)
│   └── script/EventEmitter.s.sol
└── README.md                  # 495-line comprehensive guide

What Developers Get

• 500 sample events ready to query immediately after setup
• Step-by-step README: 5 steps, ~2 minutes to working setup
• 6 categories of query examples: filtering, aggregations, joins, decoded events, UDFs, performance patterns
• Foundry setup with deployment scripts
• Troubleshooting guide for common issues

Key Features

✅ Interactive & non-interactive modes - Follow prompts or use CLI flags
✅ Template selection UI - Shows available templates with descriptions (extensible for future templates)
✅ Input validation - Dataset names, versions validated with helpful error messages
✅ Safety checks - Prevents overwriting existing amp.config.ts
✅ Comprehensive testing - 9 unit tests covering template resolution, validation, and file generation

Architecture

• Effect-TS patterns throughout (Effect, Schema, Match)
• Extensible template system via Template interface
• Type-safe error handling with TemplateError class
• Clean separation of concerns (command logic, templates, file operations)

Testing

pnpm vitest run test/cli/init.test.ts
# ✓ 9/9 tests passing

Coverage includes:

• Template file resolution (static & dynamic)
• Config generation with custom values
• Dataset name validation
• Solidity contract validity

Next Steps

After this PR, the next template will be onchain-evm-rpc to guide developers to real blockchain usage (testnet/mainnet) with production best practices:

• RPC endpoint configuration for public networks
• start_block and finalized_blocks_only settings
• Rate limiting and cost optimization
• Real-world query patterns

Breaking Changes

None - purely additive feature.

[marcusrein]

CI Notes

Two CI issues surfaced (not caused by this PR):

1. TypeScript check fails: Root tsconfig.json has project
   reference configuration issues (TS2878). The amp init code
   itself compiles correctly.

2. Integration test fails: it_typescript::typescript_basic
   needs git submodules in CI (missing submodules: recursive in
   checkout action).

Both are pre-existing infrastructure issues. Happy to address in
a follow-up if needed.

[CLAassistant]

All committers have signed the CLA.

[leoyvens]

@marcusrein are you still working on this?

[marcusrein]

@leoyvens I would like to continue working on it once I receive feedback. I submitted prior to DevConnect and have not heard if I should continue on this or not.