@manfred-kunze-dev/backbone-cli 2.13.0-dev.4 → 2.13.0-dev.6

package/README.md

@@ -5,9 +5,15 @@ A command-line interface for the [Backbone AI](https://backbone.manfred-kunze.de
 ## Installation
 
 ```bash
+# Latest stable release
 npm install -g @manfred-kunze-dev/backbone-cli
+
+# Pre-release (dev channel)
+npm install -g @manfred-kunze-dev/backbone-cli@dev
 ```
 
+The CLI will notify you when a newer version is available.
+
 ## Quick Start
 
 ```bash
@@ -17,9 +23,6 @@ backbone auth login
 # Create a project
 backbone projects create -n "My Project"
 
-# Set it as default
-backbone config set project <project-id>
-
 # Define a schema and run an extraction
 backbone schemas create -n "Invoice"
 backbone extractions create --schema <id> -m gpt-4o --text "Invoice #123, Total: $500"
@@ -44,12 +47,26 @@ backbone auth status    # Verify credentials
 backbone auth logout    # Clear stored credentials
 ```
 
+## Contexts
+
+The CLI supports kubectl-style contexts for switching between organizations and environments:
+
+```bash
+# Contexts are created automatically via `backbone auth login`
+backbone context list              # List all contexts
+backbone context use acme-corp     # Switch active context
+backbone context create staging    # Create a new context
+backbone context rename old new    # Rename a context
+backbone context delete old        # Remove a context
+```
+
 ## Commands
 
 | Command | Description |
 |---------|-------------|
 | `auth` | Login, logout, and check auth status |
 | `config` | Get, set, and list configuration values |
+| `context` | Manage CLI contexts for multiple environments |
 | `projects` | List, create, update, and delete projects |
 | `schemas` | Manage schemas, versions, labels, validation, and testing |
 | `prompts` | Manage prompts, versions, labels, compilation, and testing |
@@ -60,6 +77,7 @@ backbone auth logout    # Clear stored credentials
 | `providers` | Manage BYOK AI providers |
 | `analytics` | View project usage analytics |
 | `billing` | Check subscription tier and usage limits |
+| `docs` | Browse API documentation from the terminal |
 
 ### Global Options
 
@@ -67,7 +85,6 @@ backbone auth logout    # Clear stored credentials
 |------|-------------|
 | `--api-key <key>` | Override the API key |
 | `--base-url <url>` | Override the base URL (default: `https://backbone.manfred-kunze.dev/api`) |
-| `--project <id>` | Override the project ID |
 | `--json` | Output raw JSON instead of formatted tables |
 | `--no-color` | Disable colored output |
 

package/dist/index.js

@@ -17,6 +17,8 @@ import { makeAnalyticsCommand } from "./commands/analytics.js";
 import { makeBillingCommand } from "./commands/billing.js";
 import { makeDocsCommand } from "./commands/docs.js";
 import { makeContextCommand } from "./commands/context.js";
+import { checkForUpdates } from "./lib/update-notifier.js";
+const updater = checkForUpdates(pkg.version);
 const program = new Command();
 program
     .name("backbone")
@@ -40,5 +42,5 @@ program.addCommand(makeProvidersCommand());
 program.addCommand(makeAnalyticsCommand());
 program.addCommand(makeBillingCommand());
 program.addCommand(makeDocsCommand());
-program.parse();
+program.parseAsync().then(() => updater.notify());
 //# sourceMappingURL=index.js.map

package/dist/lib/update-notifier.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Check for updates in the background. Call early so the fetch
+ * runs concurrently with the actual command, then call `notify()`
+ * after the command finishes to print the message (if any).
+ */
+export declare function checkForUpdates(currentVersion: string): {
+    notify: () => void;
+};
+//# sourceMappingURL=update-notifier.d.ts.map

package/dist/lib/update-notifier.js

@@ -0,0 +1,96 @@
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { readFileSync, writeFileSync, mkdirSync } from "node:fs";
+import chalk from "chalk";
+const PKG_NAME = "@manfred-kunze-dev/backbone-cli";
+const CHECK_INTERVAL_MS = 24 * 60 * 60 * 1000; // 1 day
+const CACHE_DIR = join(homedir(), ".config", "backbone");
+const CACHE_FILE = join(CACHE_DIR, "update-check.json");
+function readCache() {
+    try {
+        return JSON.parse(readFileSync(CACHE_FILE, "utf-8"));
+    }
+    catch {
+        return null;
+    }
+}
+function writeCache(data) {
+    try {
+        mkdirSync(CACHE_DIR, { recursive: true });
+        writeFileSync(CACHE_FILE, JSON.stringify(data));
+    }
+    catch {
+        // Ignore write errors
+    }
+}
+async function fetchLatestVersion() {
+    try {
+        const controller = new AbortController();
+        const timeout = setTimeout(() => controller.abort(), 3000);
+        const res = await fetch(`https://registry.npmjs.org/${PKG_NAME}/latest`, { signal: controller.signal });
+        clearTimeout(timeout);
+        if (!res.ok)
+            return null;
+        const data = (await res.json());
+        return data.version ?? null;
+    }
+    catch {
+        return null;
+    }
+}
+function compareVersions(current, latest) {
+    const parse = (v) => v.replace(/^v/, "").split(".").map(Number);
+    const [cMaj, cMin, cPat] = parse(current);
+    const [lMaj, lMin, lPat] = parse(latest);
+    if (lMaj !== cMaj)
+        return lMaj > cMaj;
+    if (lMin !== cMin)
+        return lMin > cMin;
+    return lPat > cPat;
+}
+/**
+ * Check for updates in the background. Call early so the fetch
+ * runs concurrently with the actual command, then call `notify()`
+ * after the command finishes to print the message (if any).
+ */
+export function checkForUpdates(currentVersion) {
+    let message = null;
+    // Skip for pre-release versions
+    if (currentVersion.includes("-")) {
+        return { notify: () => { } };
+    }
+    const cache = readCache();
+    const now = Date.now();
+    // Use cached result if recent enough
+    if (cache && now - cache.lastCheck < CHECK_INTERVAL_MS) {
+        if (compareVersions(currentVersion, cache.latestVersion)) {
+            message = formatMessage(currentVersion, cache.latestVersion);
+        }
+        return { notify: () => message && console.error(message) };
+    }
+    // Fire off the check in the background
+    const pending = fetchLatestVersion().then((latest) => {
+        if (latest) {
+            writeCache({ lastCheck: now, latestVersion: latest });
+            if (compareVersions(currentVersion, latest)) {
+                message = formatMessage(currentVersion, latest);
+            }
+        }
+    });
+    return {
+        notify: async () => {
+            await pending;
+            if (message)
+                console.error(message);
+        },
+    };
+}
+function formatMessage(current, latest) {
+    return [
+        "",
+        chalk.yellow(`Update available: ${chalk.dim(current)} → ${chalk.green(latest)}`),
+        chalk.yellow(`Run ${chalk.cyan(`npm i -g ${PKG_NAME}`)} to update`),
+        "",
+    ].join("\n");
+}
+//# sourceMappingURL=update-notifier.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@manfred-kunze-dev/backbone-cli",
-  "version": "2.13.0-dev.4",
+  "version": "2.13.0-dev.6",
   "description": "CLI for the Backbone AI platform",
   "type": "module",
   "main": "dist/index.js",