mangit955

The pre-commit verification gate for this repo. Run before every commit or push, after finishing any change, or when asked "is this ready", "check my work", "can I commit this". Runs the full test suite, type checks every workspace, validates docker compose,…

Checklists for changes that must be applied to BOTH the in-memory and production implementations in this repo. Read before adding or changing an API endpoint, a matching-engine event, a stream operation, a persistence operation, or a worker behavior. Triggers…

Mandatory invariants for any change touching balances, margin, locking/unlocking collateral, fills, positions, realized/unrealized PnL, fees, or the ledger. Read BEFORE editing prisma-api-runtime.ts, persistence-service.ts, prisma-persistence-store.ts, or…

Launch the Flux exchange locally or with full production wiring. Use when asked to run, start, boot, or demo the app, the API, the workers, the frontend, or the whole stack, or to verify a change works in the real app. Covers the RUNTIME_MODE split, Prisma…

Diagnose Redis Streams and outbox problems in this exchange - orders or cancels not processing, stuck messages, PEL limit errors, outbox events stuck PENDING or FAILED, broken consumer groups, orderbook not updating. Maps symptoms to the correct script in…

Use when adding a new tool to tools/, or changing an existing tool's name, parameters, description, or output shape. Covers the registry, the effects table, the generated docs surface, and the invariants a tool must hold (truncation, workspace containment,…

Use when changing anything that decides what goes into the prompt — runtime/loop.ts, runtime/compaction.ts, runtime/executionLog.ts, config/systemPrompt.ts, or buildRepositoryContext and recentMessages in config/config.ts. Requires a replay baseline captured…

Use when writing or changing any test file in this repository. Covers the module-mock trap that once made the whole suite green for the wrong reason, testing against real files instead of mocks, the environment a test runs in, and the sweep that proves the…

Use when changing how a shell command is judged or gated — anything under runtime/approval/, or the classification tables in runtime/toolEffects.ts. Fail-closed is the invariant, every change needs a fixture in both directions, and both operating systems'…

Use when starting work on the Nap repo, picking up the next task, or finishing a task — runs the session protocol from docs/PLAN.md §1. Invoke with "start" to claim the next eligible task, "finish" to close out the current one, or "wip" to stop mid-task.…

Use when writing or testing anything that emits, stores, orders, replays or renders Nap events — event schemas, sandbox-proxy tools, AgentService, Runtime, EventStore, EventBus, the WebSocket endpoint, or the chat pane. Applies to tasks M0-3, M2-5, M2-7,…