P2P2P Project |

PlusCal to PlantUML to PDF

Explore Project

Project Overview

Mission Statement

Automating the generation of visual diagrams from formal specifications to bridge the gap between formal verification and stakeholder communication at SanDisk Corporation.

The Challenge

SanDisk has launched an initiative to write designs using TLA+ (Temporal Logic of Actions) for formal verification. However, design artifacts need to be shared between teams who are more comfortable with visual formats like flowcharts and UML diagrams rather than pseudo code.

Our Solution

We're developing an automated pipeline that:

  • Takes PlusCal pseudo code as input
  • Generates PlantUML sequence and activity diagrams
  • Produces locked PDFs only when the PlusCal passes model-checking
  • Ensures synchronization between PlusCal and PlantUML contexts

Impact

This breakthrough will benefit SanDisk in three important ways:

  • Time Reduction: Significantly reduce time required to create formally verified visual figures
  • Adoption Encouragement: Help firmware engineers adopt PlusCal as a stepping-stone to TLA+
  • Culture Change: Foster a culture of formal methods adoption within SanDisk's design process

Project Details

Background

SanDisk is serious about the quality of their popular storage products and strives to be best-in-class in upholding their global brand. The company has moved toward formal verification using TLA+ to catch subtle bugs that traditional review processes miss.

Technical Requirements

  • Parse and analyze PlusCal pseudo code specifications
  • Generate PlantUML sequence diagrams from PlusCal algorithms
  • Generate PlantUML activity diagrams showing system flow
  • Integrate with TLA+ model checker for verification
  • Produce locked PDF documents with LaTeX formatting
  • Ensure synchronization between PlusCal source and generated diagrams

Deliverables

  • Complete and well-commented codebase
  • Detailed documentation and reference manual
  • GitHub repository with development history
  • Professional literature for SanDisk product teams

Academic Significance

This project exposes students to cutting-edge formal methods invented by Leslie Lamport (ACM Turing Award winner), used by major companies like AWS, Microsoft, Oracle, Google, LinkedIn, MongoDB, and others. There's potential for grant funding from the TLA+ Foundation.

Technologies & Tools

TLA+ (Temporal Logic of Actions): Mathematical specification language for concurrent and distributed systems, invented by Leslie Lamport
PlusCal: Higher-level pseudo code language that compiles to TLA+, more approachable for firmware engineers
PlantUML: Tool for generating UML sequence diagrams, activity diagrams, and flowcharts from textual descriptions
LaTeX & LuaLaTeX: Document preparation system for high-quality typesetting and PDF generation
Rust (Preferred) or Python: Primary programming languages for implementation
VSCode Extensions: TLA+ extension, LaTeX Workshop, Rust-analyzer, PlantUML, Graphviz Interactive Preview
Supporting Tools: OpenJDK ≥11.0.6, MiKTeX ≥25.3, Adobe Acrobat Reader, Git & GitHub

Project Timeline

September 2025: something...
October 2025: something...
November 2025: something...
December 2025: something...
January 2026: something...
February 2026: something...
March 2026: something...

Project Documentation

Academic Resources

  • Project Specification Document
  • Requirements Analysis Report
  • Architecture Design Document
  • Progress Reports (Monthly)

Meet Our Team

Juan José Serrano
Juan José Serrano Mora
Backend Developer & Formal Verification Specialist
TLA+ Specification Backend Development Protocol Design
Alejandro Benito
Alejandro Benito
Systems Architect & Documentation Lead
System Architecture Technical Documentation LaTeX & PlantUML
Jackson Belzer
Jackson Belzer
Implementation Lead & Testing Coordinator
Implementation Testing & Validation Performance Analysis
Christian Lamb
Christian Lamb
Quality Assurance & Integration Specialist
Quality Assurance System Integration Continuous Integration

Meet Our Supervisors

Chris Ortiz
Chris Ortiz
Industry Sponsor & Senior Technologist
Industry Expertise Senior Technologist SanDisk
O
Ogonna
University Supervisor & Academic Mentor
Academic Supervision Project Guidance Northern Arizona University

Get In Touch

Primary Contact jsb536@nau.edu
University Northern Arizona University
Semester Fall 2025 - Spring 2026
Industry Partner SanDisk Corporation
Project Progress 15%