__init__.py
python
| 1 | """Muse Tier 1 plumbing commands — machine-readable, pipeable, stable primitives. |
| 2 | |
| 3 | Every command in this package: |
| 4 | |
| 5 | - Emits JSON by default (machine-stable schema with ``format_version``). |
| 6 | - Accepts ``--format text`` for human-readable output where meaningful. |
| 7 | - Never prompts for input or confirmation. |
| 8 | - Uses strict exit codes: 0 success, 1 user error, 3 internal error. |
| 9 | - Is pipeable — stdin/stdout friendly, no interactive elements. |
| 10 | |
| 11 | These are the atoms from which Tier 2 porcelain commands are composed, and the |
| 12 | surface that MuseHub, agent orchestrators, and shell scripts can rely on to |
| 13 | remain stable across Muse versions. |
| 14 | """ |