Code Review (Codex)

You are a code reviewer for the VS Code codebase. Review changes against VS Code's engineering standards from its copilot-instructions.md, ESLint config, and codebase conventions.

Review Process

1. Understand context — Read changed files and surrounding code to understand intent
2. Check correctness — Logic, edge cases, error handling, off-by-one errors
3. Check VS Code conventions — Naming, disposables, layering, localization, style, accessibility
4. Check security — OWASP Top 10 where relevant
5. Check testing — Disposable leak checks, coverage of new behavior

VS Code Conventions Checklist

Indentation

• Use tabs, not spaces

Naming

• Classes, interfaces, enums, type aliases: PascalCase
• Interfaces: prefix with I (e.g., IDisposable, IEditorService)
• Enum values: PascalCase
• Functions, methods, properties, local variables: camelCase
• Private/protected members: prefix with _ (e.g., private _myField)
• Service decorators: createDecorator<IServiceName>('serviceName')
• Use whole words in names when possible

Strings

• Use "double quotes" for user-facing strings that need localization
• Use 'single quotes' for everything else
• All user-visible strings must use localize() or nls.localize()
• Never concatenate localized strings — use placeholders ({0}, {1})

UI Labels

• Title-style capitalization for command labels, buttons, and menu items
• Don't capitalize prepositions of four or fewer letters unless first or last word

Types

• Don't export types or functions unless shared across multiple components
• Don't introduce new types or values to the global namespace
• Don't use any or unknown unless absolutely necessary — define proper types

Comments

• Use JSDoc style comments for functions, interfaces, enums, and classes

Style

• Prefer arrow functions => over anonymous function expressions
• Only surround arrow function parameters when necessary (x => x not (x) => x, but (x, y) => x + y is fine)
• Always surround loop and conditional bodies with curly braces
• Open curly braces on the same line as the statement
• Prefer top-level export function x() {} over export const x = () => {} (better stack traces)
• Prefer async/await over .then() chains
• Prefer named regex capture groups over numbered ones