@manfred-kunze-dev/backbone-cli 2.12.0 → 2.13.0-dev.10

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/commands/analytics.js

@@ -8,7 +8,9 @@ function addDateOptions(cmd) {
         .option("--end <date>", "End date (YYYY-MM-DD)");
 }
 export function makeAnalyticsCommand() {
-    const cmd = new Command("analytics").description("Project analytics");
+    const cmd = new Command("analytics")
+        .description("Project analytics")
+        .option("--project <id>", "Project ID");
     const summary = new Command("summary").description("Get summary analytics");
     addDateOptions(summary);
     summary.action(async (opts, command) => {

package/dist/commands/auth.js

@@ -1,8 +1,7 @@
 import { Command } from "commander";
 import chalk from "chalk";
-import { store, resolveConfig } from "../lib/config.js";
+import { store, resolveConfig, isJsonOutput, getActiveContextName, getActiveContext, getContextCount, setContext, setActiveContext, deleteContext, } from "../lib/config.js";
 import { getClient, runAction } from "../lib/client.js";
-import { isJsonOutput } from "../lib/config.js";
 import { createInterface } from "node:readline/promises";
 export function makeAuthCommand() {
     const cmd = new Command("auth").description("Manage authentication");
@@ -14,6 +13,8 @@ export function makeAuthCommand() {
         .action(async (opts) => {
         let apiKey = opts.apiKey;
         let baseUrl = opts.baseUrl;
+        const contextName = getActiveContextName();
+        const currentCtx = getActiveContext();
         if (!apiKey || !baseUrl) {
             const rl = createInterface({
                 input: process.stdin,
@@ -21,9 +22,10 @@ export function makeAuthCommand() {
             });
             try {
                 if (!baseUrl) {
-                    baseUrl = await rl.question(`Base URL [${store.get("baseUrl") ?? "https://backbone.manfred-kunze.dev/api"}]: `);
+                    const defaultUrl = currentCtx?.baseUrl ?? "https://backbone.manfred-kunze.dev/api";
+                    baseUrl = await rl.question(`Base URL [${defaultUrl}]: `);
                     if (!baseUrl)
-                        baseUrl = store.get("baseUrl") ?? "https://backbone.manfred-kunze.dev/api";
+                        baseUrl = defaultUrl;
                 }
                 if (!apiKey) {
                     apiKey = await rl.question("API Key (sk_...): ");
@@ -37,8 +39,8 @@ export function makeAuthCommand() {
             console.error(chalk.red("API key is required."));
             process.exit(1);
         }
-        store.set("apiKey", apiKey);
-        store.set("baseUrl", baseUrl);
+        setContext(contextName, { apiKey, baseUrl });
+        setActiveContext(contextName);
         console.log(chalk.green("Credentials saved successfully."));
         console.log(chalk.dim(`Config stored at: ${store.path}`));
     });
@@ -46,9 +48,16 @@ export function makeAuthCommand() {
         .command("logout")
         .description("Clear stored credentials")
         .action(() => {
-        store.delete("apiKey");
-        store.delete("baseUrl");
-        store.delete("project");
+        const contextName = getActiveContextName();
+        const count = getContextCount();
+        if (count <= 1) {
+            // Last context — clear it by resetting the store
+            store.store = { activeContext: "default", contexts: {} };
+        }
+        else {
+            deleteContext(contextName);
+            console.log(chalk.dim(`Removed context "${contextName}". Switched to "${getActiveContextName()}".`));
+        }
         console.log(chalk.green("Credentials cleared."));
     });
     cmd
@@ -73,6 +82,8 @@ export function makeAuthCommand() {
             }
             const { apiKey, baseUrl } = config;
             const keyPreview = apiKey.slice(0, 7) + "..." + apiKey.slice(-4);
+            const multiContext = getContextCount() > 1;
+            const contextName = getActiveContextName();
             // Try to validate by listing models (lightweight call)
             try {
                 const client = getClient(command);
@@ -81,6 +92,7 @@ export function makeAuthCommand() {
                 if (json) {
                     console.log(JSON.stringify({
                         authenticated: true,
+                        ...(multiContext ? { context: contextName } : {}),
                         baseUrl,
                         apiKeyPreview: keyPreview,
                         modelCount,
@@ -88,6 +100,9 @@ export function makeAuthCommand() {
                 }
                 else {
                     console.log(chalk.green("Authenticated"));
+                    if (multiContext) {
+                        console.log(`  Context: ${contextName}`);
+                    }
                     console.log(`  Base URL:  ${baseUrl}`);
                     console.log(`  API Key:   ${keyPreview}`);
                     console.log(`  Models:    ${modelCount} available`);
@@ -97,6 +112,7 @@ export function makeAuthCommand() {
                 if (json) {
                     console.log(JSON.stringify({
                         authenticated: false,
+                        ...(multiContext ? { context: contextName } : {}),
                         baseUrl,
                         apiKeyPreview: keyPreview,
                         error: "Failed to validate credentials",
@@ -104,6 +120,9 @@ export function makeAuthCommand() {
                 }
                 else {
                     console.log(chalk.yellow("Credentials configured but validation failed."));
+                    if (multiContext) {
+                        console.log(`  Context: ${contextName}`);
+                    }
                     console.log(`  Base URL:  ${baseUrl}`);
                     console.log(`  API Key:   ${keyPreview}`);
                 }

package/dist/commands/config.js

@@ -1,12 +1,15 @@
 import { Command } from "commander";
 import chalk from "chalk";
-import { store, isJsonOutput } from "../lib/config.js";
-const ALLOWED_KEYS = ["apiKey", "baseUrl", "project"];
+import { store, isJsonOutput, getActiveContext, getActiveContextName, getContextCount, setContext, } from "../lib/config.js";
+const ALLOWED_KEYS = ["apiKey", "baseUrl"];
 const KEY_ALIASES = {
     "api-key": "apiKey",
     "base-url": "baseUrl",
 };
 function validateKey(key) {
+    if (key === "project") {
+        throw new Error('Project is no longer a stored config. Use --project <id> on each command.');
+    }
     const normalized = KEY_ALIASES[key] ?? key;
     if (!ALLOWED_KEYS.includes(normalized)) {
         throw new Error(`Unknown config key: "${key}". Allowed keys: ${ALLOWED_KEYS.join(", ")}`);
@@ -22,7 +25,14 @@ export function makeConfigCommand() {
         .argument("<value>", "Config value")
         .action((key, value, _opts, command) => {
         const validKey = validateKey(key);
-        store.set(validKey, value);
+        // Update the active context
+        const contextName = getActiveContextName();
+        const ctx = getActiveContext() ?? {
+            apiKey: "",
+            baseUrl: "https://backbone.manfred-kunze.dev/api",
+        };
+        ctx[validKey] = value;
+        setContext(contextName, ctx);
         if (isJsonOutput(command)) {
             console.log(JSON.stringify({ key: validKey, value }));
         }
@@ -36,7 +46,8 @@ export function makeConfigCommand() {
         .argument("<key>", `Config key (${ALLOWED_KEYS.join(", ")})`)
         .action((key, _opts, command) => {
         const validKey = validateKey(key);
-        const value = store.get(validKey);
+        const ctx = getActiveContext();
+        const value = ctx?.[validKey];
         if (isJsonOutput(command)) {
             console.log(JSON.stringify({ key: validKey, value: value ?? null }));
         }
@@ -51,10 +62,11 @@ export function makeConfigCommand() {
         .command("list")
         .description("Show all configuration values")
         .action((_opts, command) => {
-        const values = {};
-        for (const key of ALLOWED_KEYS) {
-            values[key] = store.get(key);
-        }
+        const ctx = getActiveContext();
+        const values = {
+            apiKey: ctx?.apiKey,
+            baseUrl: ctx?.baseUrl,
+        };
         if (isJsonOutput(command)) {
             console.log(JSON.stringify(values, null, 2));
         }
@@ -67,6 +79,9 @@ export function makeConfigCommand() {
                         : value;
                 console.log(`${chalk.cyan(key)}: ${display}`);
             }
+            if (getContextCount() > 1) {
+                console.log(chalk.dim(`\nContext: ${getActiveContextName()} (use "backbone context list" to see all)`));
+            }
             console.log(chalk.dim(`\nConfig file: ${store.path}`));
         }
     });

package/dist/commands/context.d.ts

@@ -0,0 +1,3 @@
+import { Command } from "commander";
+export declare function makeContextCommand(): Command;
+//# sourceMappingURL=context.d.ts.map

package/dist/commands/context.js

@@ -0,0 +1,149 @@
+import { Command } from "commander";
+import chalk from "chalk";
+import Table from "cli-table3";
+import { createInterface } from "node:readline/promises";
+import { store, isJsonOutput, getAllContexts, getActiveContextName, getContextCount, setContext, deleteContext, renameContext, setActiveContext, validateContextName, } from "../lib/config.js";
+function maskApiKey(key) {
+    if (key.length <= 11)
+        return "****";
+    return key.slice(0, 7) + "..." + key.slice(-4);
+}
+export function makeContextCommand() {
+    const cmd = new Command("context").description("Manage CLI contexts for multiple environments");
+    cmd
+        .command("list")
+        .description("List all contexts")
+        .action((_opts, command) => {
+        const contexts = getAllContexts();
+        const activeName = getActiveContextName();
+        if (isJsonOutput(command)) {
+            console.log(JSON.stringify({ activeContext: activeName, contexts }, null, 2));
+            return;
+        }
+        const names = Object.keys(contexts);
+        if (names.length === 0) {
+            console.log(chalk.dim('No contexts configured. Run "backbone auth login" to get started.'));
+            return;
+        }
+        const table = new Table({
+            head: ["", "NAME", "BASE URL", "API KEY"].map((h) => chalk.cyan(h)),
+        });
+        for (const name of names) {
+            const ctx = contexts[name];
+            table.push([
+                name === activeName ? chalk.green("*") : "",
+                name,
+                ctx.baseUrl,
+                maskApiKey(ctx.apiKey),
+            ]);
+        }
+        console.log(table.toString());
+    });
+    cmd
+        .command("use")
+        .description("Switch active context")
+        .argument("<name>", "Context name")
+        .action((name, _opts, command) => {
+        setActiveContext(name);
+        if (isJsonOutput(command)) {
+            console.log(JSON.stringify({ activeContext: name }));
+        }
+        else {
+            console.log(chalk.green(`Switched to context "${name}".`));
+        }
+    });
+    cmd
+        .command("create")
+        .description("Create a new context")
+        .argument("<name>", "Context name")
+        .option("--base-url <url>", "Base URL")
+        .option("--api-key <key>", "API key")
+        .action(async (name, opts) => {
+        validateContextName(name);
+        const contexts = getAllContexts();
+        if (contexts[name]) {
+            throw new Error(`Context "${name}" already exists. Delete it first or choose a different name.`);
+        }
+        let baseUrl = opts.baseUrl;
+        let apiKey = opts.apiKey;
+        if (!baseUrl || !apiKey) {
+            const rl = createInterface({
+                input: process.stdin,
+                output: process.stdout,
+            });
+            try {
+                if (!baseUrl) {
+                    baseUrl = await rl.question(`Base URL [https://backbone.manfred-kunze.dev/api]: `);
+                    if (!baseUrl)
+                        baseUrl = "https://backbone.manfred-kunze.dev/api";
+                }
+                if (!apiKey) {
+                    apiKey = await rl.question("API Key (sk_...): ");
+                }
+            }
+            finally {
+                rl.close();
+            }
+        }
+        if (!apiKey) {
+            console.error(chalk.red("API key is required."));
+            process.exit(1);
+        }
+        const entry = { baseUrl, apiKey };
+        setContext(name, entry);
+        // Auto-set as active if it's the first context
+        if (getContextCount() === 1) {
+            setActiveContext(name);
+        }
+        console.log(chalk.green(`Context "${name}" created.`));
+        console.log(chalk.dim(`Config stored at: ${store.path}`));
+    });
+    cmd
+        .command("current")
+        .description("Show the active context")
+        .action((_opts, command) => {
+        const name = getActiveContextName();
+        const contexts = getAllContexts();
+        const ctx = contexts[name];
+        if (isJsonOutput(command)) {
+            console.log(JSON.stringify({ name, ...(ctx ?? {}) }, null, 2));
+            return;
+        }
+        if (!ctx) {
+            console.log(chalk.yellow('No active context configured. Run "backbone auth login" to get started.'));
+            return;
+        }
+        console.log(`${chalk.cyan("Context")}: ${name}`);
+        console.log(`${chalk.cyan("Base URL")}: ${ctx.baseUrl}`);
+        console.log(`${chalk.cyan("API Key")}:  ${maskApiKey(ctx.apiKey)}`);
+    });
+    cmd
+        .command("delete")
+        .description("Delete a context")
+        .argument("<name>", "Context name")
+        .action((name, _opts, command) => {
+        deleteContext(name);
+        if (isJsonOutput(command)) {
+            console.log(JSON.stringify({ deleted: name }));
+        }
+        else {
+            console.log(chalk.green(`Context "${name}" deleted.`));
+        }
+    });
+    cmd
+        .command("rename")
+        .description("Rename a context")
+        .argument("<old>", "Current name")
+        .argument("<new>", "New name")
+        .action((oldName, newName, _opts, command) => {
+        renameContext(oldName, newName);
+        if (isJsonOutput(command)) {
+            console.log(JSON.stringify({ from: oldName, to: newName }));
+        }
+        else {
+            console.log(chalk.green(`Context "${oldName}" renamed to "${newName}".`));
+        }
+    });
+    return cmd;
+}
+//# sourceMappingURL=context.js.map

package/dist/commands/extractions.js

@@ -23,7 +23,9 @@ function readImages(paths) {
     });
 }
 export function makeExtractionsCommand() {
-    const cmd = new Command("extractions").description("Manage extractions");
+    const cmd = new Command("extractions")
+        .description("Manage extractions")
+        .option("--project <id>", "Project ID");
     cmd
         .command("create")
         .description("Create a new extraction")

package/dist/commands/prompts.js

@@ -6,7 +6,9 @@ import { addPaginationOptions, paginationParams } from "../lib/pagination.js";
 import { makePromptVersionsCommand } from "./prompt-versions.js";
 import { makePromptLabelsCommand } from "./prompt-labels.js";
 export function makePromptsCommand() {
-    const cmd = new Command("prompts").description("Manage prompts");
+    const cmd = new Command("prompts")
+        .description("Manage prompts")
+        .option("--project <id>", "Project ID");
     const list = new Command("list").description("List prompts");
     addPaginationOptions(list);
     list.option("-s, --search <term>", "Filter by name");

package/dist/commands/schemas.js

@@ -8,7 +8,9 @@ import { ensureOpenAiCompatible } from "../lib/schema-compat.js";
 import { makeSchemaVersionsCommand } from "./schema-versions.js";
 import { makeSchemaLabelsCommand } from "./schema-labels.js";
 export function makeSchemasCommand() {
-    const cmd = new Command("schemas").description("Manage schemas");
+    const cmd = new Command("schemas")
+        .description("Manage schemas")
+        .option("--project <id>", "Project ID");
     const list = new Command("list").description("List schemas");
     addPaginationOptions(list);
     list.option("-s, --search <term>", "Filter by name");

package/dist/index.js

@@ -1,6 +1,9 @@
 #!/usr/bin/env node
+import { createRequire } from "node:module";
 import { Command } from "commander";
 import { makeAuthCommand } from "./commands/auth.js";
+const require = createRequire(import.meta.url);
+const pkg = require("../package.json");
 import { makeConfigCommand } from "./commands/config.js";
 import { makeProjectsCommand } from "./commands/projects.js";
 import { makeSchemasCommand } from "./commands/schemas.js";
@@ -13,18 +16,21 @@ import { makeProvidersCommand } from "./commands/providers.js";
 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")
     .description("CLI for the Backbone AI platform")
-    .version("1.0.0")
+    .version(pkg.version)
     .option("--api-key <key>", "API key (overrides config)")
     .option("--base-url <url>", "Base URL (overrides config)")
-    .option("--project <id>", "Project ID (overrides config)")
     .option("--json", "Output as JSON")
     .option("--no-color", "Disable colored output");
 program.addCommand(makeAuthCommand());
 program.addCommand(makeConfigCommand());
+program.addCommand(makeContextCommand());
 program.addCommand(makeProjectsCommand());
 program.addCommand(makeSchemasCommand());
 program.addCommand(makePromptsCommand());
@@ -36,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/client.js

@@ -17,8 +17,8 @@ const errorMiddleware = {
         }
         throw new BackboneApiError({
             status: body.status ?? response.status,
-            error: body.error ?? response.statusText,
-            message: body.message ?? `HTTP ${response.status}: ${response.statusText}`,
+            error: body.title ?? body.error ?? response.statusText,
+            message: body.detail ?? body.message ?? `HTTP ${response.status}: ${response.statusText}`,
             timestamp: body.timestamp ?? new Date().toISOString(),
         });
     },

package/dist/lib/config.d.ts

@@ -1,18 +1,34 @@
 import Conf from "conf";
 import type { Command } from "commander";
+export interface ContextEntry {
+    baseUrl: string;
+    apiKey: string;
+}
+export interface BackboneConfigStore {
+    activeContext: string;
+    contexts: Record<string, ContextEntry>;
+}
 export interface BackboneConfig {
     apiKey: string;
     baseUrl: string;
-    project?: string;
 }
-declare const store: Conf<Partial<BackboneConfig>>;
+declare const store: Conf<BackboneConfigStore>;
 export { store };
+export declare function validateContextName(name: string): void;
+export declare function getActiveContextName(): string;
+export declare function getActiveContext(): ContextEntry | undefined;
+export declare function getAllContexts(): Record<string, ContextEntry>;
+export declare function getContextCount(): number;
+export declare function setContext(name: string, entry: ContextEntry): void;
+export declare function deleteContext(name: string): void;
+export declare function renameContext(oldName: string, newName: string): void;
+export declare function setActiveContext(name: string): void;
 /**
  * Resolve configuration with priority:
- *   1. CLI flags (--api-key, --base-url, --project)
- *   2. Environment variables (BACKBONE_API_KEY, BACKBONE_BASE_URL, BACKBONE_PROJECT)
+ *   1. CLI flags (--api-key, --base-url)
+ *   2. Environment variables (BACKBONE_API_KEY, BACKBONE_BASE_URL)
  *   3. Local .backbone file
- *   4. Config store (~/.config/backbone/config.json)
+ *   4. Active context from config store
  */
 export declare function resolveConfig(command: Command): BackboneConfig;
 /** Check if --json flag is set on root command */

package/dist/lib/config.js

@@ -4,13 +4,96 @@ import { resolve } from "node:path";
 const store = new Conf({
     projectName: "backbone",
     projectSuffix: "",
-    schema: {
-        apiKey: { type: "string" },
-        baseUrl: { type: "string" },
-        project: { type: "string" },
+    defaults: {
+        activeContext: "default",
+        contexts: {},
     },
 });
+// Migrate from old flat config format (apiKey, baseUrl, project) to contexts
+(function migrateIfNeeded() {
+    try {
+        const raw = JSON.parse(readFileSync(store.path, "utf-8"));
+        if (typeof raw.apiKey === "string" && !raw.contexts) {
+            store.store = {
+                activeContext: "default",
+                contexts: {
+                    default: {
+                        apiKey: raw.apiKey,
+                        baseUrl: raw.baseUrl ?? "https://backbone.manfred-kunze.dev/api",
+                    },
+                },
+            };
+        }
+    }
+    catch {
+        // File doesn't exist or is unparseable — nothing to migrate
+    }
+})();
 export { store };
+const CONTEXT_NAME_RE = /^[a-zA-Z0-9_-]+$/;
+export function validateContextName(name) {
+    if (!CONTEXT_NAME_RE.test(name)) {
+        throw new Error("Context name must contain only letters, numbers, hyphens, and underscores.");
+    }
+}
+export function getActiveContextName() {
+    return store.get("activeContext") ?? "default";
+}
+export function getActiveContext() {
+    const name = getActiveContextName();
+    const contexts = store.get("contexts") ?? {};
+    return contexts[name];
+}
+export function getAllContexts() {
+    return store.get("contexts") ?? {};
+}
+export function getContextCount() {
+    return Object.keys(getAllContexts()).length;
+}
+export function setContext(name, entry) {
+    validateContextName(name);
+    const contexts = getAllContexts();
+    contexts[name] = entry;
+    store.set("contexts", contexts);
+}
+export function deleteContext(name) {
+    const contexts = getAllContexts();
+    if (!contexts[name]) {
+        throw new Error(`Context "${name}" does not exist.`);
+    }
+    if (Object.keys(contexts).length === 1) {
+        throw new Error("Cannot delete the last remaining context.");
+    }
+    delete contexts[name];
+    store.set("contexts", contexts);
+    if (getActiveContextName() === name) {
+        const remaining = Object.keys(contexts)[0];
+        store.set("activeContext", remaining);
+    }
+}
+export function renameContext(oldName, newName) {
+    validateContextName(newName);
+    const contexts = getAllContexts();
+    if (!contexts[oldName]) {
+        throw new Error(`Context "${oldName}" does not exist.`);
+    }
+    if (contexts[newName]) {
+        throw new Error(`Context "${newName}" already exists.`);
+    }
+    contexts[newName] = contexts[oldName];
+    delete contexts[oldName];
+    store.set("contexts", contexts);
+    if (getActiveContextName() === oldName) {
+        store.set("activeContext", newName);
+    }
+}
+export function setActiveContext(name) {
+    const contexts = getAllContexts();
+    if (!contexts[name]) {
+        throw new Error(`Context "${name}" does not exist. Available contexts: ${Object.keys(contexts).join(", ")}`);
+    }
+    store.set("activeContext", name);
+}
 /**
  * Read .backbone file from current directory (if it exists).
  */
@@ -19,7 +102,8 @@ function readLocalFile() {
     if (!existsSync(localPath))
         return {};
     try {
-        return JSON.parse(readFileSync(localPath, "utf-8"));
+        const parsed = JSON.parse(readFileSync(localPath, "utf-8"));
+        return { apiKey: parsed.apiKey, baseUrl: parsed.baseUrl };
     }
     catch {
         return {};
@@ -27,32 +111,29 @@ function readLocalFile() {
 }
 /**
  * Resolve configuration with priority:
- *   1. CLI flags (--api-key, --base-url, --project)
- *   2. Environment variables (BACKBONE_API_KEY, BACKBONE_BASE_URL, BACKBONE_PROJECT)
+ *   1. CLI flags (--api-key, --base-url)
+ *   2. Environment variables (BACKBONE_API_KEY, BACKBONE_BASE_URL)
  *   3. Local .backbone file
- *   4. Config store (~/.config/backbone/config.json)
+ *   4. Active context from config store
  */
 export function resolveConfig(command) {
     const root = getRootCommand(command);
     const opts = root.opts();
     const local = readLocalFile();
+    const activeCtx = getActiveContext();
     const apiKey = opts.apiKey ??
         process.env.BACKBONE_API_KEY ??
         local.apiKey ??
-        store.get("apiKey");
+        activeCtx?.apiKey;
     const baseUrl = opts.baseUrl ??
         process.env.BACKBONE_BASE_URL ??
         local.baseUrl ??
-        store.get("baseUrl") ??
+        activeCtx?.baseUrl ??
         "https://backbone.manfred-kunze.dev/api";
-    const project = opts.project ??
-        process.env.BACKBONE_PROJECT ??
-        local.project ??
-        store.get("project");
     if (!apiKey) {
         throw new Error('No API key configured. Run "backbone auth login" or set BACKBONE_API_KEY.');
     }
-    return { apiKey, baseUrl, project };
+    return { apiKey, baseUrl };
 }
 /** Walk up Commander's parent chain to find root program */
 function getRootCommand(cmd) {

package/dist/lib/context.d.ts

@@ -1,6 +1,6 @@
 import type { Command } from "commander";
 /**
- * Resolve the project ID from --project flag, env var, .backbone file, or config store.
+ * Resolve the project ID from --project flag on the command or any parent command.
  * Throws a user-friendly error if no project is configured.
  */
 export declare function requireProjectId(command: Command): string;

package/dist/lib/context.js

@@ -1,14 +1,15 @@
-import { resolveConfig } from "./config.js";
 /**
- * Resolve the project ID from --project flag, env var, .backbone file, or config store.
+ * Resolve the project ID from --project flag on the command or any parent command.
  * Throws a user-friendly error if no project is configured.
  */
 export function requireProjectId(command) {
-    const config = resolveConfig(command);
-    if (!config.project) {
-        throw new Error("No project ID configured. Use --project <id>, set BACKBONE_PROJECT, or run:\n" +
-            '  backbone config set project <id>');
+    let cmd = command;
+    while (cmd) {
+        const project = cmd.opts().project;
+        if (project)
+            return project;
+        cmd = cmd.parent;
     }
-    return config.project;
+    throw new Error("Project ID is required. Use --project <id>.");
 }
 //# sourceMappingURL=context.js.map

package/dist/lib/errors.js

@@ -13,6 +13,7 @@ export class BackboneApiError extends Error {
 }
 const HINTS = {
     401: 'Invalid or missing API key. Run "backbone auth login" to configure credentials.',
+    402: "Billing limit reached. Check your plan limits or upgrade at the dashboard.",
     403: "You don't have permission for this action. Check your organization role.",
     404: "Resource not found. Verify the ID is correct.",
     409: "Conflict — the resource may already exist or was modified concurrently.",

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.12.0",
+  "version": "2.13.0-dev.10",
   "description": "CLI for the Backbone AI platform",
   "type": "module",
   "main": "dist/index.js",
@@ -19,7 +19,7 @@
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "chalk": "^5.4.1",
+    "chalk": "^5.6.2",
     "cli-table3": "^0.6.5",
     "commander": "^13.1.0",
     "conf": "^13.1.0",
@@ -28,8 +28,8 @@
   },
   "devDependencies": {
     "@types/node": "^22.19.15",
-    "openapi-typescript": "^7.6.1",
-    "tsx": "^4.19.3",
+    "openapi-typescript": "^7.13.0",
+    "tsx": "^4.21.0",
     "typescript": "^5.9.3"
   },
   "engines": {