kahunas-cli 1.0.5 → 1.2.0

package/README.md

@@ -13,18 +13,12 @@ pnpm install
 pnpm build
 ```
 
-2) Log in once (opens a browser):
+2) Fetch data (browser login runs automatically on first run, headless by default):
 
 ```bash
-pnpm kahunas -- auth login
-```
-
-3) Fetch data:
-
-```bash
-pnpm kahunas -- checkins list
-pnpm kahunas -- workout list
-pnpm kahunas -- workout pick
+pnpm kahunas checkins list
+pnpm kahunas workout list
+pnpm kahunas workout pick
 ```
 
 You can also run without installing globally:
@@ -36,19 +30,6 @@ npx kahunas-cli workout events
 
 ## Commands
 
-### Auth
-
-- `kahunas auth login`
-  - Opens a browser, lets you log in, and saves the `auth-user-token`.
-- `kahunas auth status`
-  - Checks whether the stored token is valid.
-- `kahunas auth show`
-  - Prints the stored token.
-
-Tokens are saved to:
-
-- `~/.config/kahunas/config.json`
-
 ### Check-ins
 
 - `kahunas checkins list`
@@ -64,6 +45,8 @@ Tokens are saved to:
   - Loads the most recently updated program.
 - `kahunas workout events`
   - Lists workout log events with dates and a human-friendly workout summary (from the calendar endpoint).
+- `kahunas workout serve`
+  - Starts a local dev server with a workout preview page and a JSON endpoint that matches the CLI output.
 - `kahunas workout program <id>`
   - Fetches a program by UUID.
 
@@ -72,67 +55,86 @@ Tokens are saved to:
 If the API list is missing a program you see in the web UI, run:
 
 ```bash
-pnpm kahunas -- workout sync
+pnpm kahunas sync
 ```
 
-This opens a browser, you log in, then navigate to your workouts page. After you press Enter, the CLI captures the workout list from network responses and writes a cache:
+Or:
+
+```bash
+pnpm kahunas workout sync
+```
+
+This runs a browser session (headless by default). You log in, then navigate to your workouts page. After you press Enter, the CLI captures the workout list from network responses and writes a cache:
 
 - `~/.config/kahunas/workouts.json`
 
 `workout list`, `workout pick`, and `workout latest` automatically merge the API list with this cache.
 Raw output (`--raw`) prints the API response only.
 
+If you add `~/.config/kahunas/auth.json`, the browser flow will attempt an automatic login and open your workouts page before capturing. Example:
+
+```json
+{
+  "email": "you@example.com",
+  "password": "your-password"
+}
+```
+
+Keep this file private; it contains credentials.
+
+Optional fields:
+
+- `username` (use instead of `email`)
+- `loginPath` (default: `/dashboard`)
+
+If auto-capture does not find workouts, the CLI falls back to the manual prompt.
+
 ### Workout events (dates)
 
-To see when workouts happened, the calendar endpoint returns log events with timestamps. By default each event is summarized into a human-friendly structure (total volume sets, exercises, supersets). Use `--full` to return the full program payload (best effort; falls back to cached summary if needed).
+To see when workouts happened, the calendar endpoint returns log events with timestamps. The CLI returns the latest event summarized into a human-friendly structure (total volume sets, exercises, supersets). Use `--full` to return the full program payload (best effort; falls back to cached summary if needed).
 
 ```bash
-pnpm kahunas -- workout events --user <user-uuid>
+pnpm kahunas workout events
 ```
 
-Or via pnpm:
+Use `--minimal` to return the raw event objects without program enrichment. Use `--full` for full enriched output. Use `--debug-preview` to log where preview HTML was discovered (stderr only).
 
-```bash
-pnpm kahunas -- workout events
-```
+If the user UUID is missing, `workout events` will attempt to discover it from check-ins and save it.
 
-Default timezone is `Europe/London`. Override with `--timezone`.
+### Workout preview server
 
-You can filter by program or workout UUID:
+Run a local dev server to preview workouts in a browser:
 
 ```bash
-pnpm kahunas -- workout events --program <program-uuid>
-pnpm kahunas -- workout events --workout <workout-uuid>
+pnpm kahunas serve
 ```
 
-Use `--minimal` to return the raw event objects without program enrichment. Use `--full` to return the full enriched output. Use `--latest` for only the most recent event, or `--limit N` for the most recent N events. Use `--debug-preview` to log where preview HTML was discovered (stderr only).
+Or:
+
+```bash
+pnpm kahunas workout serve
+```
 
-If the user UUID is missing, `workout events` will attempt to discover it from check-ins and save it. You can also set it directly:
+The HTML page is available at `http://127.0.0.1:3000` and the JSON endpoint is at `http://127.0.0.1:3000/api/workout`.
+The JSON response matches the CLI output for `workout events`, so there is only one data shape to maintain.
 
-- `KAHUNAS_USER_UUID=...`
-- `--user <uuid>`
+Use `?day=<index>` to switch the selected workout day tab in the browser.
 
 ## Auto-login
 
-Most commands auto-login by default if a token is missing or expired. To disable:
+Most commands auto-login if a token is missing or expired. This runs a browser session and saves session details in `~/.config/kahunas/config.json` (headless by default). If `~/.config/kahunas/auth.json` is present, the login step is automated.
 
-```bash
-pnpm kahunas -- checkins list --no-auto-login
-```
+## Debug logging
 
-## Flags
+Set `debug` to `true` in `~/.config/kahunas/config.json` to enable extra logs on stderr (includes workout preview debug output).
 
-- `--raw` prints raw API responses (no formatting).
-- `--headless` runs Playwright without a visible browser window.
+## Headless mode
 
-## Environment variables
+Set `headless` to `false` in `~/.config/kahunas/config.json` to show the Playwright browser. Defaults to `true`.
 
-- `KAHUNAS_TOKEN`
-- `KAHUNAS_CSRF`
-- `KAHUNAS_CSRF_COOKIE`
-- `KAHUNAS_COOKIE`
-- `KAHUNAS_WEB_BASE_URL`
-- `KAHUNAS_USER_UUID`
+## Flags
+
+- `--raw` prints raw API responses (no formatting).
 
 ## Playwright
 
@@ -161,5 +163,4 @@ pnpm publish
 ## Notes
 
 - This CLI uses the same APIs the web app uses; tokens can expire quickly.
-- `auth login` is the most reliable way to refresh the token.
-- `workout events` relies on session cookies captured during `auth login`.
+- Re-run any command (or `workout sync`) to refresh login when needed.