With Rustberg

Bergman and Rustberg: a maintenance engine and a governing catalog, designed to pair and fully usable apart.

Rustberg is the sister project: an authenticated, Cedar-policy-controlled Iceberg REST catalog. Rustberg leaves maintenance to an external engine; Bergman is that engine. Each works fully without the other.

The contract is the wire

Bergman reaches Rustberg as an ordinary Iceberg REST client — no private API, no shared types:

[[catalogs]]
name      = "prod"
kind      = "rest"
uri       = "https://rustberg.internal/catalog"
token_env = "BERGMAN_CATALOG_TOKEN"

That is the whole integration.

What the pairing adds

A named principal

Bergman authenticates as its own identity, granted Read and Update on the subtrees its rules cover:

permit(
  principal == Rustberg::User::"svc-bergman",
  action    in [Rustberg::Action::"Read", Rustberg::Action::"Update"],
  resource  in Rustberg::Namespace::"acme\u{1F}analytics"
);

Every maintenance commit is authorized per operation and lands in Rustberg's audit trail under that principal.

No ambient storage credential

With credential vending, Bergman holds no storage keys: Rustberg vends short-lived, table-prefix-scoped credentials, write-scoped when Bergman may Update.

Restricted tables fail safe

Compaction must read every row; rewriting through a row filter would destroy the rows it hides. Rustberg refuses to vend credentials or sign requests for a caller whose permits carry a @row_filter or @column_mask, so a mis-scoped principal cannot half-read a table into a rewrite; the refusal is reported. Give the maintenance principal no row filter or column mask.

Joined audit trails

Bergman's JSONL trail records why — rule, trigger, measurement. Rustberg's records who was allowed to — principal, decision, matched Cedar policies. Bergman sends its run id as X-Request-Id on every commit it authors, the same id its own audit records carry, and X-Bergman-Operation names the operation. One grep joins the two logs.

Snapshot expiration sits outside the join: it commits through upstream's action and carries no header (Status). Those commits are still authorized and audited under the same principal.

Licensing

Rustberg is Apache-2.0. Bergman is Apache-2.0 OR MIT.