matimo-examples 0.1.0-alpha.11

package/github/github-decorator.ts

@@ -0,0 +1,326 @@
+#!/usr/bin/env node
+/**
+ * ============================================================================
+ * GITHUB TOOLS - DECORATOR PATTERN EXAMPLE
+ * ============================================================================
+ *
+ * PATTERN: Decorator Pattern with @tool
+ * ─────────────────────────────────────────────────────────────────────────
+ * Uses TypeScript @tool decorators to wrap GitHub tool calls in a class.
+ *
+ * Use this pattern when:
+ * ✅ Building class-based applications
+ * ✅ Encapsulating tool logic in services
+ * ✅ Adding custom methods that combine multiple tools
+ * ✅ Need reusable tool wrappers
+ * ✅ Object-oriented design preferred
+ *
+ * SETUP:
+ * ─────────────────────────────────────────────────────────────────────────
+ * 1. Create .env file:
+ *    GITHUB_TOKEN=ghp_xxxxxxxxxxxxx
+ *
+ * 2. Get a GitHub Personal Access Token:
+ *    https://github.com/settings/tokens
+ *
+ * USAGE:
+ * ─────────────────────────────────────────────────────────────────────────
+ *   export GITHUB_TOKEN=your_token_here
+ *   npm run github:decorator
+ *
+ * ============================================================================
+ */
+
+import 'dotenv/config';
+import path from 'path';
+import { fileURLToPath } from 'url';
+import { MatimoInstance, tool, setGlobalMatimoInstance } from 'matimo';
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+
+/**
+ * Decorator Pattern Agent - Uses @tool decorators for GitHub operations
+ */
+class GitHubDecoratorPatternAgent {
+  public matimo: MatimoInstance;
+
+  constructor(matimo: MatimoInstance) {
+    this.matimo = matimo;
+  }
+
+  /**
+   * GitHub search repositories tool - manually execute with required parameters
+   */
+  async searchRepositories(query: string): Promise<unknown> {
+    const result = await this.matimo.execute('github-search-repositories', {
+      query,
+    });
+    return result;
+  }
+
+  /**
+   * GitHub list-repositories tool - automatically executes via @tool decorator
+   */
+  @tool('github-list-repositories')
+  async listRepositories(owner: string): Promise<unknown> {
+    // Decorator automatically calls: matimo.execute('github-list-repositories', { owner })
+    return undefined;
+  }
+
+  /**
+   * GitHub get-repository tool - automatically executes via @tool decorator
+   */
+  @tool('github-get-repository')
+  async getRepository(owner: string, repo: string): Promise<unknown> {
+    // Decorator automatically calls: matimo.execute('github-get-repository', { owner, repo })
+    return undefined;
+  }
+
+  /**
+   * GitHub list-pull-requests tool - automatically executes via @tool decorator
+   */
+  @tool('github-list-pull-requests')
+  async listPullRequests(owner: string, repo: string, state?: string): Promise<unknown> {
+    // Decorator automatically calls: matimo.execute('github-list-pull-requests', { owner, repo, state })
+    return undefined;
+  }
+
+  /**
+   * GitHub list-issues tool - automatically executes via @tool decorator
+   */
+  @tool('github-list-issues')
+  async listIssues(owner: string, repo: string, state?: string): Promise<unknown> {
+    // Decorator automatically calls: matimo.execute('github-list-issues', { owner, repo, state })
+    return undefined;
+  }
+
+  /**
+   * GitHub list-commits tool - automatically executes via @tool decorator
+   */
+  @tool('github-list-commits')
+  async listCommits(owner: string, repo: string): Promise<unknown> {
+    // Decorator automatically calls: matimo.execute('github-list-commits', { owner, repo })
+    return undefined;
+  }
+}
+
+/**
+ * Run decorator pattern examples
+ */
+async function runDecoratorPatternExamples() {
+  const gitHubToken = process.env.GITHUB_TOKEN || 'ghp-default-fake-token';
+
+  console.info('╔════════════════════════════════════════════════════════╗');
+  console.info('║  GitHub Tools - Decorator Pattern                      ║');
+  console.info('║  (Uses @tool decorators for automatic execution)       ║');
+  console.info('╚════════════════════════════════════════════════════════╝\n');
+
+  if (gitHubToken === 'ghp-default-fake-token') {
+    console.info('🔐 Warning: GITHUB_TOKEN not set in environment');
+    console.info('   Set it: export GITHUB_TOKEN="ghp_xxxx"');
+    console.info('   Get one from: https://github.com/settings/tokens\n');
+  }
+
+  console.info(`🤖 GitHub Token: ${gitHubToken.substring(0, 10)}...\n`);
+
+  try {
+    // Initialize Matimo with auto-discovery
+    console.info('🚀 Initializing Matimo...');
+    const matimo = await MatimoInstance.init({ autoDiscover: true });
+    setGlobalMatimoInstance(matimo);
+
+    const matimoTools = matimo.listTools();
+    const githubTools = matimoTools.filter((t) => t.name.startsWith('github'));
+    console.info(
+      `📦 Loaded ${matimoTools.length} total tools, ${githubTools.length} GitHub tools\n`
+    );
+
+    // Create agent
+    const agent = new GitHubDecoratorPatternAgent(matimo);
+
+    console.info('🧪 Testing GitHub Tools with Decorator Pattern');
+    console.info('═'.repeat(60) + '\n');
+
+    // Example 1: Search repositories
+    console.info('🔍 Example 1: Search Repositories');
+    console.info('─'.repeat(60));
+    try {
+      const searchResult = await agent.searchRepositories('language:rust stars:>1000');
+
+      const searchData = (searchResult as any).data || searchResult;
+
+      if (
+        searchData.total_count !== undefined &&
+        searchData.items &&
+        Array.isArray(searchData.items)
+      ) {
+        const totalPages = Math.ceil(searchData.total_count / searchData.items.length);
+        console.info(
+          `✅ Found ${searchData.total_count} Rust repositories (showing first ${Math.min(3, searchData.items.length)})`
+        );
+        searchData.items.slice(0, 3).forEach((repo: any, idx: number) => {
+          console.info(`   ${idx + 1}. ${repo.full_name} (⭐ ${repo.stargazers_count})`);
+        });
+        if (searchData.items.length > 3) {
+          console.info(`   ... and ${searchData.items.length - 3} more on this page`);
+        }
+        console.info(`   📄 Page 1 of ~${totalPages} pages`);
+      } else {
+        console.info(`❌ Failed: ${searchData.message || 'Unknown error'}`);
+      }
+    } catch (error) {
+      console.info(`❌ Error: ${error instanceof Error ? error.message : String(error)}`);
+    }
+
+    // Example 2: List organization repositories
+    console.info('\n📋 Example 2: List Organization Repositories');
+    console.info('─'.repeat(60));
+    try {
+      const listResult = await agent.listRepositories('rust-lang');
+
+      const listData = (listResult as any).data || listResult;
+
+      if (Array.isArray(listData)) {
+        console.info(`✅ Found ${listData.length} repositories in rust-lang:`);
+        listData.slice(0, 3).forEach((repo: any, idx: number) => {
+          console.info(`   ${idx + 1}. ${repo.name}`);
+        });
+        if (listData.length > 3) {
+          console.info(`   ... and ${listData.length - 3} more`);
+        }
+
+        // Use first repository for next examples
+        const firstRepo = listData[0];
+        console.info(`\n🎯 Using first repo: ${firstRepo.name}\n`);
+
+        // Example 3: Get repository details
+        console.info('🔎 Example 3: Get Repository Details');
+        console.info('─'.repeat(60));
+        try {
+          const repoResult = await agent.getRepository('rust-lang', firstRepo.name);
+
+          const repoData = (repoResult as any).data || repoResult;
+          if (repoData.id !== undefined) {
+            console.info(`✅ rust-lang/${firstRepo.name}`);
+            console.info(`   Stars: ⭐ ${repoData.stargazers_count}`);
+            console.info(`   Forks: 🍴 ${repoData.forks_count}`);
+            console.info(`   Language: ${repoData.language || 'N/A'}`);
+            console.info(`   Open Issues: ${repoData.open_issues_count}`);
+          } else {
+            console.info(`❌ Failed: ${repoData.message || 'Unknown error'}`);
+          }
+        } catch (error) {
+          console.info(`❌ Error: ${error instanceof Error ? error.message : String(error)}`);
+        }
+
+        // Example 4: List pull requests (manually execute to use per_page parameter)
+        console.info('\n🔀 Example 4: List Pull Requests');
+        console.info('─'.repeat(60));
+        console.info('📌 Checking: cli/cli (has active PRs)\n');
+        try {
+          const prsResult = await agent.matimo.execute('github-list-pull-requests', {
+            owner: 'cli',
+            repo: 'cli',
+            state: 'open',
+            per_page: 5,
+          });
+
+          const prsData = (prsResult as any).data || prsResult;
+          const prList = Array.isArray(prsData) ? prsData : prsData?.pull_requests || [];
+
+          if (prList.length > 0) {
+            console.info(`✅ Found ${prList.length} open pull requests from cli/cli`);
+            prList.slice(0, 3).forEach((pr: any, idx: number) => {
+              console.info(`   ${idx + 1}. #${pr.number}: ${pr.title}`);
+              console.info(`      Created: ${new Date(pr.created_at).toLocaleDateString()}`);
+            });
+            if (prList.length > 3) {
+              console.info(`   ... and ${prList.length - 3} more`);
+            }
+          } else {
+            console.info(`⚠️  No open pull requests found`);
+          }
+        } catch (error) {
+          console.info(`❌ Error: ${error instanceof Error ? error.message : String(error)}`);
+        }
+
+        // Example 5: List commits (manually execute to use per_page parameter)
+        console.info('\n📝 Example 5: List Commits');
+        console.info('─'.repeat(60));
+        console.info('📌 Checking: golang/go (has active commits)\n');
+        try {
+          const commitsResult = await agent.matimo.execute('github-list-commits', {
+            owner: 'golang',
+            repo: 'go',
+            per_page: 5,
+          });
+
+          const commitsData = (commitsResult as any).data || commitsResult;
+          const commitList = Array.isArray(commitsData) ? commitsData : commitsData?.commits || [];
+
+          if (commitList.length > 0) {
+            console.info(`✅ Found ${commitList.length} recent commits from golang/go`);
+            commitList.slice(0, 3).forEach((commit: any, idx: number) => {
+              const msg = commit.commit.message.split('\n')[0];
+              console.info(`   ${idx + 1}. ${commit.commit.author?.name || 'Unknown'}`);
+              console.info(`      ${msg}`);
+              console.info(`      SHA: ${commit.sha.substring(0, 7)}`);
+            });
+            if (commitList.length > 3) {
+              console.info(`   ... and ${commitList.length - 3} more`);
+            }
+          } else {
+            console.info(`⚠️  No commits found`);
+          }
+        } catch (error) {
+          console.info(`❌ Error: ${error instanceof Error ? error.message : String(error)}`);
+        }
+
+        // Example 6: List releases (manually execute to use per_page parameter)
+        console.info('\n🎉 Example 6: List Releases');
+        console.info('─'.repeat(60));
+        try {
+          const releasesResult = await agent.matimo.execute('github-list-releases', {
+            owner: 'nodejs',
+            repo: 'node',
+            per_page: 5,
+          });
+
+          const releasesData = (releasesResult as any).data || releasesResult;
+          const releaseList = Array.isArray(releasesData) ? releasesData : [];
+
+          if (releaseList.length > 0) {
+            console.info(`✅ Found ${releaseList.length} releases from nodejs/node`);
+            releaseList.slice(0, 3).forEach((release: any, idx: number) => {
+              console.info(`   ${idx + 1}. ${release.tag_name} - ${release.name || 'Unnamed'}`);
+            });
+            if (releaseList.length > 3) {
+              console.info(`   ... and ${releaseList.length - 3} more`);
+            }
+          } else {
+            console.info(`⚠️  No releases found`);
+          }
+        } catch (error) {
+          console.info(`❌ Error: ${error instanceof Error ? error.message : String(error)}`);
+        }
+      } else {
+        console.info(`❌ Failed to list repositories: ${listData.message || 'Unknown error'}`);
+      }
+    } catch (error) {
+      console.info(`❌ Error: ${error instanceof Error ? error.message : String(error)}`);
+    }
+
+    console.info('\n' + '═'.repeat(60));
+    console.info('✨ Decorator Pattern Example Complete!');
+    console.info('═'.repeat(60) + '\n');
+  } catch (error) {
+    console.error('❌ Fatal error:', error instanceof Error ? error.message : String(error));
+    process.exit(1);
+  }
+}
+
+// Run the example
+runDecoratorPatternExamples().catch((error) => {
+  console.error('❌ Unhandled error:', error);
+  process.exit(1);
+});

package/github/github-factory.ts

@@ -0,0 +1,355 @@
+#!/usr/bin/env node
+
+import 'dotenv/config';
+import { MatimoInstance } from '@matimo/core';
+
+/**
+ * GitHub Factory Pattern Example
+ * ================================
+ *
+ * Demonstrates the simplest way to use Matimo tools: direct execution via matimo.execute().
+ * This pattern is best for:
+ *   - Simple scripts and CLIs
+ *   - Direct tool invocation
+ *   - Learning Matimo basics
+ *
+ * Setup:
+ * ------
+ * 1. Get a GitHub Personal Access Token (PAT):
+ *    Visit: https://github.com/settings/tokens
+ *    Create token with: repo, read:org scopes (for public repo access)
+ *
+ * 2. Set environment variable:
+ *    export GITHUB_TOKEN="ghp_xxxxxxxxxxxxxxxxxxxx"
+ *
+ * 3. Run this example:
+ *    pnpm github:factory
+ *
+ * Available GitHub Tools:
+ * -----------------------
+ * SEARCH:
+ *   - github-search-repositories: Find repositories by query (language, stars, etc.)
+ *   - github-search-code: Search code across repositories
+ *   - github-search-issues: Find issues and pull requests
+ *   - github-search-users: Find GitHub users
+ *
+ * REPOSITORIES:
+ *   - github-list-repositories: List repos in an org/user
+ *   - github-get-repository: Get detailed repo info
+ *   - github-create-repository: Create new repo (write access required)
+ *   - github-delete-repository: Delete a repo (write access required)
+ *
+ * ISSUES:
+ *   - github-list-issues: List issues in a repo
+ *   - github-create-issue: Create issue (write access required)
+ *   - github-get-issue: Get issue details
+ *   - github-update-issue: Update issue (write access required)
+ *
+ * PULL REQUESTS:
+ *   - github-list-pull-requests: List PRs in a repo
+ *   - github-create-pull-request: Create PR (write access required)
+ *   - github-merge-pull-request: Merge PR (write access required)
+ *
+ * COMMITS:
+ *   - github-list-commits: List commits in repo
+ *
+ * COLLABORATORS:
+ *   - github-list-collaborators: List repo collaborators
+ *   - github-add-collaborator: Add collaborator (admin access required)
+ *
+ * RELEASES:
+ *   - github-list-releases: List releases
+ *   - github-create-release: Create release (write access required)
+ *
+ * CODE SCANNING:
+ *   - github-list-code-alerts: List security alerts (Advanced Security)
+ *   - github-update-code-alert: Update alert status (Advanced Security)
+ */
+
+// Type definitions for API responses
+interface SearchRepositoryResult {
+  total_count: number;
+  items: Array<{
+    id: number;
+    name: string;
+    full_name: string;
+    description: string;
+    url: string;
+    stargazers_count: number;
+    forks_count: number;
+    language: string | null;
+    updated_at: string;
+  }>;
+}
+
+interface Repository {
+  id: number;
+  name: string;
+  full_name: string;
+  description: string | null;
+  url: string;
+  stargazers_count: number;
+  forks_count: number;
+  language: string | null;
+  open_issues_count: number;
+  topics: string[];
+}
+
+interface PullRequest {
+  id: number;
+  number: number;
+  title: string;
+  body: string | null;
+  state: string;
+  created_at: string;
+  updated_at: string;
+}
+
+interface Commit {
+  sha: string;
+  commit: {
+    author: {
+      name: string;
+      email: string;
+      date: string;
+    };
+    message: string;
+  };
+}
+
+interface Release {
+  id: number;
+  tag_name: string;
+  name: string | null;
+  body: string | null;
+  draft: boolean;
+  prerelease: boolean;
+  created_at: string;
+  published_at: string | null;
+}
+
+async function main() {
+  console.info('\n╔════════════════════════════════════════════════════════════╗');
+  console.info('║  🐙 GitHub Factory Pattern Example                      ║');
+  console.info('║  Direct tool execution using matimo.execute()           ║');
+  console.info('╚════════════════════════════════════════════════════════════╝\n');
+
+  // Check for GitHub token
+  const token = process.env.GITHUB_TOKEN;
+  if (!token) {
+    console.error('\n❌ Error: GITHUB_TOKEN environment variable not set');
+    console.info('\n📖 Setup Instructions:');
+    console.info('   1. Create a GitHub Personal Access Token:');
+    console.info('      https://github.com/settings/tokens');
+    console.info('   2. Set the environment variable:');
+    console.info('      export GITHUB_TOKEN="ghp_xxxx..."');
+    console.info('   3. Run this example again:');
+    console.info('      pnpm github:factory\n');
+    process.exit(1);
+  }
+
+  try {
+    // Initialize Matimo with auto-discovery
+    const matimo = await MatimoInstance.init({
+      autoDiscover: true,
+    });
+
+    // Get all GitHub tools (filter by prefix)
+    const allTools = matimo.listTools();
+    const githubTools = allTools.filter((t) => t.name.startsWith('github-'));
+    console.info(`📚 Loaded ${githubTools.length} GitHub tools from Matimo\n`);
+
+    // Example 1: Search repositories
+    console.info('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+    console.info('Example 1: Search TypeScript Repositories');
+    console.info('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+    console.info('📦 Searching: language:typescript fork:false stars:>100\n');
+    try {
+      const searchResults = await matimo.execute('github-search-repositories', {
+        query: 'language:typescript fork:false stars:>100',
+      });
+      const searchData = (searchResults as any).data || searchResults;
+      console.info(`✅ Found ${searchData?.total_count} TypeScript repositories\n`);
+      if (searchData?.items && searchData.items.length > 0) {
+        console.info('Top 3 Results:');
+        searchData.items.slice(0, 3).forEach((repo: any, idx: number) => {
+          console.info(`  ${idx + 1}. ${repo.full_name} ⭐ ${repo.stargazers_count}`);
+          console.info(`     ${repo.description || 'No description'}\n`);
+        });
+      }
+    } catch (error: any) {
+      console.error(`❌ Search failed: ${error.message}`);
+    }
+
+    // Example 2: Get repository details
+    console.info('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+    console.info('Example 2: Get Repository Details');
+    console.info('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+    console.info('🔎 Getting details for: kubernetes/kubernetes\n');
+    try {
+      const repo = await matimo.execute('github-get-repository', {
+        owner: 'kubernetes',
+        repo: 'kubernetes',
+      });
+      const repoData = (repo as any).data || repo;
+      if (repoData && repoData.full_name) {
+        console.info(`✅ Repository: ${repoData.full_name}`);
+        console.info(`   Description: ${repoData.description}`);
+        console.info(`   Stars: ⭐ ${repoData.stargazers_count?.toLocaleString()}`);
+        console.info(`   Language: ${repoData.language || 'Mixed'}`);
+        console.info(`   Open Issues: ${repoData.open_issues_count}`);
+        if (repoData.topics?.length > 0) {
+          console.info(`   Topics: ${repoData.topics.join(', ')}`);
+        }
+        console.info();
+      } else {
+        console.error(
+          `❌ Get repository returned unexpected format: ${JSON.stringify(repoData).slice(0, 100)}`
+        );
+      }
+    } catch (error: any) {
+      console.error(`❌ Get repository failed: ${error.message}`);
+    }
+
+    // Example 3: List repositories
+    console.info('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+    console.info('Example 3: List Organization Repositories');
+    console.info('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+    console.info('📋 Listing top 5 Node.js repositories\n');
+    try {
+      const repos = await matimo.execute('github-list-repositories', {
+        owner: 'nodejs',
+        type: 'public',
+        per_page: 5,
+      });
+      const reposData = (repos as any).data || repos;
+      const repoList = Array.isArray(reposData) ? reposData : reposData?.repositories || [];
+      if (repoList.length > 0) {
+        console.info(`✅ Found ${repoList.length} repositories from nodejs org:\n`);
+        repoList.forEach((repo: any, idx: number) => {
+          console.info(`  ${idx + 1}. ${repo.name} ⭐ ${repo.stargazers_count}`);
+          console.info(`     Full Name: ${repo.full_name}`);
+          console.info(`     Language: ${repo.language || 'Mixed'}`);
+          console.info();
+        });
+      } else {
+        console.info(`⚠️  No repositories found or unexpected response format`);
+      }
+    } catch (error: any) {
+      console.error(`❌ List repositories failed: ${error.message}`);
+    }
+
+    // Example 4: List pull requests
+    console.info('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+    console.info('Example 4: List Open Pull Requests');
+    console.info('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+    console.info('🔀 Listing PRs from: cli/cli\n');
+    try {
+      const prs = await matimo.execute('github-list-pull-requests', {
+        owner: 'cli',
+        repo: 'cli',
+        state: 'open',
+        per_page: 5,
+      });
+      const prsData = (prs as any).data || prs;
+      const prList = Array.isArray(prsData) ? prsData : prsData?.pull_requests || [];
+      if (prList.length > 0) {
+        console.info(`✅ Found ${prList.length} open pull requests:\n`);
+        prList.forEach((pr: any, idx: number) => {
+          console.info(`  ${idx + 1}. #${pr.number}: ${pr.title}`);
+          console.info(
+            `     Status: ${pr.state} | Created: ${new Date(pr.created_at).toLocaleDateString()}`
+          );
+          console.info();
+        });
+      } else {
+        console.info(`⚠️  No open pull requests found or unexpected response format`);
+      }
+    } catch (error: any) {
+      console.error(`❌ List pull requests failed: ${error.message}`);
+    }
+
+    // Example 5: List commits
+    console.info('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+    console.info('Example 5: List Recent Commits');
+    console.info('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+    console.info('📝 Listing commits from: golang/go\n');
+    try {
+      const commits = await matimo.execute('github-list-commits', {
+        owner: 'golang',
+        repo: 'go',
+        per_page: 5,
+      });
+      const commitsData = (commits as any).data || commits;
+      const commitList = Array.isArray(commitsData) ? commitsData : commitsData?.commits || [];
+      if (commitList.length > 0) {
+        console.info(`✅ Found ${commitList.length} recent commits:\n`);
+        commitList.slice(0, 3).forEach((commit: any, idx: number) => {
+          const msg = commit.commit.message.split('\n')[0];
+          console.info(`  ${idx + 1}. ${commit.commit.author.name}`);
+          console.info(`     ${msg}`);
+          console.info(`     SHA: ${commit.sha.substring(0, 7)}`);
+          console.info();
+        });
+      } else {
+        console.info(`⚠️  No commits found or unexpected response format`);
+      }
+    } catch (error: any) {
+      console.error(`❌ List commits failed: ${error.message}`);
+    }
+
+    // Example 6: List releases
+    console.info('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+    console.info('Example 6: List Releases');
+    console.info('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+    console.info('🎉 Listing releases from: nodejs/node\n');
+    try {
+      const releases = await matimo.execute('github-list-releases', {
+        owner: 'nodejs',
+        repo: 'node',
+        per_page: 5,
+      });
+      const releasesData = (releases as any).data || releases;
+      const releaseList = Array.isArray(releasesData) ? releasesData : releasesData?.releases || [];
+      if (releaseList.length > 0) {
+        console.info(`✅ Found ${releaseList.length} releases:\n`);
+        releaseList.slice(0, 3).forEach((release: any, idx: number) => {
+          console.info(`  ${idx + 1}. ${release.tag_name} "${release.name}"`);
+          console.info(`     Published: ${new Date(release.published_at!).toLocaleDateString()}`);
+          console.info();
+        });
+      } else {
+        console.info(`⚠️  No releases found or unexpected response format`);
+      }
+    } catch (error: any) {
+      console.error(`❌ List releases failed: ${error.message}`);
+    }
+
+    // Example 7: Search code
+    console.info('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+    console.info('Example 7: Search Code');
+    console.info('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+    console.info('🔍 Searching for: "async function" in React\n');
+    try {
+      const codeResults = await matimo.execute('github-search-code', {
+        query: 'language:typescript "async function" repo:facebook/react',
+      });
+      const codeData = (codeResults as any).data || codeResults;
+      console.info(`✅ Found ${codeData?.total_count} code matches in React\n`);
+    } catch (error: any) {
+      console.error(`❌ Search code failed: ${error.message}`);
+    }
+
+    console.info('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+    console.info('✅ All factory pattern examples completed!');
+    console.info('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n');
+  } catch (error: any) {
+    console.error('\n❌ Fatal Error:', error.message);
+    if (error.details) {
+      console.error('Details:', JSON.stringify(error.details, null, 2));
+    }
+    process.exit(1);
+  }
+}
+
+main();