Architecture

wolfcola devtools is organized into two tool families: OIDC DevTools for debugging authentication flows, and Tree-Shake Tools for verifying that packages are tree-shakeable by bundlers like Rollup.

OIDC DevTools

@wolfcola/devtools-types

Effect Schema definitions for AuthEvent and FlowState. The shared foundation that all other OIDC packages depend on.

@wolfcola/devtools-core

Shared annotators (OIDC phase detection, CORS, DPoP, PAR), diagnosis engine, event store, and export/redaction logic. Used by both the browser extension and VS Code extension.

@wolfcola/devtools-bridge

SDK adapter for emitting events from DaVinci, Journey, and OIDC clients. Connects to the browser extension or standalone debugger. Depends on devtools-types.

@wolfcola/devtools-standalone

Standalone Electron debugger with WebSocket server and MCP integration. Uses devtools-core for event processing and devtools-ui for the Elm panel.

@wolfcola/devtools-ui

Elm UI components for Timeline, Flow, and Learn views. Provides the panel interface with inspector tabs, playback controls, and diagnosis display.

@wolfcola/devtools-extension

Chrome and Firefox browser extension. Bundles devtools-core and devtools-ui into a DevTools panel with network-first OIDC detection.

oidc-devtools (VS Code)

VS Code extension that connects via Chrome DevTools Protocol (CDP) for live auth traffic capture and flow visualization.

Tree-Shake Tools

@wolfcola/treeshake-check

CLI & library to verify packages are tree-shakeable by Rollup. Standalone package.

@wolfcola/eslint-plugin-treeshake

ESLint plugin that flags tree-breaking patterns. Can use treeshake-check for bundle-level verification.

Utilities

@wolfcola/dead-export-finder

CLI to find unused exports across monorepo package boundaries. Uses oxc-parser for fast AST analysis.

@wolfcola/changeset-sync-manifest

Internal CI tool that syncs package version from changesets to manifest files. Not documented on the docs site.