bestviber 0.0.0-stage → 0.2.0

package/README.md

@@ -1,3 +1,43 @@
-# Temporary Holding Version
+# bestviber
 
-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.
+Focus timer and focus analytics for you and your AI agents.
+
+## Claude Code, in two commands
+
+```sh
+npm install -g bestviber
+bestviber login
+```
+
+`login` opens your browser to approve a short code, installs the agent skill,
+and asks whether to track your Claude Code sessions automatically. Say yes and
+there is nothing else to do: every Claude Code session is timed and filed
+under the repository you work in. Quiet stretches are recorded as pauses, and
+ten quiet minutes end the session. Then ask your agent "how was my week?", or
+run `bestviber week`.
+
+`bestviber logout` signs out and removes the tracking.
+
+## By hand
+
+```sh
+bestviber start          # start a focus session
+bestviber stop --note "wrote the launch post"
+bestviber week           # this week: total, by day, by hour, by tag and project
+bestviber insights       # peak hours, best weekday, streaks, trends
+```
+
+Every command takes `--json` for scripts and agents. `bestviber tools` lists
+every action the server offers and `bestviber run <action>` runs any of them,
+so new features work without updating the CLI.
+
+## Other agents
+
+- The skill goes to `~/.claude/skills/bestviber`, and also to
+  `~/.agents/skills/bestviber` if you have an `~/.agents` folder. Reinstall or
+  update it with `bestviber skill install`.
+- `bestviber mcp` prints how to connect any MCP client to
+  `https://www.bestviber.com/api/mcp`. Sign in first: the setup line uses
+  your token.
+
+Free. Same account as [bestviber.com](https://www.bestviber.com).

package/bin/bestviber.mjs

@@ -0,0 +1,67 @@
+#!/usr/bin/env node
+import { readFileSync } from 'node:fs'
+import { parse } from '../src/args.mjs'
+import { CliError } from '../src/client.mjs'
+import { commands } from '../src/commands.mjs'
+
+const pkg = JSON.parse(
+  readFileSync(new URL('../package.json', import.meta.url), 'utf8'),
+)
+
+function help() {
+  const width = Math.max(...Object.keys(commands).map((c) => c.length))
+  const lines = Object.entries(commands)
+    .filter(([, c]) => !c.hidden)
+    .map(([name, c]) => `  ${name.padEnd(width)}  ${c.summary}`)
+  return `bestviber ${pkg.version}: focus timer and focus analytics for you and your agents
+
+Usage: bestviber <command> [options]
+
+${lines.join('\n')}
+
+Options:
+  --json     Print raw JSON (for scripts and agents)
+  --help     Show help for a command
+
+Start with \`bestviber login\`. Full docs: https://www.bestviber.com/llms.txt`
+}
+
+async function main() {
+  const [name, ...rest] = process.argv.slice(2)
+  if (!name || name === 'help' || name === '--help' || name === '-h') {
+    console.log(help())
+    return
+  }
+  if (name === '--version' || name === '-v') {
+    console.log(pkg.version)
+    return
+  }
+  const command = commands[name]
+  if (!command)
+    throw new CliError(`Unknown command "${name}". Run \`bestviber help\`.`)
+  const { flags, args } = parse(rest)
+  if (flags.help) {
+    console.log(
+      `${command.summary}\n\nUsage: bestviber ${command.usage ?? name}`,
+    )
+    return
+  }
+  const json = flags.json === true
+  delete flags.json
+  const result = await command.run({ flags, args, json })
+  if (result === undefined) return
+  console.log(
+    json && typeof result !== 'string'
+      ? JSON.stringify(result, null, 2)
+      : result,
+  )
+}
+
+main().catch((err) => {
+  if (err instanceof CliError) {
+    console.error(`bestviber: ${err.message}`)
+    process.exit(err.exitCode)
+  }
+  console.error(err)
+  process.exit(1)
+})

package/package.json

@@ -1,6 +1,30 @@
 {
   "name": "bestviber",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.2.0",
+  "description": "Focus timer and focus analytics for you and your AI agents. Start, pause and finish sessions, and get daily, weekly and monthly stats from the terminal.",
+  "keywords": [
+    "focus",
+    "timer",
+    "pomodoro",
+    "deep-work",
+    "productivity",
+    "time-tracking",
+    "cli",
+    "ai-agent",
+    "mcp"
+  ],
+  "homepage": "https://www.bestviber.com",
+  "license": "MIT",
+  "type": "module",
+  "bin": {
+    "bestviber": "bin/bestviber.mjs"
+  },
+  "files": [
+    "bin",
+    "src",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=20"
+  }
 }

package/src/args.mjs

@@ -0,0 +1,32 @@
+/**
+ * `--key value`, `--key=value`, `--flag`, `--no-flag` (sets both `flag:
+ * false` and `no-flag: true`); a repeated key becomes an array. Everything
+ * else is positional.
+ * @param {string[]} argv
+ */
+export function parse(argv) {
+  /** @type {Record<string, any>} */
+  const flags = {}
+  /** @type {string[]} */
+  const args = []
+  const set = (/** @type {string} */ key, /** @type {unknown} */ value) => {
+    flags[key] = key in flags ? [...[flags[key]].flat(), value] : value
+  }
+  for (let i = 0; i < argv.length; i++) {
+    const a = argv[i]
+    if (!a.startsWith('--')) {
+      args.push(a)
+      continue
+    }
+    const body = a.slice(2)
+    const eq = body.indexOf('=')
+    if (eq !== -1) set(body.slice(0, eq), body.slice(eq + 1))
+    else if (body.startsWith('no-')) {
+      flags[body.slice(3)] = false
+      flags[body] = true
+    } else if (i + 1 < argv.length && !argv[i + 1].startsWith('--'))
+      set(body, argv[++i])
+    else set(body, true)
+  }
+  return { flags, args }
+}

package/src/client.mjs

@@ -0,0 +1,136 @@
+import { mkdir, readFile, rm, writeFile } from 'node:fs/promises'
+import { homedir } from 'node:os'
+import { dirname, join } from 'node:path'
+
+export const DEFAULT_URL = 'https://www.bestviber.com'
+export const CLIENT_ID = 'bestviber-cli'
+
+export class CliError extends Error {
+  /** @param {string} message @param {number} [exitCode] */
+  constructor(message, exitCode = 1) {
+    super(message)
+    this.exitCode = exitCode
+  }
+}
+
+// ───── config ─────
+
+export function configPath() {
+  const base = process.env.XDG_CONFIG_HOME || join(homedir(), '.config')
+  return join(base, 'bestviber', 'config.json')
+}
+
+/** @returns {Promise<{ token?: string, url?: string, email?: string }>} */
+export async function readConfig() {
+  try {
+    return JSON.parse(await readFile(configPath(), 'utf8'))
+  } catch {
+    return {}
+  }
+}
+
+/** @param {{ token?: string, url?: string, email?: string }} config */
+export async function writeConfig(config) {
+  const path = configPath()
+  await mkdir(dirname(path), { recursive: true, mode: 0o700 })
+  // The token is a bearer credential: owner-only.
+  await writeFile(path, JSON.stringify(config, null, 2) + '\n', { mode: 0o600 })
+}
+
+export async function clearConfig() {
+  await rm(configPath(), { force: true })
+}
+
+export async function baseUrl() {
+  const config = await readConfig()
+  return (process.env.BESTVIBER_URL || config.url || DEFAULT_URL).replace(
+    /\/+$/,
+    '',
+  )
+}
+
+export async function token() {
+  return process.env.BESTVIBER_TOKEN || (await readConfig()).token
+}
+
+export function localTimeZone() {
+  return Intl.DateTimeFormat().resolvedOptions().timeZone
+}
+
+// ───── http ─────
+
+/**
+ * @param {string} path
+ * @param {{ method?: string, body?: unknown, auth?: boolean }} [opts]
+ */
+export async function request(path, opts = {}) {
+  /** @type {Record<string, string>} */
+  const headers = {
+    'Content-Type': 'application/json',
+    'X-Timezone': localTimeZone(),
+    'User-Agent': 'bestviber-cli',
+  }
+  if (opts.auth !== false) {
+    const t = await token()
+    if (!t) throw new CliError('Not signed in. Run `bestviber login` first.', 2)
+    headers.Authorization = `Bearer ${t}`
+  }
+  let res
+  try {
+    res = await fetch(`${await baseUrl()}${path}`, {
+      method: opts.method ?? (opts.body === undefined ? 'GET' : 'POST'),
+      headers,
+      body: opts.body === undefined ? undefined : JSON.stringify(opts.body),
+    })
+  } catch (err) {
+    throw new CliError(
+      `Could not reach bestviber: ${/** @type {Error} */ (err).message}`,
+    )
+  }
+  const text = await res.text()
+  let data
+  try {
+    data = text ? JSON.parse(text) : null
+  } catch {
+    data = { error: text }
+  }
+  return { status: res.status, ok: res.ok, data }
+}
+
+/** Fetches the live action list; new server actions appear here. */
+export async function manifest() {
+  const res = await request('/api/v1/actions', { auth: false })
+  if (!res.ok)
+    throw new CliError(`Could not load actions (HTTP ${res.status}).`)
+  return /** @type {Array<{ name: string, title: string, description: string, inputSchema: any, readOnly: boolean, consequential: boolean }>} */ (
+    res.data.actions
+  )
+}
+
+/**
+ * Runs an action on the server and returns its result.
+ * @param {string} name @param {Record<string, unknown>} [input]
+ */
+export async function call(name, input = {}) {
+  const res = await request(`/api/v1/actions/${encodeURIComponent(name)}`, {
+    body: input,
+  })
+  if (res.status === 401)
+    throw new CliError(
+      'Not signed in, or the session expired. Run `bestviber login`.',
+      2,
+    )
+  if (!res.ok || !res.data?.ok) {
+    const issues = res.data?.issues
+      ? '\n' +
+        res.data.issues
+          .map(
+            (/** @type {any} */ i) =>
+              `  ${i.path?.join('.') || 'input'}: ${i.message}`,
+          )
+          .join('\n')
+      : ''
+    throw new CliError(`${res.data?.error ?? `HTTP ${res.status}`}${issues}`)
+  }
+  return res.data.result
+}