feat(cli): add flash build command for packaging application artifact

[deanq]

Merge the prerequisite first: #96

Summary

Adds flash build command to package Flash applications into self-contained tarballs with dependencies as local modules.

Changes

New Files

• src/tetra_rp/cli/commands/build.py - Main build command implementation
• src/tetra_rp/cli/utils/ignore.py - Gitignore-style pattern matching utility

Modified Files

• pyproject.toml - Added pathspec>=0.11.0 dependency
• src/tetra_rp/cli/main.py - Registered build command
• src/tetra_rp/cli/utils/skeleton.py - Added .flashignore template to project scaffolding

Features

Command Options

flash build                  # Build with all dependencies
flash build --no-deps        # Skip transitive dependencies  
flash build --keep-build     # Keep temporary build directory
flash build -o custom.tar.gz # Custom archive name

Usage Example

# Initialize project
flash init my-app
cd my-app

# Build for deployment
flash build

# Output:
# ✓ Loaded ignore patterns          
# ✓ Found 7 files to package        
# ✓ Created .tetra/.build/my-app/ 
# ✓ Copied 7 files                  
# ✓ Installed 6 packages            
# ✓ Created archive.tar.gz (33.2 MB)

# Archive ready at .tetra/archive.tar.gz

Build Process

flowchart TD
    A[flash build] --> B[Load .flashignore + .gitignore]
    B --> C[Collect project files]
    C --> D[Create .tetra/.build/app-name/]
    D --> E[Copy files to build dir]
    E --> F[Collect requirements.txt]
    F --> G[Extract @remote dependencies]
    G --> H[pip install --target build_dir]
    H --> I[Create tarball]
    I --> J{--keep-build?}
    J -->|No| K[Delete .build/]
    J -->|Yes| L[Keep .build/]
    K --> M[.tetra/archive.tar.gz]
    L --> M

Loading

[Copilot]

Pull Request Overview

Adds a flash build command to package Flash applications into self-contained tarballs with all dependencies bundled as local modules, similar to AWS Lambda deployment packages.

Key Changes:

• Implements build command with support for ignore patterns (.flashignore/.gitignore)
• Adds dependency collection from requirements.txt and @Remote decorators
• Provides CLI options for controlling transitive dependencies and build artifact retention

Reviewed Changes

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

Show a summary per file

File	Description
src/tetra_rp/cli/commands/build.py	Core build command implementation with file collection, dependency installation, and tarball creation
src/tetra_rp/cli/utils/ignore.py	Gitignore-style pattern matching utilities using pathspec library
src/tetra_rp/cli/utils/skeleton.py	Added .flashignore template to project scaffolding
src/tetra_rp/cli/main.py	Registered build command in CLI
pyproject.toml	Added pathspec dependency for pattern matching

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[Copilot]

Pull Request Overview

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

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.