Instruction file imported from SafetyMP/CorpOS (.github/instructions/typescript.instructions.md). Copyright stays with the author.

TypeScript coding standards (September 2026)

Name: typescript
Author: SafetyMP

Write TypeScript, not new application JavaScript. Leave existing tooling .js / .mjs / .cjs files alone.
Place imports at the top of the module. Do not use inline import() in function bodies except for a documented circular-dependency or optional-runtime case.
Prefer early returns over nested conditionals.
On switch over a discriminated union or enum, handle every variant. Use a never check in default so newly added variants fail at compile time.
Do not introduce any in new production code. Prefer unknown plus narrowing. Do not use non-null assertions to silence strict or noUncheckedIndexedAccess.
Match this repository's existing formatter and linter. Do not add a second style system.
Keep public unions narrow. Do not widen a literal union to string without a spec change.
Do not weaken fail-closed, human-in-the-loop, tenancy, or verify gates to make types compile.

This repository

Firm logic in packages/core, HTTP in apps/api (Hono), UI in apps/console (Vite + Preact).
Do not introduce Express or better-sqlite3.
Do not add LangGraph, CrewAI, or other graph/crew runtimes.
Exception HITL stays default-off. Only tests/CI may pass autoApproveException: true.
Never set CORPOS_ALLOW_LIVE in CI. Default provider is SimulationProvider.