Skip to content

refactor(dialects): fold the evidence directory into fixtures #29

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
soulbah merged 1 commit into from
Oct 10, 2026
Merged

refactor(dialects): fold the evidence directory into fixtures #29

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
14 changes: 11 additions & 3 deletions dialects/README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -5,8 +5,11 @@ with Rootform. Each owner keeps its own semantic version and content identity;
there is no collection version.

Sources use the native `.rf.hcl` format. `dialects.json` is the release-set
inventory used to build Rootform's embedded semantics. `evidence/` and
`fixtures/` hold public validation evidence for these sources.
inventory used to build Rootform's embedded semantics. `fixtures/` holds the
Terraform configurations that validate these sources.
`provider-registry-equivalence.json` records, for each provider a Dialect binds
without a registry host, the release archive digests showing that the
Terraform and OpenTofu registries serve the same provider.

Third-party Dialects and explicit replacements use the OCI distribution
contract documented by the parent Rootform repository. They are not copied
Expand Down Expand Up @@ -49,7 +52,12 @@ without planning:
ROOTFORM_BIN=/path/to/rootform bun run update:goldens
```

`evidence/plan-fixture-inventory.json` lists every fixture with the digest of
`fixtures/expectations/<dialect>.json` holds the reviewed scenarios of each
Dialect: the fixture a scenario uses and what its recorded analysis must and
must not contain. `ROOTFORM_BIN=/path/to/rootform bun run verify:dialects`
replays the fixtures and checks every statement against their goldens.

`fixtures/inventory.json` lists every fixture with the digest of
its source, its providers and its outcome. A fixture that cannot plan offline
keeps its source, records why with the status `not_planned`, and proves nothing:
verification reports every scenario naming it as not verified. Resource types a
Expand Down
8 changes: 4 additions & 4 deletions dialects/THIRD_PARTY_NOTICES.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -9,7 +9,7 @@ This repository contains no vendor logo or icon files. Each
approved visual assets remain in the proprietary Rootform renderer under their
original terms.

Provider baselines and compatibility evidence summarize public APIs and public
documentation. Upstream source URLs and versions are recorded in each
`evidence/<dialect>/` directory. Upstream code is not copied into this
repository.
Each Dialect names the provider source and version it reads in its
`dialect.rf.hcl`, and `provider-registry-equivalence.json` records the
digests of the provider release archives checked for those versions. Upstream
code is not copied into this repository.
Loading
Loading