initial commit

_bmad-output/implementation-artifacts/7-9-alfred-raycast-extension.md

@@ -0,0 +1,37 @@
+---
+epic: 7
+story: 7.9
+title: "Alfred / Raycast Extension"
+status: draft
+---
+
+## Epic 7 — macOS App (Swift/SwiftUI)
+**Goal:** A beautiful, native macOS app that feels like it belongs on the platform.
+
+### Story 7.9: Alfred / Raycast Extension
+
+As a **macOS power user**,
+I want an Alfred or Raycast extension that evaluates CalcPad expressions inline,
+So that I can perform quick calculations from my launcher without opening the full app.
+
+**Acceptance Criteria:**
+
+**Given** the user has installed the CalcPad Alfred/Raycast extension
+**When** the user types `= 1920 / 3` or `calc 1920 / 3` in the launcher
+**Then** the CalcPad CLI (`calcpad-cli`) is invoked and the result `640` is displayed inline
+
+**Given** the extension shows a result
+**When** the user presses Enter
+**Then** the result is copied to the clipboard
+
+**Given** the user types an expression with units, e.g., `= 5 km to miles`
+**When** the extension evaluates it
+**Then** the result `3.10686 miles` is displayed inline
+
+**Given** the `calcpad-cli` binary is not installed or not found in PATH
+**When** the extension attempts to invoke it
+**Then** a helpful error message is displayed directing the user to install the CLI
+
+**Given** the user types an invalid expression
+**When** the extension evaluates it
+**Then** an error message is displayed inline (not a crash)