StateScope

Read and audit finite state machines without leaving VS Code.

StateScope renders IBM FTM / Eclipse UML2 .emx state machine models as interactive, audit-friendly UML state diagrams inside VS Code. Built for enterprise payments and operations engineering teams migrating off IBM RSAD / Eclipse.

StateScope is the sibling of FlowScope — they share design tokens and iconography, but each extension owns its accent color (StateScope blue, FlowScope green). Together they replace the aging IBM ACE + RSAD toolchain.

Features

FSM Viewer (.emx)

• Zero-config — open an .emx file, see the graph.
• Pan, zoom (Ctrl/Cmd + scroll), fit to view.
• Click a state to inspect stereotype, constraints, description, and every incoming/outgoing transition (guard, action, target).
• FSM selector dropdown to switch between multiple state machines in one file.
• Sugiyama layered layout for clean, readable graphs.

Views

Stereotype palette

Supported files

Installation

From VSIX

code --install-extension statescope-*.vsix

From source

git clone https://github.com/ShoaibKhan/StateScope.git
cd StateScope
npm install
npm run compile
npm run package
code --install-extension statescope-*.vsix

Usage

• Automatic: open any .emx file — StateScope is the default editor.
• Command Palette: Cmd/Ctrl+Shift+P → StateScope: Open in StateScope
• Context menu: right-click an .emx file in the Explorer.

Sample files

See samples/ for TxnFSM_SWIFT_OUT.emx — two FSMs including alerts, operator resolution, and terminal states.

Tech

• TypeScript extension host, no runtime dependencies.
• SVG rendered in a CSP-locked webview (nonce-gated scripts, localResourceRoots scoped to media/).
• Sugiyama-style layered layout in pure TS.

Security posture

• Webview scripts run under a strict Content-Security-Policy with a per-load nonce; no remote resources loaded.
• No runtime npm dependencies; no eval, no new Function, no innerHTML sinks for untrusted content.
• Read-only editor: file contents are parsed locally and never transmitted.
• Suitable for deployment inside regulated environments (financial institutions, air-gapped networks).

License

MIT

Part of the Scope Suite (StateScope + FlowScope). Built for enterprise devs who need IBM ACE / RSAD visibility without the Eclipse tax.