Duolith docs

Errors E0500 to E0599

E0560 Pack that cannot be read

Message pack/pack.yaml: problem

Words in italics are filled in when the compiler reports it, such as the element's name or the list of known ones.

Why

Each folder in packs/ with a pack.yaml is one of the app's packs (decision 0160), and an installed package's packs are listed in its package.json under duolith.packs. The file must be YAML that pack.schema.json describes: a topic of lower-case words, a description starting "Use when", optional scope, owns and extends, and rules, each with an id, the sentence it says, why it exists, and one check (classes, tokens, parts, imports, elements, style-blocks, files, lint, or none) or the codes it is enforced by; a rule that is checked needs bad and good examples, or a reason it has none (no-example). A pack that cannot be read would leave its conventions unchecked and its agent without instructions, so every build stops on it.

How to fix it

Correct pack.yaml where the message says; it names the setting and the closest correct name. duolith packs new <topic> writes a pack that reads.

In a terminal

duolith explain E0560

Mentioned in