https://barn.pgsty.com/tags/compatibility/ Recent content in Compatibility on Barn Hugo en-US Mon, 09 Nov 2026 00:00:00 +0800 https://barn.pgsty.com/blog/design/cli-contracts/ Wed, 04 Nov 2026 10:00:00 +0800 https://barn.pgsty.com/blog/design/cli-contracts/ <p>Barn already uses Cobra. The useful part of the 2026-11-04 CLI proposal is its separation of command syntax, application orchestration, and observable behavior. This essay retains that design, checked against <code>v1.1.0</code> on 2026-11-09. The package split and broader command reorganization remain proposals; current usage belongs in the <a href="https://barn.pgsty.com/docs/reference/cli/">CLI reference</a>.</p> <h2 id="existing-boundaries">Keep the existing boundaries </h2> <p><code>cmd/barn/command_*.go</code> defines the command families. Each execution constructs a fresh Cobra tree, avoiding flag values leaking between calls. Command handlers collect a <code>commandOutcome</code>; a shared renderer handles text or structured results, while typed failures retain their exit code, reason, recovery hint, and any partial result. Linux lifecycle, image verification, and native Mac behavior remain in their domain packages.</p>