eric/distributor
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 7 Wiki Activity

Update and refine the implementation roadmap

Browse Source
This commit is contained in:
Eric Rakestraw
2026-05-30 20:25:59 -05:00
parent 47c9c5c0d1
commit 39548cefbe
5 changed files with 336 additions and 144 deletions
Download Patch File Download Diff File Expand all files Collapse all files

8
docs/roadmap/contracts.md
View File

@@ -13,6 +13,8 @@ The MVP contract has two durable files:
`manifest.json` is not copied to the destination as destination state. Instead, `.distributor.json` records the normalized source manifest, generated output metadata, and distributor-owned publication metadata.
All manifest and state timestamps should be serialized as RFC3339. Internal comparison should use parsed timestamp values, and distributor-written timestamps should be normalized to RFC3339 UTC.
## Terminology
- **Source root**: Configured root path for a pipeline source.
@@ -227,6 +229,12 @@ If no `.distributor.json` exists and the destination path is non-empty:
Local destination paths are empty when the destination bundle directory does not exist or exists with no entries. S3-compatible destination prefixes are empty when no objects exist below the destination bundle prefix, ignoring objects outside that exact prefix.
### Pipeline or destination mismatch
If `.distributor.json` exists but its `pipeline_id` or `destination_id` differs from the current pipeline or destination config:
- Fail as a conflict.
### Same source manifest
If `.distributor.json` exists and `source.manifest` exactly matches the current normalized source manifest: