Transform SDK documentation generation from script-based to AI-powered system

[akushniruk]

Current State

We have manual documentation scripts in sdk/scripts/ that generate docs and tutorials. They work but require constant maintenance and can become outdated when code changes.

Phase 1 Goal

Replace manual doc generation with AI that can analyze our TypeScript code and automatically generate comprehensive documentation.

What We Want to Build

• Code Analysis: AI reads our TypeScript files (like NitroliteService.ts) and understands the methods
• Auto-generate API docs: Creates documentation with proper descriptions, parameters, return types
• Smart examples: Generates realistic code examples for each method
• Build integration: Works with our existing npm run docs command

Expected Benefits

• Save 80% documentation time - No more manual writing
• Always current - Docs update when code changes
• Better coverage - Every method gets documented
• Consistent quality - Same high standard across all docs

Success Criteria

• AI can read TypeScript files and generate method documentation
• Generated docs include parameters, return types, and examples
• Integration with existing build process (npm run docs)
• Documentation quality matches our current manual docs
• Works with our TypeChain automation

Technical Approach

• Use OpenAI/Claude API for code analysis
• Parse TypeScript AST to understand method signatures
• Generate markdown documentation
• Integrate with existing scripts in sdk/scripts/