Fix pnpm installation issues and add comprehensive setup documentation

[Copilot]

This PR addresses the common pnpm install issue where users encounter "ERR_PNPM_NO_PKG_MANIFEST No package.json found" errors due to incorrect directory navigation.

Problem

Users were trying to run pnpm install in non-existent directories, specifically:

• Attempting to use gmail-flow instead of the correct gmail-workflow
• Lack of clear installation instructions
• Missing pnpm-lock.yaml files for consistent dependency management

Solution

1. Enhanced Documentation

• Updated main README.md with clear installation steps and directory name clarification
• Created comprehensive INSTALL.md guide with troubleshooting section
• Added directory name reference table to prevent confusion:

❌ Common Mistake	✅ Correct Directory
gmail-flow	gmail-workflow
github-workflow	github-integration-workflow

2. Consistent Dependency Management

Added pnpm-lock.yaml files to 9 key examples:

• ai-deep-research-agent
• chat-agent
• conversation-analyzer-with-vision
• finance-agent
• github-integration-workflow
• gmail-workflow
• rag-docling-weaviate-agent
• research-assistant
• trello-flow

3. Improved Project Structure

• Added proper .gitignore for Python environments to prevent unwanted commits
• Verified all examples work correctly with both pnpm and npm

Testing

All examples tested successfully:

cd examples/gmail-workflow  # ✅ Correct directory
pnpm install                # ✅ Works perfectly
pnpm dev                    # ✅ Starts development server

Impact

• Eliminates directory confusion for new users
• Provides consistent dependency versions across environments
• Includes comprehensive troubleshooting guide
• Supports both pnpm (recommended) and npm workflows

Fixes #36.

---

💬 Share your feedback on Copilot coding agent for the chance to win a $200 gift card! Click here to start the survey.