@richhaase/c2 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Rich Haase
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,161 @@
+# c2 — Concept2 Logbook CLI
+
+A CLI tool for syncing and analyzing rowing data from your [Concept2 Logbook](https://log.concept2.com). Built with [Bun](https://bun.sh).
+
+## Install
+
+Requires [Bun](https://bun.sh) v1.0+.
+
+```bash
+# Install globally
+bun install -g @richhaase/c2
+
+# Or install from source
+git clone https://github.com/richhaase/c2.git
+cd c2cli
+bun install
+bun link
+```
+
+## Quick Start
+
+```bash
+# Configure token and goals
+bun src/index.ts setup
+
+# Sync workouts
+bun src/index.ts sync
+
+# Check your progress
+bun src/index.ts status
+```
+
+## Usage
+
+### Setup
+
+Configure your token and goal settings:
+
+```bash
+c2 setup
+```
+
+Get your personal access token from [log.concept2.com](https://log.concept2.com) under Settings → Developer. The setup wizard will prompt for your token, goal target, and date range.
+
+### Sync Workouts
+
+Pull new workouts from the Concept2 API:
+
+```bash
+c2 sync
+```
+
+### View Workouts
+
+```bash
+# Show last 10 workouts
+c2 log
+
+# Show last 25 workouts
+c2 log -n 25
+```
+
+### Goal Progress
+
+Track progress toward your distance goal:
+
+```bash
+c2 status
+```
+
+### Training Trends
+
+View weekly trends for pace, volume, stroke rate, and heart rate:
+
+```bash
+# Last 8 weeks (default)
+c2 trend
+
+# Last 12 weeks
+c2 trend -w 12
+```
+
+### HTML Report
+
+Generate a self-contained HTML progress report:
+
+```bash
+# Generate report.html in current directory
+c2 report
+
+# Custom output path
+c2 report -o ~/Desktop/rowing.html
+
+# Generate and open in browser
+c2 report --open
+
+# Show more weeks of history
+c2 report -w 16
+```
+
+### Export Data
+
+Export workouts to CSV, JSON, or JSONL:
+
+```bash
+# CSV to stdout
+c2 export
+
+# JSON format
+c2 export -f json
+
+# Filter by date range
+c2 export --from 2026-01-01 --to 2026-03-01
+
+# Pipe to file
+c2 export -f jsonl > workouts.jsonl
+```
+
+## Configuration
+
+Config lives at `~/.config/c2cli/config.json`. Created automatically on `c2 setup`.
+
+```json
+{
+  "api": {
+    "base_url": "https://log.concept2.com",
+    "token": "YOUR_TOKEN"
+  },
+  "sync": {
+    "machine_type": "rower"
+  },
+  "goal": {
+    "target_meters": 1000000,
+    "start_date": "2026-01-01",
+    "end_date": "2026-12-31"
+  },
+  "display": {
+    "date_format": "%m/%d"
+  }
+}
+```
+
+## Development
+
+```bash
+# Install dependencies
+bun install
+
+# Type check
+bun run check
+
+# Run tests
+bun test
+
+# Run directly
+bun src/index.ts <command>
+```
+
+## License
+
+MIT — see [LICENSE](LICENSE)

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@richhaase/c2",
+  "version": "0.1.1",
+  "description": "CLI tool for syncing and analyzing Concept2 rowing data",
+  "keywords": [
+    "concept2",
+    "rowing",
+    "erg",
+    "fitness",
+    "cli"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/richhaase/c2.git"
+  },
+  "author": "Rich Haase",
+  "type": "module",
+  "bin": {
+    "c2": "src/index.ts"
+  },
+  "scripts": {
+    "dev": "bun src/index.ts",
+    "test": "bun test",
+    "check": "tsc --noEmit && biome check src/ && bun test",
+    "lint": "biome check src/",
+    "fmt": "biome check --write src/",
+    "release": "bun run check && npm version"
+  },
+  "dependencies": {
+    "commander": "^14.0.0"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "^2.4.6",
+    "@types/bun": "^1.3.9"
+  },
+  "files": [
+    "src"
+  ],
+  "engines": {
+    "bun": ">=1.0.0"
+  }
+}

package/src/api/client.ts

@@ -0,0 +1,78 @@
+import pkg from "../../package.json";
+import type { Config } from "../config.ts";
+import type {
+  ResultsResponse,
+  StrokeData,
+  StrokeDataResponse,
+  UserProfile,
+  UserResponse,
+  Workout,
+} from "../models.ts";
+
+export class C2Client {
+  private baseURL: string;
+  private token: string;
+
+  constructor(baseURL: string, token: string) {
+    this.baseURL = baseURL;
+    this.token = token;
+  }
+
+  static fromConfig(cfg: Config): C2Client {
+    return new C2Client(cfg.api.base_url, cfg.api.token);
+  }
+
+  private async get(path: string): Promise<unknown> {
+    const url = this.baseURL + path;
+    const resp = await fetch(url, {
+      headers: {
+        Authorization: `Bearer ${this.token}`,
+        "User-Agent": `c2/${pkg.version}`,
+      },
+      signal: AbortSignal.timeout(30_000),
+    });
+
+    if (!resp.ok) {
+      throw new Error(`API error (${resp.status}) from ${path}`);
+    }
+
+    return resp.json();
+  }
+
+  async getUser(): Promise<UserProfile> {
+    const resp = (await this.get("/api/users/me")) as UserResponse;
+    return resp.data;
+  }
+
+  async getResults(from: string, to: string, page: number): Promise<ResultsResponse> {
+    const params = new URLSearchParams({ type: "rower", page: String(page) });
+    if (from) params.set("from", from);
+    if (to) params.set("to", to);
+    return (await this.get(`/api/users/me/results?${params}`)) as ResultsResponse;
+  }
+
+  async getAllResults(from: string, to: string): Promise<Workout[]> {
+    const all: Workout[] = [];
+    let page = 1;
+
+    for (;;) {
+      const resp = await this.getResults(from, to, page);
+      all.push(...resp.data);
+
+      const hasMore =
+        resp.meta?.pagination != null &&
+        resp.meta.pagination.current_page < resp.meta.pagination.total_pages;
+
+      if (!hasMore || resp.data.length === 0) break;
+      page++;
+    }
+
+    return all;
+  }
+
+  async getStrokes(workoutId: number): Promise<StrokeData[]> {
+    const path = `/api/users/me/results/${workoutId}/strokes`;
+    const resp = (await this.get(path)) as StrokeDataResponse;
+    return resp.data;
+  }
+}

package/src/commands/export.ts

@@ -0,0 +1,115 @@
+import type { Command } from "commander";
+import type { Workout } from "../models.ts";
+import { pace500m } from "../models.ts";
+import { readWorkouts } from "../storage.ts";
+
+export function filterByDate(workouts: Workout[], from: string, to: string): Workout[] {
+  if (!from && !to) return workouts;
+  return workouts.filter((w) => {
+    const date = w.date.slice(0, 10);
+    if (from && date < from) return false;
+    if (to && date > to) return false;
+    return true;
+  });
+}
+
+export function escapeCSV(s: string): string {
+  if (s.includes(",") || s.includes('"') || s.includes("\n")) {
+    return `"${s.replace(/"/g, '""')}"`;
+  }
+  return s;
+}
+
+function exportCSV(workouts: Workout[]): void {
+  const header = [
+    "id",
+    "date",
+    "distance",
+    "time_tenths",
+    "time_formatted",
+    "pace_500m",
+    "stroke_rate",
+    "stroke_count",
+    "calories",
+    "drag_factor",
+    "hr_avg",
+    "hr_min",
+    "hr_max",
+    "workout_type",
+    "machine_type",
+    "comments",
+  ];
+  console.log(header.join(","));
+
+  for (const w of workouts) {
+    const row = [
+      String(w.id),
+      w.date,
+      String(w.distance),
+      String(w.time),
+      w.time_formatted,
+      pace500m(w),
+      String(w.stroke_rate ?? ""),
+      String(w.stroke_count ?? ""),
+      String(w.calories_total ?? ""),
+      String(w.drag_factor ?? ""),
+      w.heart_rate?.average ? String(w.heart_rate.average) : "",
+      w.heart_rate?.min ? String(w.heart_rate.min) : "",
+      w.heart_rate?.max ? String(w.heart_rate.max) : "",
+      w.workout_type ?? "",
+      w.type ?? "",
+      escapeCSV(w.comments ?? ""),
+    ];
+    console.log(row.join(","));
+  }
+}
+
+function exportJSON(workouts: Workout[]): void {
+  console.log(JSON.stringify(workouts, null, 2));
+}
+
+function exportJSONL(workouts: Workout[]): void {
+  for (const w of workouts) {
+    console.log(JSON.stringify(w));
+  }
+}
+
+export function registerExport(program: Command): void {
+  program
+    .command("export")
+    .description("Export workouts to CSV or JSON")
+    .option("-f, --format <fmt>", "output format: csv, json, or jsonl", "csv")
+    .option("--from <date>", "filter workouts from date (YYYY-MM-DD)")
+    .option("--to <date>", "filter workouts to date (YYYY-MM-DD)")
+    .action(async (opts: { format: string; from?: string; to?: string }) => {
+      let workouts = await readWorkouts();
+      if (workouts.length === 0) {
+        console.error("No workouts found. Run `c2 sync` first.");
+        process.exit(1);
+      }
+
+      workouts = filterByDate(workouts, opts.from ?? "", opts.to ?? "");
+      if (workouts.length === 0) {
+        console.error("No workouts match the specified date range.");
+        process.exit(1);
+      }
+
+      // Sort oldest first for export
+      workouts.sort((a, b) => a.date.localeCompare(b.date));
+
+      switch (opts.format) {
+        case "csv":
+          exportCSV(workouts);
+          break;
+        case "json":
+          exportJSON(workouts);
+          break;
+        case "jsonl":
+          exportJSONL(workouts);
+          break;
+        default:
+          console.error(`Unsupported format "${opts.format}": must be csv, json, or jsonl`);
+          process.exit(1);
+      }
+    });
+}

package/src/commands/log.ts

@@ -0,0 +1,31 @@
+import type { Command } from "commander";
+import { loadConfig } from "../config.ts";
+import { formatWorkoutLine } from "../display.ts";
+import { readWorkouts } from "../storage.ts";
+
+export function registerLog(program: Command): void {
+  program
+    .command("log")
+    .description("Show recent workouts")
+    .option("-n, --count <n>", "number of workouts to display", "10")
+    .action(async (opts: { count: string }) => {
+      const cfg = await loadConfig();
+      const workouts = await readWorkouts();
+      if (workouts.length === 0) {
+        console.log("No workouts found. Run `c2 sync` first.");
+        return;
+      }
+
+      workouts.sort((a, b) => b.date.localeCompare(a.date));
+
+      const count = parseInt(opts.count, 10);
+      if (Number.isNaN(count) || count < 1) {
+        console.error("Error: --count must be a positive integer.");
+        process.exit(1);
+      }
+      const n = Math.min(count, workouts.length);
+      for (const w of workouts.slice(0, n)) {
+        console.log(formatWorkoutLine(w, cfg.display.date_format));
+      }
+    });
+}