# Top Rule: No Placeholders or Mock Data

- Use only actual values across code and documentation. Do not add sample, placeholder, or mock data.
- If a placeholder seems required, stop and ask for approval and the real value before continuing.

# TypeScript Configuration Standard

## Required Compiler Options

All TypeScript projects must include the following base configuration in `tsconfig.json`:

```json
{
  "compilerOptions": {
    "target": "ESNext",
    "module": "NodeNext",
    "moduleResolution": "NodeNext",
    "lib": ["ESNext", "DOM"],
    "strict": true,
    "esModuleInterop": true,
    "resolveJsonModule": true,
    "skipLibCheck": true,
    "forceConsistentCasingInFileNames": true,
    "outDir": "dist"
  },
  "include": ["src"]
}
```

## Key Directive: forceConsistentCasingInFileNames

**Purpose**: Enforce file path casing consistency across all platforms.
- Windows filesystem is case-insensitive but case-preserving.
- macOS/Linux filesystems are case-sensitive.
- TypeScript errors on casing mismatches, preventing cross-platform import failures.

**Example**:
```typescript
// ✓ Correct: matches file name exactly
import { authPocketBaseAgent } from './agentAuth.ts';

// ✗ Error with forceConsistentCasingInFileNames
import { authPocketBaseAgent } from './AgentAuth.ts';  // File is agentAuth.ts
```

**Benefit**: Catch platform-specific bugs during development, not after deployment.

## Apply to All Future Projects

Include `"forceConsistentCasingInFileNames": true` in every TypeScript project's `compilerOptions`.
