@profullstack/tleehealth 0.0.0-stage → 0.1.0

package/README.md

@@ -1,3 +1,11 @@
-# Temporary Holding Version
+# @profullstack/tleehealth
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+The [tleehealth](https://tleehealth.com) CLI and front-desk TUI.
+
+```sh
+npm i -g @profullstack/tleehealth     # or: curl -fsSL https://tleehealth.com/install.sh | sh
+tleehealth schedule --date today
+tleehealth tui
+```
+
+`TLEEHEALTH_API_KEY` and `TLEEHEALTH_URL` override the saved config. The schedule serves demo data until accounts launch.

package/bin/tleehealth.mjs

@@ -0,0 +1,10 @@
+#!/usr/bin/env node
+import { main } from '../src/cli.js';
+
+main().then(
+  (code) => process.exit(code ?? 0),
+  (err) => {
+    process.stderr.write(`tleehealth: ${err?.message ?? err}\n`);
+    process.exit(1);
+  },
+);

package/package.json

@@ -1,6 +1,16 @@
 {
   "name": "@profullstack/tleehealth",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "description": "tleehealth from the terminal: the CLI, the front-desk TUI, and the API client the MCP server uses.",
+  "type": "module",
+  "license": "MIT",
+  "author": "Profullstack, Inc.",
+  "homepage": "https://tleehealth.com",
+  "repository": { "type": "git", "url": "https://github.com/profullstack/tleehealth.com", "directory": "packages/cli" },
+  "engines": { "node": ">=20" },
+  "bin": { "tleehealth": "./bin/tleehealth.mjs" },
+  "exports": { ".": "./src/cli.js", "./client": "./src/client.js" },
+  "files": ["bin", "src", "README.md"],
+  "dependencies": { "@profullstack/hqtui": "^0.8.0" },
+  "keywords": ["telehealth", "practice-management", "scheduling", "cli", "tui"]
+}

package/src/cli.js

@@ -0,0 +1,86 @@
+/**
+ * tleehealth: the practice from the terminal.
+ *
+ *   tleehealth schedule [--date today|tomorrow|YYYY-MM-DD] [--json]
+ *   tleehealth health
+ *   tleehealth login [KEY]
+ *   tleehealth tui
+ *
+ * TLEEHEALTH_API_KEY and TLEEHEALTH_URL override the saved config.
+ */
+import { createInterface } from 'node:readline/promises';
+import { health, resolveAuth, saveConfig, schedule } from './client.js';
+
+const HELP = `tleehealth: telehealth and practice management.
+
+  tleehealth schedule [--date today|tomorrow|YYYY-MM-DD] [--json]   the front-desk day
+  tleehealth health                                                 is the API up
+  tleehealth login [KEY]                                            save an API key
+  tleehealth tui                                                    the day view, as a screen
+
+Environment: TLEEHEALTH_API_KEY, TLEEHEALTH_URL.`;
+
+export function parse(argv) {
+  const positional = [];
+  const flags = {};
+  for (let i = 0; i < argv.length; i += 1) {
+    const arg = argv[i];
+    if (arg.startsWith('--')) {
+      const [name, inline] = arg.slice(2).split('=', 2);
+      if (inline !== undefined) flags[name] = inline;
+      else if (argv[i + 1] && !argv[i + 1].startsWith('--')) flags[name] = argv[++i];
+      else flags[name] = true;
+    } else if (arg === '-h') flags.help = true;
+    else positional.push(arg);
+  }
+  return { positional, flags };
+}
+
+export function formatDay(day) {
+  const lines = [`${day.date}${day.demo ? '  (demo data)' : ''}`];
+  for (const a of day.appointments)
+    lines.push(
+      `${a.time}  ${a.location.padEnd(11)} ${a.provider.padEnd(11)} ${a.patient.padEnd(11)} ${a.type.padEnd(14)} ${a.mode.padEnd(9)} ${a.reminder_call}`,
+    );
+  return lines.join('\n');
+}
+
+export async function main(argv = process.argv.slice(2)) {
+  const { positional, flags } = parse(argv);
+  const [cmd, ...rest] = positional;
+  if (!cmd || flags.help || cmd === 'help') {
+    console.log(HELP);
+    return 0;
+  }
+  const auth = await resolveAuth({ server: flags.server, key: flags.key });
+  switch (cmd) {
+    case 'health': {
+      const h = await health(auth);
+      console.log(`${auth.server}  ok=${h.ok}  v${h.version}`);
+      return h.ok ? 0 : 1;
+    }
+    case 'schedule': {
+      const day = await schedule(auth, flags.date);
+      console.log(flags.json ? JSON.stringify(day, null, 2) : formatDay(day));
+      return 0;
+    }
+    case 'login': {
+      let key = rest[0];
+      if (!key) {
+        const rl = createInterface({ input: process.stdin, output: process.stderr });
+        key = (await rl.question('API key: ')).trim();
+        rl.close();
+      }
+      const file = await saveConfig({ key, server: auth.server });
+      process.stderr.write(`Saved to ${file}.\n`);
+      return 0;
+    }
+    case 'tui': {
+      const { runTui } = await import('./tui.js');
+      await runTui(auth, flags.date);
+      return 0;
+    }
+    default:
+      throw new Error(`unknown command ${cmd}; try tleehealth help`);
+  }
+}

package/src/client.js

@@ -0,0 +1,74 @@
+/**
+ * The tleehealth API, as function calls. Shared by the CLI, the TUI and the MCP
+ * server. Plain fetch, no dependencies: runs on Node 20+ or Bun.
+ */
+import { mkdir, readFile, writeFile } from 'node:fs/promises';
+import { homedir } from 'node:os';
+import { dirname, join } from 'node:path';
+
+const CONFIG_FILE = join(
+  process.env.XDG_CONFIG_HOME || join(homedir(), '.config'),
+  'tleehealth',
+  'config.json',
+);
+
+export async function loadConfig() {
+  try {
+    return JSON.parse(await readFile(CONFIG_FILE, 'utf8'));
+  } catch {
+    return {};
+  }
+}
+
+export async function saveConfig(patch) {
+  const next = { ...(await loadConfig()), ...patch };
+  await mkdir(dirname(CONFIG_FILE), { recursive: true });
+  await writeFile(CONFIG_FILE, `${JSON.stringify(next, null, 2)}\n`, { mode: 0o600 });
+  return CONFIG_FILE;
+}
+
+/** Server and key: flags and environment first, then the saved config. */
+export async function resolveAuth({ server, key } = {}) {
+  const saved = await loadConfig();
+  return {
+    server: (server || process.env.TLEEHEALTH_URL || saved.server || 'https://tleehealth.com').replace(/\/+$/, ''),
+    key: key || process.env.TLEEHEALTH_API_KEY || saved.key || '',
+  };
+}
+
+export class ApiError extends Error {
+  constructor(status, body) {
+    super(body?.error ? `${body.error} (HTTP ${status})` : `HTTP ${status}`);
+    this.status = status;
+    this.body = body;
+  }
+}
+
+export async function call(auth, path, init = {}) {
+  const res = await fetch(`${auth.server}${path}`, {
+    ...init,
+    headers: { ...(auth.key ? { authorization: `Bearer ${auth.key}` } : {}), ...(init.headers ?? {}) },
+  });
+  const type = res.headers.get('content-type') ?? '';
+  const body = type.includes('json') ? await res.json().catch(() => ({})) : await res.text();
+  if (!res.ok) throw new ApiError(res.status, typeof body === 'string' ? { error: body.slice(0, 200) } : body);
+  return body;
+}
+
+export const health = (auth) => call(auth, '/api/v1/health');
+
+/** The front-desk day: appointments across every location, with reminder-call state. */
+export function schedule(auth, date = today()) {
+  return call(auth, `/api/v1/schedule?date=${encodeURIComponent(resolveDate(date))}`);
+}
+
+export function today() {
+  return new Date().toISOString().slice(0, 10);
+}
+
+export function resolveDate(input) {
+  if (!input || input === 'today') return today();
+  if (input === 'tomorrow') return new Date(Date.now() + 86_400_000).toISOString().slice(0, 10);
+  if (/^\d{4}-\d{2}-\d{2}$/.test(input)) return input;
+  throw new Error(`date is today, tomorrow or YYYY-MM-DD, not "${input}"`);
+}

package/src/tui.js

@@ -0,0 +1,68 @@
+/**
+ * tleehealth tui: the front-desk day view.
+ *
+ * Today's appointments across every location, with the AI reminder-call state of
+ * each. Up/Down picks a row, Left/Right moves a day, r refreshes, Ctrl+C or q quits.
+ */
+import { createApp } from '@profullstack/hqtui';
+import { resolveDate, schedule } from './client.js';
+
+const shift = (date, days) => new Date(Date.parse(`${date}T12:00:00Z`) + days * 86_400_000).toISOString().slice(0, 10);
+
+export async function runTui(auth, date) {
+  const state = { date: resolveDate(date), day: null, selected: 0, status: 'Loading…' };
+  const app = await createApp({ fps: 20, quitKeys: [] });
+
+  const load = async () => {
+    state.status = 'Loading…';
+    app.invalidate();
+    try {
+      state.day = await schedule(auth, state.date);
+      state.selected = 0;
+      state.status = `${state.day.appointments.length} appointments${state.day.demo ? ' · demo data' : ''}`;
+    } catch (err) {
+      state.day = null;
+      state.status = err.message;
+    }
+    app.invalidate();
+  };
+
+  app.on('key', (event) => {
+    if (event.key === 'ctrl+c' || event.char === 'q') return app.quit();
+    const rows = state.day?.appointments ?? [];
+    if (event.name === 'up' || event.name === 'down') {
+      if (rows.length) state.selected = (state.selected + (event.name === 'up' ? -1 : 1) + rows.length) % rows.length;
+    } else if (event.name === 'left' || event.name === 'right') {
+      state.date = shift(state.date, event.name === 'left' ? -1 : 1);
+      return void load();
+    } else if (event.char === 'r') return void load();
+    app.invalidate();
+  });
+
+  app.render(({ ui, theme }) => {
+    ui.column({ gap: 1 }, (root) => {
+      root.panel({ title: `tleehealth · front desk · ${state.date}` }, (panel) => {
+        panel.text('Up/Down pick · Left/Right day · r refresh · q quit', { fg: theme.muted });
+        panel.text(state.status, { fg: theme.muted });
+      });
+      const rows = state.day?.appointments ?? [];
+      const locations = [...new Set(rows.map((a) => a.location))];
+      for (const loc of locations) {
+        root.panel({ title: loc }, (panel) => {
+          for (const a of rows) {
+            if (a.location !== loc) continue;
+            const i = rows.indexOf(a);
+            const mark = i === state.selected ? '›' : ' ';
+            panel.text(
+              `${mark} ${a.time}  ${a.provider.padEnd(11)} ${a.patient.padEnd(11)} ${a.type.padEnd(14)} ${a.mode.padEnd(9)} call: ${a.reminder_call}`,
+              { fg: i === state.selected ? theme.accent : undefined },
+            );
+          }
+        });
+      }
+    });
+  });
+
+  void load();
+  await app.start();
+}