third-wheel 0.1.0

package/README.md

@@ -0,0 +1,39 @@
+# third-wheel
+
+CLI for exporting Third Wheel recordings and transcripts.
+
+## Login
+
+```sh
+npx third-wheel login --app-url https://your-third-wheel-app.com
+```
+
+The command opens `/cli/login` in your browser. Create a token in the app,
+paste it into the terminal, and the CLI stores it at `~/.third/config.json`.
+
+For local development, omit `--app-url` and it defaults to
+`http://localhost:3000`.
+
+## List Recordings
+
+```sh
+npx third-wheel recordings
+```
+
+This prints JSON with session ids, timestamps, speaker maps, transcripts when
+available, scorecard summaries when available, recording metadata, and
+authenticated audio URLs.
+
+## Fetch One Recording
+
+```sh
+npx third-wheel recordings <recording-id>
+```
+
+The response is JSON and can be piped into local coding agents or analysis
+tools.
+
+## Configuration
+
+The CLI reads `THIRD_WHEEL_APP_URL`, `APP_URL`, or `--app-url` to choose which
+app instance to call. Saved credentials live in `~/.third/config.json`.

package/bin/cli.js

@@ -0,0 +1,176 @@
+#!/usr/bin/env node
+import { spawn } from "node:child_process";
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+import { homedir } from "node:os";
+import path from "node:path";
+import readline from "node:readline/promises";
+import { stdin as input, stdout as output } from "node:process";
+
+const CONFIG_DIR = path.join(homedir(), ".third");
+const CONFIG_FILE = path.join(CONFIG_DIR, "config.json");
+const DEFAULT_APP_URL = "http://localhost:3000";
+
+function usage() {
+  console.log(`Usage:
+  third-wheel login [--app-url <url>]
+  third-wheel recordings [id] [--app-url <url>]
+
+Options:
+  --app-url <url>  Third Wheel app URL. Defaults to saved config, THIRD_WHEEL_APP_URL, APP_URL, or ${DEFAULT_APP_URL}.
+`);
+}
+
+function parseArgs(argv) {
+  const args = [...argv];
+  const command = args.shift();
+  const options = {};
+  const positional = [];
+
+  while (args.length > 0) {
+    const arg = args.shift();
+    if (arg === "--app-url") {
+      options.appUrl = args.shift();
+    } else if (arg === "--help" || arg === "-h") {
+      options.help = true;
+    } else if (arg) {
+      positional.push(arg);
+    }
+  }
+
+  return { command, positional, options };
+}
+
+function normalizeAppUrl(appUrl) {
+  return appUrl.replace(/\/+$/, "");
+}
+
+async function readConfig() {
+  try {
+    const contents = await readFile(CONFIG_FILE, "utf8");
+    return JSON.parse(contents);
+  } catch {
+    return {};
+  }
+}
+
+async function writeConfig(config) {
+  await mkdir(CONFIG_DIR, { recursive: true, mode: 0o700 });
+  await writeFile(CONFIG_FILE, `${JSON.stringify(config, null, 2)}\n`, {
+    mode: 0o600,
+  });
+}
+
+function resolveAppUrl(options, config = {}) {
+  return normalizeAppUrl(
+    options.appUrl ||
+      config.appUrl ||
+      process.env.THIRD_WHEEL_APP_URL ||
+      process.env.APP_URL ||
+      DEFAULT_APP_URL
+  );
+}
+
+function openBrowser(url) {
+  const platform = process.platform;
+  const command =
+    platform === "darwin" ? "open" : platform === "win32" ? "cmd" : "xdg-open";
+  const args = platform === "win32" ? ["/c", "start", "", url] : [url];
+  const child = spawn(command, args, {
+    detached: true,
+    stdio: "ignore",
+  });
+  child.unref();
+}
+
+async function login(options) {
+  const config = await readConfig();
+  const appUrl = resolveAppUrl(options, config);
+  const loginUrl = `${appUrl}/cli/login`;
+
+  console.log(`Opening ${loginUrl}`);
+  try {
+    openBrowser(loginUrl);
+  } catch {
+    console.log("Could not open a browser automatically.");
+  }
+
+  console.log("Create a CLI token in the browser, then paste it here.");
+  const rl = readline.createInterface({ input, output });
+  const token = (await rl.question("Token: ")).trim();
+  rl.close();
+
+  if (!token) {
+    throw new Error("No token provided.");
+  }
+
+  await writeConfig({ ...config, appUrl, token });
+  console.log(`Saved credentials to ${CONFIG_FILE}`);
+}
+
+async function apiFetch(config, pathSuffix) {
+  if (!config.token) {
+    throw new Error("Not logged in. Run `third-wheel login` first.");
+  }
+
+  const appUrl = normalizeAppUrl(config.appUrl || DEFAULT_APP_URL);
+  const response = await fetch(`${appUrl}${pathSuffix}`, {
+    headers: {
+      Authorization: `Bearer ${config.token}`,
+      Accept: "application/json",
+    },
+  });
+
+  if (!response.ok) {
+    let message = `${response.status} ${response.statusText}`;
+    try {
+      const data = await response.json();
+      if (data?.error) message = `${message}: ${data.error}`;
+    } catch {
+      // Keep the HTTP status when the server did not return JSON.
+    }
+    throw new Error(message);
+  }
+
+  return response.json();
+}
+
+async function recordings(positional, options) {
+  const savedConfig = await readConfig();
+  const config = {
+    ...savedConfig,
+    appUrl: resolveAppUrl(options, savedConfig),
+  };
+  const id = positional[0];
+  const data = await apiFetch(
+    config,
+    id ? `/api/cli/recordings/${encodeURIComponent(id)}` : "/api/cli/recordings"
+  );
+  console.log(JSON.stringify(data, null, 2));
+}
+
+async function main() {
+  const { command, positional, options } = parseArgs(process.argv.slice(2));
+
+  if (options.help || !command || command === "--help" || command === "-h") {
+    usage();
+    return;
+  }
+
+  if (command === "login") {
+    await login(options);
+    return;
+  }
+
+  if (command === "recordings") {
+    await recordings(positional, options);
+    return;
+  }
+
+  usage();
+  process.exitCode = 1;
+}
+
+main().catch((error) => {
+  console.error(error instanceof Error ? error.message : error);
+  process.exitCode = 1;
+});

package/package.json

@@ -0,0 +1,17 @@
+{
+  "name": "third-wheel",
+  "version": "0.1.0",
+  "description": "CLI for exporting Third Wheel recordings and transcripts.",
+  "type": "module",
+  "bin": {
+    "third-wheel": "bin/cli.js"
+  },
+  "files": [
+    "bin",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "license": "UNLICENSED"
+}