initial commit

_bmad-output/implementation-artifacts/11-5-distribution.md

@@ -0,0 +1,36 @@
+---
+epic: 11
+story: 11.5
+title: "Distribution"
+status: draft
+---
+
+## Epic 11 — CLI Tool
+**Goal:** Command-line tool for scripting and automation, same Rust engine.
+
+### Story 11.5: Distribution
+
+As a user,
+I want to install CalcPad CLI easily on my platform,
+So that I can get started without complex build steps.
+
+**Acceptance Criteria:**
+
+**Given** a user has Rust and Cargo installed
+**When** they run `cargo install calcpad-cli`
+**Then** the CLI binary is compiled and installed into their Cargo bin directory
+**And** running `calcpad --version` outputs the installed version
+
+**Given** a macOS user has Homebrew installed
+**When** they run `brew install calcpad`
+**Then** the CLI binary is installed and available on their PATH
+**And** running `calcpad --version` outputs the installed version
+
+**Given** the CLI is compiled for a target platform
+**When** the binary is produced
+**Then** it is a single statically-linked binary with no runtime dependencies
+**And** the binary size is less than 5MB
+
+**Given** a user downloads the pre-built binary for their platform (macOS, Linux, Windows)
+**When** they place it on their PATH and run `calcpad --help`
+**Then** usage information is displayed with all supported flags and subcommands