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

revert assumption about data dep stability, update AGENTS.md

Browse source
This commit is contained in:
Stuart Axelbrooke 2025-12-01 00:33:57 +08:00
parent 23c3572106
commit 421544786f
2 changed files with 1 additions and 1 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

1
AGENTS.md
View file

@ -40,6 +40,7 @@ This architecture provides compile-time correctness, observability through event
- Compile time correctness is a super-power, and investment in it speeds up flywheel for development and user value.
- **CLI/Service Interchangeability**: Both the CLI and service must produce identical artifacts (BEL events, logs, metrics, outputs) in the same locations. Users should be able to build with one interface and query/inspect results from the other seamlessly. This principle applies to all DataBuild operations, not just builds.
- The BEL represents real things that happen: job run processes that are started or fail, requests from the user, dep misses, etc.
- We focus on highly impactful tests anchored to stable interfaces. For instance, using BEL events to create valid application states to test orchestration logic via shared scenarios. This helps us keep a high ratio from "well tested functionality" to "test brittleness".
## Build & Test
```bash

1
DESIGN.md
View file

@ -68,5 +68,4 @@ What about situations where data is configured by a web app, etc? Taints are a g
## Assumptions
- Job -> partition relationships are canonical, job runs are idempotent
- The data deps / partitions read by a fully parameterized job run is consistent over time: same parameters = same read partitions