Cursor rule

1---
2description: 
3globs: 
4alwaysApply: true
5---
6# Agent Guidelines for OpenSearch Project
7 
8## Build/Test Commands
9- **Run dev**: `bun run dev` (watches src/index.ts)
10- **Run CLI**: `bun run cli` (starts interactive CLI)
11- **Run tests**: `bun test` (runs all tests)
12- **Run single test**: `bun test <test-file>` (e.g., `bun test test/generate-query.test.ts`)
13- **Format/Lint**: Use Biome via `bunx biome format .` and `bunx biome lint .`
14 
15## Code Style & Conventions
16- **Runtime**: Use Bun instead of Node.js/npm/pnpm (see .cursor/rules)
17- **Formatting**: Tabs for indentation, single quotes for strings (biome.json)
18- **Imports**: Organize imports enabled, use path aliases `@/*` for src, `@baml-client` for BAML
19- **Types**: Strict TypeScript, interfaces for data structures, explicit return types
20- **Naming**: PascalCase for React components/BAML functions, camelCase for variables/functions
21- **Files**: .tsx for React components, .ts for utilities, .baml for BAML functions
22 
23## BAML Integration
24- **Source files**: Only edit files in `baml_src/` directory (*.baml files)
25- **Generated code**: `baml_client/` is auto-generated from `baml_src/` - never edit directly
26- **Functions**: Import and call via `import { b } from '@baml-client'; await b.SomeFunction(...)`
27- **Types**: All classes/enums exported from `@baml-client` (e.g., `import { SearchResult } from '@baml-client'`)
28- **Naming**: BAML functions use PascalCase (e.g., `GenerateQuery`, `Reflect`)
29- **Prompts**: Include `{{ ctx.output_format }}` and `{{ _.role("user") }}` for user inputs
30- **Schema**: Prefer enums over confidence numbers, use classes for structured outputs
31 
32## Error Handling & Testing
33- Use Bun's built-in test framework with `import { test, expect } from "bun:test"`
34- Async/await for BAML function calls and API interactions
35- Type-safe error handling with proper TypeScript types