betting-method-mcp: Instructions file for GitHub Copilot

GitHub Copilot Instructions

Instructions for GitHub Copilot when working on betting-method-mcp.

Code Style

TypeScript

• Use double quotes for strings
• Always use semicolons
• Use 2 spaces for indentation
• Maximum line length: 100 characters
• Always use trailing commas in arrays and objects
• Always use parentheses around arrow function parameters

Example

const example = (param: string): void => {
  console.log("This is the correct style");
};

Naming Conventions

• Classes: PascalCase (e.g., MonteCarloMethod, MartingaleMethod)
• Interfaces: PascalCase ending with State (e.g., MonteCarloState)
• Functions/Methods: camelCase (e.g., recordResult, initSession)
• Constants: UPPER_SNAKE_CASE (e.g., DEFAULT_MAX_BET)
• MCP Tools: lowercase_snake_case (e.g., montecarlo_init)

Patterns to Follow

1. Betting Method Class Structure

Always implement these 5 methods:

export class MethodNameMethod {
  private state: MethodNameState;

  constructor() {
    // Initialize with default values
  }

  initSession(/* parameters */): void {
    // 1. Validate all parameters
    // 2. Initialize state
    // 3. Set sessionActive to true
  }

  recordResult(result: BetResult): void {
    // 1. Check if sessionActive
    // 2. Update totalProfit
    // 3. Calculate next bet
    // 4. Update state
  }

  getState(): MethodNameState {
    // ALWAYS return a copy
    return { ...this.state };
  }

  reset(): void {
    // Reset to initial state
  }
}

2. State Interface Definition

All state interfaces must extend BettingMethodState:

export interface MethodNameState extends BettingMethodState {
  // Add method-specific properties here
  baseUnit: number;
  // ... other properties
}

3. Parameter Validation

Always validate parameters:

if (baseUnit <= 0) {
  throw new Error("baseUnit must be positive");
}
if (maxBet < baseUnit) {
  throw new Error("maxBet must be greater than or equal to baseUnit");
}