Skip to content

Unknown configuration keys are errors

Unknown configuration keys are errors

majordomus://rule/project.unknown-keys-are-errors@1active schema

Rationale

A key nobody reads is a typo that silently does nothing, which is worse than a refusal; the allowlists under share/allow/ are the schema, and a field written and never read is a second source of truth.

Required behaviour

Every configuration file rejects a key nothing reads, and every state field is both written and read.

Failure behaviour

No command decides this rule; a reviewer does, and a change that violates it is not merged. Where a behavioural case covers part of it, that case is named below.

Verification

Review. test/cases/00_yaml_flatten.sh and the policy, profile, manifest and rule allowlists under share/allow/.

Where this comes from

canonical file
.ai/repo/rules/project/unknown-keys-are-errors.v1.md
identity
project.unknown-keys-are-errors@1
also served as
MCP resource majordomus://rule/project.unknown-keys-are-errors@1 · majordomus entity show rule/project-unknown-keys-are-errors-1 · GET /api/v1/entity?uri=majordomus://rule/project.unknown-keys-are-errors@1
in the Cockpit
/cockpit/objects/rule/project-unknown-keys-are-errors-1

This page is generated from the file above by scripts/generate-site-data; editing the page changes nothing, editing the file changes every surface. The relations above are edges of docs/generated/graph.json, which the executable writes from the same index.

Searches the titles and descriptions of every page this site publishes.