Add comprehensive C SDK implementation guidelines for Solana AI Registries

[Copilot]

This PR adds detailed implementation guidelines for the C SDK (libaireg) for Solana AI Registries, providing comprehensive guidance for contributors to ensure consistent, memory-safe, and maintainable code.

What's Added

Created docs/C_SDK_IMPLEMENTATION_GUIDELINES.md with complete implementation guidance covering:

📋 Atomic Implementation Tasks

• Task 5.1: Core RPC and Transaction Builder (solana_ai_registries.h + client.c)
• Task 5.2: High-Level Operations (agent.h / mcp.h)
• Task 5.3: Payment Flows (payments.h)
• Task 5.4: IDL Struct Generation (idl.h)
• Task 5.5: Integration Testing (make test-integration)

🛡️ Memory-Safe Design Strategies

• RAII-style resource management patterns
• Mandatory error checking for all allocations
• Valgrind integration requirements (zero leaks, zero errors)
• Safe string handling with bounds checking

🏗️ Struct Generation and Validation

• IDL-to-C structure generation process
• Complete type mapping table (Anchor IDL → C types)
• Structure validation functions and patterns
• Code generation tooling requirements

🧪 Test Framework and CI/CD Requirements

• Unity Test Framework integration with examples

• 90% code coverage using gcov

• Integration testing against Solana devnet
• GitHub Actions workflow specifications for multi-platform builds

📝 Code Style and Review Guidelines

• C99/C11 coding standards and naming conventions
• Comprehensive error handling with standard AI_ERR_* codes
• Doxygen documentation requirements with examples
• Complete code review checklist

📚 Reference Documentation

• Links to all related internal documentation
• External resources and C programming standards
• Solana development resources
• Complete reference to requirements in docs/sdk_refs/c_sdk_references.md

Key Features

The guidelines ensure:

• Memory Safety: Zero-tolerance for memory leaks with Valgrind validation
• Error Handling: Standard C error codes with clear messages
• API Documentation: Comprehensive Doxygen comments for all public functions
• Test Coverage: >90% coverage with reproducible integration tests
• CI/CD: Multi-platform builds with automated testing

Example Code Patterns

The document includes practical examples for:

• Safe memory allocation and cleanup
• Error handling patterns
• Structure validation
• Unit test organization
• Doxygen documentation format

All guidelines reference the atomic execution plan requirements from docs/sdk_refs/c_sdk_references.md and provide actionable, clear guidance for contributors implementing the C SDK.

Fixes #45.

---

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

[sourcery-ai]

🧙 Sourcery is reviewing your pull request!

---

Tips and commands

Interacting with Sourcery

• Trigger a new review: Comment @sourcery-ai review on the pull request.
• Continue discussions: Reply directly to Sourcery's review comments.
• Generate a GitHub issue from a review comment: Ask Sourcery to create an
  issue from a review comment by replying to it. You can also reply to a
  review comment with @sourcery-ai issue to create an issue from it.
• Generate a pull request title: Write @sourcery-ai anywhere in the pull
  request title to generate a title at any time. You can also comment
  @sourcery-ai title on the pull request to (re-)generate the title at any time.
• Generate a pull request summary: Write @sourcery-ai summary anywhere in
  the pull request body to generate a PR summary at any time exactly where you
  want it. You can also comment @sourcery-ai summary on the pull request to
  (re-)generate the summary at any time.
• Generate reviewer's guide: Comment @sourcery-ai guide on the pull
  request to (re-)generate the reviewer's guide at any time.
• Resolve all Sourcery comments: Comment @sourcery-ai resolve on the
  pull request to resolve all Sourcery comments. Useful if you've already
  addressed all the comments and don't want to see them anymore.
• Dismiss all Sourcery reviews: Comment @sourcery-ai dismiss on the pull
  request to dismiss all existing Sourcery reviews. Especially useful if you
  want to start fresh with a new review - don't forget to comment
  @sourcery-ai review to trigger a new review!

Customizing Your Experience

Access your dashboard to:

• Enable or disable review features such as the Sourcery-generated pull request
  summary, the reviewer's guide, and others.
• Change the review language.
• Add, remove or edit custom review instructions.
• Adjust other review settings.

Getting Help

• Contact our support team for questions or feedback.
• Visit our documentation for detailed guides and information.
• Keep in touch with the Sourcery team by following us on X/Twitter, LinkedIn or GitHub.

[netlify]

✅ Deploy Preview for aeamcp canceled.

Name	Link
🔨 Latest commit	702700a
🔍 Latest deploy log	https://app.netlify.com/projects/aeamcp/deploys/686bab9b8c23c00008341600

[devloai]

PR Summary:

This is a WIP PR to create C SDK implementation guidelines for Solana AI Registries. The PR currently contains no file changes and is in the planning/setup phase. The goal is to reference requirements from docs/sdk_refs/c_sdk_references.md and create actionable guidelines covering atomic tasks, memory safety, struct generation, testing, and code style standards.

Review Summary:

No code changes to review yet - this is an empty WIP PR with 0 files changed. Based on repository knowledge of existing Rust SDK structure, documentation standards, and C SDK requirements, the author should create comprehensive implementation guidelines document first. The existing docs/sdk_refs/c_sdk_references.md provides a solid foundation with atomic tasks and memory safety requirements that should be expanded into full contributor guidelines. Please provide feedback on this review approach for future improvements.

Follow-up suggestions:

• @devloai help draft the C SDK implementation guidelines document
• @devloai review the implementation guidelines once they are created