Validate a pipeline application change
Goal
Turn a pipeline application edit into one coherent, verifiable repository change that is ready for managed publication.
Prerequisites
- an onboarded application repository;
- a checked-in Rust serde record type;
- a pipeline manifest and its transform code;
- focused tests for the changed behavior.
Steps
- Confirm the Rust schema change is additive, keeps stable identity fields, and gives newly persisted fields compatible serde defaults or optionality.
- Check that every persisted row has a stable dataset reference and primary key.
- Validate the pipeline TOML with the repository's manifest test target.
- Run the transform's focused test with a bounded timeout.
- Regenerate any reference artifact owned by the repository and run its drift check.
- Open one pull request containing schema, manifest, transform, tests, and docs.
For this monorepo, the focused commands follow this shape:
timeout 300 rac cargo test -p <changed-crate>
node docs/scripts/gen-route-reference.mjs --check
Use the commands supplied by an external application's repository when its layout differs.
Expected result
The manifest parses and lowers, the transform test passes, generated references match their sources, and the pull request shows the intended route and dataset changes together.
Failure modes
| Symptom | Check |
|---|---|
| Unknown manifest field | Compare the edit with the pipeline preview and repository schema |
| Missing dataset | Confirm onboarding has provisioned the typed dataset |
| Generated docs drift | Run the repository's generator, inspect the diff, then rerun check mode |
| Route works but is absent from public reference | Public documentation requires separate contract review and allowlisting |
Reference
Continue with Build a vertical and Scaffold a narrow app.
Delegate a task to another agent
Send bounded work to an assisting agent through customer REST control or an authorized managed agent-cli environment.
Verify a managed application deployment
Follow a reviewed application change from repository checks to a managed deployment without relying on cluster access.