pennon

Not yet released. This version reserves the name; the first working release follows docs/intents/cli-style/.

A pennon is the long, narrow flag that carries your colours — on a knight's lance, at a ship's masthead. Its whole purpose is colour as identity. That is what this package is for a command-line program: not red and blue, but error, hint, command and flag, the colours that mean you, declared once as a theme.

What it will be

• One output policy, decided once from the runtime: tty, pipe, json, accessible or ci. Every component reads it; none detects the terminal on its own.
• Semantic tokens over util.styleText, silent under every mode but tty.
• A theme that changes every token at once, contrast-checked when it emits truecolor.
• pennon/chalk — chalk's API over Node natives, graded by chalk's own test suite, so a migration is one import and your tests are unchanged.
• Zero dependencies, and every subpath measured against the lightest incumbent it replaces.

Part of the burgee family: a CLI on burgee declares what it is, pennon gives it colours, halyard flies it, answering is how it replies. Each is an independent package; none requires the others.