Comprehensive documentation restructuring: quickstarts, concepts, security, architecture, cookbook, and contributing guides

[Copilot]

This PR completely restructures and expands the Wassette documentation to provide comprehensive coverage of all aspects of the project, addressing the need for better organization and content coverage identified in the issue.

What's Changed

New Documentation Structure

The documentation has been reorganized into a logical, user-friendly structure:

• Getting Started - Quickstart guide with step-by-step AI agent setup
• Core Concepts - Deep dive into Wassette, WebAssembly Components, and MCP
• Security - Comprehensive security model and sandboxing implementation
• Development - Enhanced guides for all supported languages with testing and best practices
• Architecture - Component lifecycle and runtime design documentation
• Cookbook - Practical examples and common patterns
• Reference - CLI usage, built-in tools, configuration, and FAQ
• Contributing - Detailed contribution guidelines

Key Additions

Quickstart Guide: Complete walkthrough from installation to first component usage with real AI agent examples

Core Concepts: Three comprehensive guides explaining:

• Wassette's architecture and design philosophy
• WebAssembly Components and the component model
• Model Context Protocol integration and benefits

Security Documentation: In-depth coverage of:

• Multi-layered security model with threat analysis
• Sandboxing implementation details and enforcement
• Permission system and capability-based access control

Enhanced Development Guides:

• Getting started guide for new component developers
• Comprehensive testing strategies and examples
• Production-ready best practices with real code examples
• Updated language-specific guides (JavaScript, Rust, Python, Go)

Architecture Documentation:

• Detailed component lifecycle management
• Runtime design and performance optimization
• System architecture with technical implementation details

Practical Cookbook: Working examples for:

• File operations with security considerations
• API integration patterns with retry logic
• Data processing and transformation
• Common development patterns

Reference Materials:

• Complete built-in tools documentation
• Comprehensive configuration guide
• Enhanced CLI reference
• Updated FAQ with troubleshooting

Technical Improvements

• Fixed broken reference in SUMMARY.md (weld-permission-system.md → permission-system.md)
• Moved development guides into proper mdBook structure
• Added comprehensive cross-references between sections
• Included practical code examples in multiple languages
• Added security considerations throughout all guides
• Updated changelog with documentation improvements

Content Quality

All new documentation includes:

• Real, working code examples that can be copied and used
• Security best practices and considerations
• Error handling patterns and troubleshooting guides
• Performance optimization tips
• Comprehensive testing strategies
• Clear progression from beginner to advanced topics

The documentation now serves as a complete resource for developers, operators, and contributors to understand and work effectively with Wassette, from initial setup through advanced component development and production deployment.

Fixes #206.

---

💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.