feat(scenarios): expand to 10 total scenarios + CLI external scenario files

[sepehr-safari]

Summary

Expands from 5 to 10 total scenarios and adds CLI support for external scenario files.

New Scenarios

Scenario	Expected Failure	Description
meter-value-gap	METER_VALUE_GAP	Transaction with no MeterValues
invalid-stop-reason	INVALID_STOP_REASON	StopTransaction with invalid 'PowerSurge' reason
unexpected-start	UNEXPECTED_START	StartTransaction without BootNotification/Authorize
status-transition-violation	STATUS_TRANSITION_VIOLATION	Available -> Finishing (illegal transition)
diagnostics-failure	DIAGNOSTICS_FAILURE	DiagnosticsStatusNotification with DiagnosisFailed

CLI External Scenario Files

ocpp-debugkit scenario run --file ./my-scenario.json

The external file must be a JSON object with name, description, trace, and expectedFailures fields (same shape as built-in scenarios).

Changes

• 5 new scenario fixtures in packages/toolkit/src/scenarios/__scenarios__/
• Updated index.ts registry to export all 10 scenarios
• Updated index.test.ts — 36 tests (10 scenarios, engine integration for each, synthetic data policy)
• Refactored scenario.ts — shared runScenarioInternal(), new scenarioRunFileCommand()
• Updated cli/index.ts — run [name] with --file option

Verification

• ✅ pnpm test — 295/295 tests pass
• ✅ pnpm build — clean
• ✅ pnpm lint — clean
• ✅ pnpm typecheck — clean
• ✅ pnpm format:check — clean

Closes #60

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
ocpp-debugkit-web	Ready	Preview, Comment	Jul 8, 2026 6:25pm