Repository navigation
Write the V1 semantics and name their tests - #21
Merged
Merged
Conversation
Work in progress, held until the Grafana, sources and renderer steps land so the page can name real tests and fixtures. Not pushed. Signed-off-by: VirtualMachinist <252028890+VirtualMachinist@users.noreply.github.com>
Unhealthy Grafana is exit 4 with an error line and empty stdout; the health document prints only when healthy, and sources shows the unhealthy state as data. A missing or unexpected --host is exit 3. An empty query result is an answer. Not pushed: held until the Grafana, sources and renderer steps land. Signed-off-by: VirtualMachinist <252028890+VirtualMachinist@users.noreply.github.com>
Signed-off-by: VirtualMachinist <252028890+VirtualMachinist@users.noreply.github.com>
Each V1 rule in docs/semantics.md now names the test that proves it and the fixture or recorded answer it runs on: the bounded client and its shared limiter, the named-query rules, what the Prometheus commands may print, the Grafana health table, the CLI contract, the per-command exit table and the overlay. A new section describes the sources listing, which the page lacked: one row per configured backend, how a row is checked, a down backend as data with exit 0, last_ok null in V1, and authority rows deferred to V2 and V5. The fixture index gains a table of the V1 fixture directories. The page follows the PM rulings: an unhealthy Grafana is exit 4 with one error line and empty stdout, a missing or unexpected --host is exit 3, an empty query result is an answer, and the schema count is nine. A new test fails if the page names a test, a fuzz target or a tracked path that the tree does not have, and a second test plants a renamed test and a moved fixture to show the check bites. Signed-off-by: VirtualMachinist <252028890+VirtualMachinist@users.noreply.github.com>
Signed-off-by: VirtualMachinist <252028890+VirtualMachinist@users.noreply.github.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
V1 checkpoint G4a:
docs/semantics.md.--nowand error contract;internal/exitcode/semantics_names_test.gofails if the page names a test, fuzz target or tracked path that doesn't exist, and a planted case proves the guard bites.🤖 Generated with Claude Code