stuart/databuild
1
1
Fork 0
Code Issues 1 Pull requests Projects Releases Packages Wiki Activity Actions

Prepare for job wrapper implementation
Some checks failed
/ setup (push) Has been cancelled
Details

Browse source
This commit is contained in:
Stuart Axelbrooke 2025-07-26 22:57:27 -07:00
parent b0d9308a75
commit 49e0953c4a
1 changed files with 10 additions and 1 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

11
plans/job-wrapper.md
View file

@ -1,5 +1,15 @@
# Job Wrapper v2 Plan # Job Wrapper v2 Plan
## Required Reading
Before implementing this plan, engineers should thoroughly understand these design documents:
- **[DESIGN.md](../DESIGN.md)** - Overall DataBuild architecture and job execution model
- **[design/core-build.md](../design/core-build.md)** - Core build semantics and job lifecycle state machines
- **[design/observability.md](../design/observability.md)** - Observability strategy and telemetry requirements
- **[design/build-event-log.md](../design/build-event-log.md)** - Event sourcing model and BEL integration
- **[databuild.proto](../databuild/databuild.proto)** - System interfaces and data structures
## Overview ## Overview
The job wrapper is a critical component that mediates between DataBuild graphs and job executables, providing observability, error handling, and state management. This plan describes the next generation job wrapper implementation in Rust. The job wrapper is a critical component that mediates between DataBuild graphs and job executables, providing observability, error handling, and state management. This plan describes the next generation job wrapper implementation in Rust.
@ -236,7 +246,6 @@ To prevent log flooding:
### Phase 0: Minimal Bootstrap ### Phase 0: Minimal Bootstrap
Implement the absolute minimum to unblock development and testing: Implement the absolute minimum to unblock development and testing:
- Simple JSON-based logging (no protobuf yet)
- Basic wrapper that only handles happy path - Basic wrapper that only handles happy path
- Support for local execution only - Support for local execution only
- Minimal log parsing in graph - Minimal log parsing in graph