README.md

# distributor

`distributor` validates manifested report bundles, plans destination updates, and publishes selected source files or generated HTML outputs to configured destinations.

It is a local-first Go CLI for report distribution. A pipeline reads one source bundle tree, validates `manifest.json`, fans out to one or more local, SSH/SFTP, or S3-compatible destinations, records destination state in `.distributor.json`, and can also accept authenticated tar or tar.gz uploads through the HTTP upload server.

Run the maintained local example:

```sh
go run ./cmd/distributor run --config examples/local-publish.yml
```

Go producers can use `gitea.maximumdirect.net/eric/distributor/pkg/upload` and `gitea.maximumdirect.net/eric/distributor/pkg/bundle` to submit compatible bundles to `distributor serve`. See [Upstream producer integration](docs/consumers/api.md).

- [CLI reference](docs/cli.md)
- [Configuration reference](docs/config.md)
- [Operations guide](docs/operations.md)
- [Consumer API guide](docs/consumers/api.md)
- [Troubleshooting](docs/troubleshooting.md)
- [Integration contracts](docs/integrations/source-bundle.md)
- [Development architecture](docs/policy/architecture.md)
Final cleanup before beginning the MVP implementation 2026-05-30 20:33:53 -05:00			`# distributor`
Initial commit 2026-05-30 21:59:32 +00:00
Refresh README and CLI documentation 2026-06-04 12:04:42 +00:00			`distributor` validates manifested report bundles, plans destination updates, and publishes selected source files or generated HTML outputs to configured destinations.
Tighten local MVP user documentation 2026-05-31 04:02:09 +00:00
Refresh README and CLI documentation 2026-06-04 12:04:42 +00:00			It is a local-first Go CLI for report distribution. A pipeline reads one source bundle tree, validates `manifest.json`, fans out to one or more local, SSH/SFTP, or S3-compatible destinations, records destination state in `.distributor.json`, and can also accept authenticated tar or tar.gz uploads through the HTTP upload server.
Final cleanup before beginning the MVP implementation 2026-05-30 20:33:53 -05:00
Refresh README and CLI documentation 2026-06-04 12:04:42 +00:00			`Run the maintained local example:`
Add initial distributor CLI skeleton 2026-05-31 01:47:39 +00:00
			```sh
Add local source publication 2026-05-31 02:21:36 +00:00			`go run ./cmd/distributor run --config examples/local-publish.yml`
Add initial distributor CLI skeleton 2026-05-31 01:47:39 +00:00			```

Update documentation relating to the public packages and http_upload API 2026-06-07 13:33:27 -05:00			Go producers can use `gitea.maximumdirect.net/eric/distributor/pkg/upload` and `gitea.maximumdirect.net/eric/distributor/pkg/bundle` to submit compatible bundles to `distributor serve`. See [Upstream producer integration](docs/consumers/api.md).
Refresh README and CLI documentation 2026-06-04 12:04:42 +00:00
			`- [CLI reference](docs/cli.md)`
			`- [Configuration reference](docs/config.md)`
			`- [Operations guide](docs/operations.md)`
Update documentation relating to the public packages and http_upload API 2026-06-07 13:33:27 -05:00			`- [Consumer API guide](docs/consumers/api.md)`
Refresh README and CLI documentation 2026-06-04 12:04:42 +00:00			`- [Troubleshooting](docs/troubleshooting.md)`
Add integration contract documentation 2026-06-04 12:15:21 +00:00			`- [Integration contracts](docs/integrations/source-bundle.md)`
Refresh README and CLI documentation 2026-06-04 12:04:42 +00:00			`- [Development architecture](docs/policy/architecture.md)`