WoGu

Open source · Apache 2.0

Workflow correctness for Temporal.

Detect determinism violations, retry policy issues, timeout misconfigurations, workflow anti-patterns, and workflow best-practice violations before deployment.

wogu — scan
$./mvnw wogu:scan
26 rules executed
Determinism validation passed
Retry policy validated
Timeout validation passed
Workflow ready

Why WoGu

Workflow quality checked at build time, not discovered in production

WoGu plugs into your build the same way a coverage or static-analysis gate does, and fails it when workflow code violates a correctness rule — before it ever reaches a worker.

Determinism validation

Flags non-deterministic APIs reachable from a workflow's entry point — random values, wall-clock reads, blocking sleeps, and unmanaged threads.

Call graph analysis

Follows every resolvable method call from a workflow's entry point, however many hops deep, and stops precisely at an Activity boundary.

Build-time quality gate

Bound to mvn verify or gradle build by default, so a violation fails the build instead of shipping quietly.

Extensible rule engine

Most rules are declarative YAML evaluated by a generic rule executor — adding one never touches the core engine.

Zero-config defaults

Add the plugin and run your build. The default rule set requires no configuration to start catching violations.

Self-contained reports

A single HTML report renders every violation with its full call path, alongside your console build output.

Integration

Drops into the build you already have

Maven, Gradle, the CLI output your build already prints, and a CI workflow that fails on a real violation.

pom.xml
<plugin>
  <groupId>io.github.vikas0686</groupId>
  <artifactId>wogu-maven-plugin</artifactId>
  <version>0.1.0</version>
  <executions>
    <execution>
      <goals>
        <goal>validate</goal>
      </goals>
    </execution>
  </executions>
</plugin>

Roadmap

Built for Java today, designed for more

WoGu's core engine has zero dependency on Temporal or Java specifically — new rules, and new workflow engines and languages, are additive.

View full roadmap
  1. Java (Temporal Java SDK)

    Available

    Ten Determinism rules (WG001–WG010) shipped in v0.1, built on recursive call-graph analysis across the workflow's full reachable call graph.

  2. Custom Rules

    In Progress

    Declarative YAML rules for method and constructor patterns today; a CustomRule extension point for analysis that goes beyond a single call pattern.

  3. SARIF Reports

    Planned

    Standard SARIF output alongside the HTML report, for GitHub code scanning and other static-analysis tooling.

  4. Spring Boot

    Planned

    First-class support for Temporal workers wired through Spring Boot's dependency injection and configuration.

Community

Open source and built in the open

Every rule, every line of the engine, and every report template lives in the public repository.

Catch workflow bugs before they ship.

Add WoGu to your build in a few minutes. No configuration required for the default rule set.