@farthershore/cli 0.2.0 → 0.3.1

package/README.md

@@ -42,12 +42,14 @@ farthershore init my-weather-api
 ```
 
 Options:
+
 - `--base-url <url>` — Backend API base URL
 - `--description <text>` — Product description
 - `--display-name <name>` — Display name for the portal
 - `--billing <strategy>` — `subscription` (default), `usage_based`, or `hybrid`
 
 The created repo contains:
+
 - `product.yaml` — template config (edit and push to go live)
 - `AGENTS.md` — full configuration reference for AI agents
 - `docs/` — developer portal documentation
@@ -65,12 +67,16 @@ farthershore validate
 farthershore validate path/to/product.yaml
 ```
 
-### `farthershore apply <product-id>`
+### `farthershore apply [product]`
 
 Run the server-side compiler against the current product configuration. Returns compilation errors and warnings. Exits with code 1 on failure — suitable for CI checks before merging.
 
 ```bash
-farthershore apply prod_abc123
+# Inside a product repo (auto-detects from product.yaml)
+farthershore apply
+
+# Or pass the product slug
+farthershore apply my-weather-api
 ```
 
 ### `farthershore set-key [token]`
@@ -85,6 +91,14 @@ Show your current authentication context (organization, auth method).
 
 Clear stored credentials.
 
+### `farthershore set-url <url>`
+
+Override the API base URL (persisted in `~/.farthershore/config.json`).
+
+### `farthershore reset-url`
+
+Reset the API base URL to the default (`https://core.farthershore.com`).
+
 ## Agent Workflow
 
 The CLI is designed for AI agents to create and configure API products:
@@ -109,17 +123,17 @@ git add -A && git commit -m "Configure product" && git push
 
 ## Global Flags
 
-| Flag | Description |
-|------|-------------|
+| Flag              | Description                          |
+| ----------------- | ------------------------------------ |
 | `--token <token>` | Override auth token for this command |
-| `--api-url <url>` | Override API base URL |
-| `--format json` | Output as JSON (default for non-TTY) |
-| `--version` | Show version |
-| `--help` | Show help |
+| `--api-url <url>` | Override API base URL                |
+| `--format json`   | Output as JSON (default for non-TTY) |
+| `--version`       | Show version                         |
+| `--help`          | Show help                            |
 
 ## Environment Variables
 
-| Variable | Description |
-|----------|-------------|
-| `FARTHERSHORE_TOKEN` | API token (overrides stored credentials) |
-| `FARTHERSHORE_API_URL` | API base URL (default: `https://api.farthershore.com`) |
+| Variable               | Description                                             |
+| ---------------------- | ------------------------------------------------------- |
+| `FARTHERSHORE_TOKEN`   | API token (overrides stored credentials)                |
+| `FARTHERSHORE_API_URL` | API base URL (default: `https://core.farthershore.com`) |

package/dist/client.d.ts

@@ -81,5 +81,18 @@ export declare function createClient(opts: {
             message: string;
         }>;
     }>;
+    managementCompile: (productId: string) => Promise<{
+        success: boolean;
+        errors?: Array<{
+            code?: string;
+            message: string;
+        }>;
+        warnings?: Array<{
+            code?: string;
+            message: string;
+        }>;
+    }>;
+    managementListProducts: () => Promise<Product[]>;
+    isMakerToken: () => boolean;
 };
 export type ApiClient = ReturnType<typeof createClient>;

package/dist/client.js

@@ -68,5 +68,9 @@ export function createClient(opts) {
         getUsage: (productId) => request("GET", `/products/${productId}/usage`),
         // --- Compile ---
         compileProduct: (productId) => request("POST", `/products/${productId}/compile`),
+        // --- Management (maker token) ---
+        managementCompile: (productId) => request("POST", `/management/products/${productId}/compile`),
+        managementListProducts: () => request("GET", "/management/products"),
+        isMakerToken: () => opts.token.startsWith("mk_"),
     };
 }

package/dist/commands/apply.js

@@ -1,13 +1,74 @@
+import { readFileSync, existsSync } from "node:fs";
+import { resolve } from "node:path";
+import YAML from "yaml";
 import * as output from "../output.js";
 const CI = !!process.env.CI || !!process.env.GITHUB_ACTIONS;
+/**
+ * Read the product name/slug from product.yaml in the current directory.
+ */
+function readSlugFromProductYaml() {
+    const yamlPath = resolve("product.yaml");
+    if (!existsSync(yamlPath))
+        return null;
+    try {
+        const spec = YAML.parse(readFileSync(yamlPath, "utf-8"));
+        const product = spec.product;
+        return product?.name ?? null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Resolve a product identifier to an API product ID.
+ * If no arg, reads product.name from product.yaml in the current directory.
+ * If arg looks like a UUID, uses it directly. Otherwise treats it as a slug.
+ */
+async function resolveProductId(client, arg) {
+    const slug = arg ?? readSlugFromProductYaml();
+    if (!slug)
+        return null;
+    // UUID — use directly
+    if (slug.length === 36 &&
+        /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/.test(slug)) {
+        return slug;
+    }
+    // Slug — resolve via product list (use management API for maker tokens)
+    try {
+        const products = client.isMakerToken()
+            ? await client.managementListProducts()
+            : await client.listProducts();
+        const match = products.find((p) => p.name === slug || p.name.toLowerCase() === slug.toLowerCase());
+        return match?.id ?? null;
+    }
+    catch (err) {
+        // Don't swallow network errors silently
+        const msg = err instanceof Error ? err.message : String(err);
+        process.stderr.write(`Warning: Failed to resolve product slug: ${msg}\n`);
+        return null;
+    }
+}
 export function registerApplyCommand(program, getClient) {
     program
-        .command("apply <product-id>")
-        .description("Run the server-side compiler to check if the current config is valid")
-        .action(async (productId) => {
+        .command("apply [product]")
+        .description("Run the server-side compiler to check if the current config is valid. " +
+        "Pass a product slug, or run inside a product repo to auto-detect from product.yaml.")
+        .action(async (productArg) => {
         const client = getClient();
+        const productId = await resolveProductId(client, productArg);
+        if (!productId) {
+            const hint = productArg
+                ? `Product "${productArg}" not found. Check the name and try again.`
+                : "No product specified and no product.yaml found.\n" +
+                    "  Run from inside a product repo, or pass the slug: farthershore apply my-api";
+            output.error(hint);
+            process.exitCode = 1;
+            return;
+        }
         try {
-            const result = await client.compileProduct(productId);
+            const result = client.isMakerToken()
+                ? await client.managementCompile(productId)
+                : await client.compileProduct(productId);
             // GitHub Actions annotations
             if (CI) {
                 for (const err of result.errors ?? []) {

package/dist/commands/login.js

@@ -1,6 +1,6 @@
 import * as readline from "node:readline/promises";
 import { createClient } from "../client.js";
-import { loadConfig, saveCredentials, clearCredentials } from "../config.js";
+import { loadConfig, saveConfig, saveCredentials, clearCredentials, } from "../config.js";
 import { resolveToken } from "../auth.js";
 import * as output from "../output.js";
 export function registerAuthCommands(program) {
@@ -65,6 +65,7 @@ export function registerAuthCommands(program) {
             const ctx = await client.bootstrap();
             output.heading("Current Context");
             console.log(`  Organization: ${ctx.activeOrganization.name ?? ctx.activeOrganization.id}`);
+            console.log(`  API URL:      ${config.apiUrl}`);
             if (process.env.FARTHERSHORE_TOKEN) {
                 output.info("  Auth: FARTHERSHORE_TOKEN env var");
             }
@@ -77,4 +78,18 @@ export function registerAuthCommands(program) {
             process.exitCode = 1;
         }
     });
+    program
+        .command("set-url <url>")
+        .description("Override the API base URL (for staging/testing)")
+        .action((url) => {
+        saveConfig({ apiUrl: url });
+        output.success(`API URL set to ${url}`);
+    });
+    program
+        .command("reset-url")
+        .description("Reset the API URL to production default")
+        .action(() => {
+        saveConfig({ apiUrl: "https://core.farthershore.com" });
+        output.success("API URL reset to https://core.farthershore.com");
+    });
 }

package/dist/commands/validate.js

@@ -1,8 +1,30 @@
 import { readFileSync, existsSync } from "node:fs";
+import { execSync } from "node:child_process";
 import { resolve } from "node:path";
 import YAML from "yaml";
 import * as output from "../output.js";
 const CI = !!process.env.CI || !!process.env.GITHUB_ACTIONS;
+/**
+ * Read product.yaml from the main branch using git, without checking it out.
+ * Returns null if not in a git repo or main doesn't have the file.
+ */
+function readMainBranchProductName() {
+    for (const branch of ["main", "master"]) {
+        try {
+            const yaml = execSync(`git show ${branch}:product.yaml 2>/dev/null`, {
+                encoding: "utf-8",
+                stdio: ["pipe", "pipe", "pipe"],
+            });
+            const spec = YAML.parse(yaml);
+            const product = spec.product;
+            return product?.name ?? null;
+        }
+        catch {
+            continue;
+        }
+    }
+    return null;
+}
 // Inline a lightweight validation since we can't import the core schema directly.
 // Checks structure, required fields, and strategy/model alignment.
 function validateProductYaml(spec) {
@@ -31,13 +53,25 @@ function validateProductYaml(spec) {
     if (!metering)
         errors.push("Missing 'metering' section");
     else {
-        const meters = (metering.meters ?? []);
-        if (meters.length === 0)
-            errors.push("At least one meter is required in metering.meters");
-        if (meters.length > 10)
-            errors.push("Maximum 10 meters allowed");
+        const rawMeters = metering.meters ?? [];
+        if (!Array.isArray(rawMeters)) {
+            errors.push("'metering.meters' must be an array");
+        }
+        else {
+            const meters = rawMeters;
+            if (meters.length === 0)
+                errors.push("At least one meter is required in metering.meters");
+            if (meters.length > 10)
+                errors.push("Maximum 10 meters allowed");
+        }
+    }
+    const rawPlans = spec.plans ?? [];
+    const plans = Array.isArray(rawPlans)
+        ? rawPlans
+        : [];
+    if (spec.plans != null && !Array.isArray(spec.plans)) {
+        errors.push("'plans' must be an array");
     }
-    const plans = (spec.plans ?? []);
     if (plans.length === 0)
         errors.push("At least one plan is required to go live");
     if (plans.length > 4)
@@ -113,6 +147,15 @@ export function registerValidateCommand(program) {
             return;
         }
         const result = validateProductYaml(spec);
+        // Check product.name consistency against main branch
+        const currentName = spec.product
+            ?.name;
+        if (currentName) {
+            const mainName = readMainBranchProductName();
+            if (mainName && mainName !== currentName) {
+                result.errors.push(`product.name "${currentName}" differs from main branch "${mainName}" — product name must not change`);
+            }
+        }
         // GitHub Actions annotations
         if (CI) {
             for (const err of result.errors) {
@@ -122,7 +165,7 @@ export function registerValidateCommand(program) {
                 console.log(`::warning file=product.yaml::${w}`);
             }
         }
-        if (result.valid) {
+        if (result.errors.length === 0) {
             output.success("product.yaml is valid");
             if (result.warnings.length > 0) {
                 for (const w of result.warnings) {

package/dist/config.js

@@ -8,11 +8,11 @@ const CREDENTIALS_FILE = join(CONFIG_DIR, "credentials.json");
 const CONFIGS_DIR = join(CONFIG_DIR, "configs");
 function ensureDir(dir) {
     if (!existsSync(dir))
-        mkdirSync(dir, { recursive: true });
+        mkdirSync(dir, { recursive: true, mode: 0o700 });
 }
 // --- Config ---
 const DEFAULT_CONFIG = {
-    apiUrl: "https://api.farthershore.com",
+    apiUrl: "https://core.farthershore.com",
     defaultFormat: "table",
 };
 export function loadConfig() {
@@ -47,7 +47,9 @@ export function loadCredentials() {
 }
 export function saveCredentials(creds) {
     ensureDir(CONFIG_DIR);
-    writeFileSync(CREDENTIALS_FILE, JSON.stringify(creds, null, 2) + "\n");
+    writeFileSync(CREDENTIALS_FILE, JSON.stringify(creds, null, 2) + "\n", {
+        mode: 0o600,
+    });
 }
 export function clearCredentials() {
     if (existsSync(CREDENTIALS_FILE)) {

package/package.json

@@ -1,11 +1,10 @@
 {
   "name": "@farthershore/cli",
-  "version": "0.2.0",
-  "description": "FartherShore CLI — manage API products, plans, and billing from the terminal",
+  "version": "0.3.1",
+  "description": "FartherShore CLI — create and configure API products",
   "type": "module",
   "bin": {
-    "farthershore": "./dist/index.js",
-    "cli": "./dist/index.js"
+    "farthershore": "./dist/index.js"
   },
   "files": [
     "dist"
@@ -41,11 +40,9 @@
   "dependencies": {
     "chalk": "^5.4.1",
     "commander": "^13.1.0",
-    "js-yaml": "^4.1.0",
     "yaml": "^2.8.3"
   },
   "devDependencies": {
-    "@types/js-yaml": "^4.0.9",
     "@types/node": "^22.19.17",
     "prettier": "^3.8.1",
     "tsx": "^4.21.0",

package/dist/commands/billing.d.ts

@@ -1,3 +0,0 @@
-import { Command } from "commander";
-import type { ApiClient } from "../client.js";
-export declare function registerBillingCommands(program: Command, getClient: () => ApiClient): void;

package/dist/commands/billing.js

@@ -1,31 +0,0 @@
-import * as output from "../output.js";
-export function registerBillingCommands(program, getClient) {
-    const billing = program
-        .command("billing")
-        .description("Stripe billing integration");
-    billing
-        .command("status")
-        .description("Show Stripe connection status")
-        .action(async () => {
-        const client = getClient();
-        const status = await client.getStripeStatus();
-        if (status.connected) {
-            output.success("Stripe connected");
-            console.log(`  Account:         ${status.accountId}`);
-            console.log(`  Charges enabled: ${status.chargesEnabled ? "✓" : "✗"}`);
-        }
-        else {
-            output.warn("Stripe not connected.");
-            output.info("Run `farthershore billing connect` to start onboarding.");
-        }
-    });
-    billing
-        .command("connect")
-        .description("Start Stripe Connect onboarding (opens browser)")
-        .action(async () => {
-        const client = getClient();
-        const result = await client.startStripeOnboard();
-        output.success("Stripe onboarding started.");
-        console.log(`\n  Open this URL in your browser:\n  ${result.url}\n`);
-    });
-}

package/dist/commands/dry-run.d.ts

@@ -1,3 +0,0 @@
-import { Command } from "commander";
-import type { ApiClient } from "../client.js";
-export declare function registerDryRunCommand(program: Command, getClient: () => ApiClient): void;

package/dist/commands/dry-run.js

@@ -1,33 +0,0 @@
-import * as output from "../output.js";
-export function registerDryRunCommand(program, getClient) {
-    program
-        .command("dry-run <product-id>")
-        .description("Check if the current product config would pass compilation")
-        .action(async (productId) => {
-        const client = getClient();
-        try {
-            const result = await client.compileProduct(productId);
-            if (result.success) {
-                output.success("Compilation passed — changes would be accepted");
-                if (result.warnings?.length) {
-                    console.log();
-                    output.warn(`${result.warnings.length} warning(s):`);
-                    for (const w of result.warnings) {
-                        console.log(`  • ${w.message ?? w}`);
-                    }
-                }
-            }
-            else {
-                output.error("Compilation failed — changes would be rejected\n");
-                for (const err of result.errors ?? []) {
-                    console.log(`  • ${err.code ? `[${err.code}] ` : ""}${err.message}`);
-                }
-                process.exitCode = 1;
-            }
-        }
-        catch (err) {
-            output.error(err instanceof Error ? err.message : "Compilation check failed");
-            process.exitCode = 1;
-        }
-    });
-}

package/dist/commands/plans.d.ts

@@ -1,3 +0,0 @@
-import { Command } from "commander";
-import type { ApiClient } from "../client.js";
-export declare function registerPlanCommands(program: Command, getClient: () => ApiClient): void;

package/dist/commands/plans.js

@@ -1,204 +0,0 @@
-import * as readline from "node:readline/promises";
-import { writeConfigFile, readConfigFile, getConfigPath } from "../config.js";
-import * as output from "../output.js";
-export function registerPlanCommands(program, getClient) {
-    const plans = program.command("plans").description("Manage product plans");
-    plans
-        .command("list")
-        .description("List plans for a product")
-        .requiredOption("--product <id>", "Product ID")
-        .action(async (opts) => {
-        const client = getClient();
-        const product = await client.getProduct(opts.product);
-        if (!product.plans?.length) {
-            output.info("No plans found.");
-            return;
-        }
-        console.log(output.table(["Name", "Key", "Type", "Price", "Active"], product.plans.map((p) => [
-            p.name,
-            p.key,
-            p.type,
-            p.monthlyPriceCents > 0
-                ? output.formatPrice(p.monthlyPriceCents) + "/mo"
-                : "free",
-            p.isActive ? "✓" : "✗",
-        ])));
-    });
-    // --- Config-as-code commands ---
-    plans
-        .command("pull")
-        .description("Pull plan config from server to local YAML file")
-        .requiredOption("--product <id>", "Product ID or slug")
-        .action(async (opts) => {
-        const client = getClient();
-        const yamlStr = await client.exportPlanConfig(opts.product);
-        // Derive slug for local storage
-        const product = await client.getProduct(opts.product);
-        const slug = product.runtimeHostname?.split(".")[0] ??
-            product.name.toLowerCase().replace(/\s+/g, "-");
-        const path = writeConfigFile(slug, yamlStr);
-        output.success(`Pulled ${product.plans?.length ?? 0} plans from "${product.name}"`);
-        console.log(`  Written to ${path}`);
-    });
-    plans
-        .command("push")
-        .description("Validate, diff, and apply local plan config")
-        .requiredOption("--product <id>", "Product ID or slug")
-        .option("--yes", "Skip confirmation prompt (CI mode)")
-        .option("--force", "Override config hash check")
-        .action(async (opts) => {
-        const client = getClient();
-        // Load local config
-        const product = await client.getProduct(opts.product);
-        const slug = product.runtimeHostname?.split(".")[0] ??
-            product.name.toLowerCase().replace(/\s+/g, "-");
-        const yamlStr = readConfigFile(slug);
-        if (!yamlStr) {
-            output.error(`No local config found. Run \`farthershore plans pull --product ${opts.product}\` first.`);
-            process.exit(1);
-        }
-        // Extract configHash
-        const hashMatch = yamlStr.match(/configHash:\s*['"]?([a-f0-9]+)['"]?/);
-        const configHash = hashMatch?.[1];
-        // Step 1: Validate + diff
-        output.info("Validating...");
-        const diff = await client.applyPlanConfig(opts.product, yamlStr, {
-            configHash,
-            force: opts.force,
-            validateOnly: true,
-        });
-        if (!diff.valid) {
-            output.error("Validation failed:\n");
-            for (const err of diff.errors) {
-                console.error(`  ${err.line != null ? `Line ${err.line}: ` : ""}${err.message}`);
-            }
-            process.exit(1);
-        }
-        if (diff.changes.length === 0) {
-            output.success("No changes detected.");
-            return;
-        }
-        // Step 2: Show diff
-        const creates = diff.changes.filter((c) => c.action === "create").length;
-        const updates = diff.changes.filter((c) => c.action === "update").length;
-        const deactivates = diff.changes.filter((c) => c.action === "deactivate").length;
-        console.log(`\n  Plan: ${creates ? `${creates} to add` : ""}${creates && updates ? ", " : ""}${updates ? `${updates} to change` : ""}${(creates || updates) && deactivates ? ", " : ""}${deactivates ? `${deactivates} to deactivate` : ""}\n`);
-        for (const change of diff.changes) {
-            const symbol = change.action === "create"
-                ? "+"
-                : change.action === "update"
-                    ? "~"
-                    : "-";
-            console.log(`  ${symbol} ${change.name} (${change.key}): ${change.details}`);
-        }
-        for (const w of diff.warnings) {
-            output.warn(`  ${w.message}`);
-        }
-        // Step 3: Confirm
-        if (!opts.yes) {
-            const rl = readline.createInterface({
-                input: process.stdin,
-                output: process.stdout,
-            });
-            const answer = await rl.question("\n  Apply these changes? (yes/no): ");
-            rl.close();
-            if (answer.trim().toLowerCase() !== "yes") {
-                console.log("  Cancelled.");
-                return;
-            }
-        }
-        // Step 4: Apply
-        output.info("\n  Applying...");
-        const result = await client.applyPlanConfig(opts.product, yamlStr, {
-            configHash,
-            force: opts.force,
-        });
-        if (!result.applied) {
-            output.error("Apply failed:");
-            for (const err of result.errors) {
-                console.error(`  ${err.message}`);
-            }
-            process.exit(1);
-        }
-        for (const r of result.results ?? []) {
-            const symbol = r.action === "create" ? "+" : r.action === "update" ? "~" : "-";
-            console.log(`    ${symbol} ${r.action} ${r.key} (${r.id})`);
-        }
-        output.success(`${result.results?.length ?? 0} changes applied.`);
-    });
-    plans
-        .command("diff")
-        .description("Show what would change without applying")
-        .requiredOption("--product <id>", "Product ID or slug")
-        .action(async (opts) => {
-        const client = getClient();
-        const product = await client.getProduct(opts.product);
-        const slug = product.runtimeHostname?.split(".")[0] ??
-            product.name.toLowerCase().replace(/\s+/g, "-");
-        const yamlStr = readConfigFile(slug);
-        if (!yamlStr) {
-            output.error(`No local config found. Run \`farthershore plans pull --product ${opts.product}\` first.`);
-            process.exit(1);
-        }
-        const hashMatch = yamlStr.match(/configHash:\s*['"]?([a-f0-9]+)['"]?/);
-        const diff = await client.applyPlanConfig(opts.product, yamlStr, {
-            configHash: hashMatch?.[1],
-            validateOnly: true,
-        });
-        if (!diff.valid) {
-            output.error("Validation errors:");
-            for (const err of diff.errors)
-                console.error(`  ${err.message}`);
-            process.exit(1);
-        }
-        if (diff.changes.length === 0) {
-            output.success("No changes. Local config matches remote.");
-            return;
-        }
-        for (const change of diff.changes) {
-            const symbol = change.action === "create"
-                ? "+"
-                : change.action === "update"
-                    ? "~"
-                    : "-";
-            console.log(`  ${symbol} ${change.name} (${change.key}): ${change.details}`);
-        }
-        output.info("\n  No changes applied. Run `farthershore plans push` to apply.");
-    });
-    plans
-        .command("validate")
-        .description("Validate local config file (offline)")
-        .action(() => {
-        // TODO: Offline YAML schema validation
-        output.info("Offline validation not yet implemented. Use `farthershore plans diff` for server-side validation.");
-    });
-    plans
-        .command("status")
-        .description("Check if local config matches remote")
-        .requiredOption("--product <id>", "Product ID or slug")
-        .action(async (opts) => {
-        const client = getClient();
-        const product = await client.getProduct(opts.product);
-        const slug = product.runtimeHostname?.split(".")[0] ??
-            product.name.toLowerCase().replace(/\s+/g, "-");
-        const localYaml = readConfigFile(slug);
-        const localPath = getConfigPath(slug);
-        if (!localYaml) {
-            output.info(`No local config at ${localPath}`);
-            output.info(`Run \`farthershore plans pull --product ${opts.product}\` to fetch.`);
-            return;
-        }
-        const localHash = localYaml.match(/configHash:\s*['"]?([a-f0-9]+)['"]?/)?.[1];
-        const remoteYaml = await client.exportPlanConfig(opts.product);
-        const remoteHash = remoteYaml.match(/configHash:\s*['"]?([a-f0-9]+)['"]?/)?.[1];
-        console.log(`  Local:  ${localPath}`);
-        console.log(`  Hash:   ${localHash?.slice(0, 16) ?? "none"}...`);
-        console.log(`  Remote: ${remoteHash?.slice(0, 16) ?? "none"}...`);
-        if (localHash === remoteHash) {
-            output.success("Up to date.");
-        }
-        else {
-            output.warn("Remote has changed. Run `farthershore plans pull` to get latest.");
-        }
-    });
-}

package/dist/commands/products.d.ts

@@ -1,3 +0,0 @@
-import { Command } from "commander";
-import type { ApiClient } from "../client.js";
-export declare function registerProductCommands(program: Command, getClient: () => ApiClient): void;

package/dist/commands/products.js

@@ -1,76 +0,0 @@
-import * as output from "../output.js";
-export function registerProductCommands(program, getClient) {
-    const products = program
-        .command("products")
-        .description("Manage API products");
-    products
-        .command("list")
-        .alias("ls")
-        .description("List products in your organization")
-        .action(async () => {
-        const client = getClient();
-        const items = await client.listProducts();
-        if (items.length === 0) {
-            output.info("No products found. Create one with `farthershore products create`.");
-            return;
-        }
-        console.log(output.table(["Name", "Status", "Plans", "Created"], items.map((p) => [
-            p.name,
-            p.status,
-            String(p.plans?.length ?? 0),
-            output.formatDate(p.createdAt),
-        ])));
-    });
-    products
-        .command("get <id>")
-        .description("Show product details")
-        .action(async (id) => {
-        const client = getClient();
-        const product = await client.getProduct(id);
-        output.heading(product.name);
-        console.log(`  ID:          ${product.id}`);
-        console.log(`  Status:      ${product.status}`);
-        console.log(`  Base URL:    ${product.baseUrl}`);
-        console.log(`  Gateway:     ${product.runtimeHostname ?? "—"}`);
-        console.log(`  Portal:      ${product.portalHostname ?? "—"}`);
-        console.log(`  Plans:       ${product.plans?.length ?? 0}`);
-        if (product.plans?.length) {
-            for (const plan of product.plans) {
-                console.log(`    • ${plan.name} (${plan.type}) ${plan.monthlyPriceCents > 0 ? output.formatPrice(plan.monthlyPriceCents) + "/mo" : "free"}`);
-            }
-        }
-    });
-    products
-        .command("create <name>")
-        .description("Create a new draft product")
-        .requiredOption("--base-url <url>", "Backend API base URL")
-        .option("--description <desc>", "Product description")
-        .action(async (name, opts) => {
-        const client = getClient();
-        const product = await client.createProduct({
-            name,
-            baseUrl: opts.baseUrl,
-            description: opts.description,
-        });
-        output.success(`Created product "${product.name}" (${product.id})`);
-        console.log(`  Status:  ${product.status}`);
-        console.log(`  Gateway: ${product.runtimeHostname ?? "—"}`);
-    });
-    products
-        .command("publish <id>")
-        .description("Publish a draft product")
-        .action(async (id) => {
-        const client = getClient();
-        const product = await client.publishProduct(id);
-        output.success(`Published "${product.name}"`);
-        console.log(`  Gateway: ${product.runtimeHostname}`);
-    });
-    products
-        .command("delete <id>")
-        .description("Delete a product")
-        .action(async (id) => {
-        const client = getClient();
-        await client.deleteProduct(id);
-        output.success(`Deleted product ${id}`);
-    });
-}

package/dist/commands/team.d.ts

@@ -1,3 +0,0 @@
-import { Command } from "commander";
-import type { ApiClient } from "../client.js";
-export declare function registerTeamCommands(program: Command, getClient: () => ApiClient): void;

package/dist/commands/team.js

@@ -1,46 +0,0 @@
-import { loadCredentials } from "../config.js";
-import * as output from "../output.js";
-export function registerTeamCommands(program, getClient) {
-    const team = program.command("team").description("Manage organization team");
-    team
-        .command("list")
-        .alias("ls")
-        .description("List organization members")
-        .action(async () => {
-        const client = getClient();
-        const creds = loadCredentials();
-        if (!creds?.orgId) {
-            output.error("No active organization. Run `farthershore login` first.");
-            process.exit(1);
-        }
-        const members = await client.listMembers(creds.orgId);
-        console.log(output.table(["User ID", "Role"], members.map((m) => [m.userId, m.role])));
-    });
-    team
-        .command("invite <email>")
-        .description("Invite a member to the organization")
-        .option("--role <role>", "Role: owner, admin, or member", "member")
-        .action(async (email, opts) => {
-        const client = getClient();
-        const creds = loadCredentials();
-        if (!creds?.orgId) {
-            output.error("No active organization. Run `farthershore login` first.");
-            process.exit(1);
-        }
-        await client.inviteMember(creds.orgId, email, opts.role);
-        output.success(`Invited ${email} as ${opts.role}.`);
-    });
-    team
-        .command("remove <userId>")
-        .description("Remove a member from the organization")
-        .action(async (userId) => {
-        const client = getClient();
-        const creds = loadCredentials();
-        if (!creds?.orgId) {
-            output.error("No active organization. Run `farthershore login` first.");
-            process.exit(1);
-        }
-        await client.removeMember(creds.orgId, userId);
-        output.success(`Removed member ${userId}.`);
-    });
-}

package/dist/commands/tokens.d.ts

@@ -1,3 +0,0 @@
-import { Command } from "commander";
-import type { ApiClient } from "../client.js";
-export declare function registerTokenCommands(program: Command, getClient: () => ApiClient): void;

package/dist/commands/tokens.js

@@ -1,30 +0,0 @@
-import * as output from "../output.js";
-export function registerTokenCommands(program, getClient) {
-    const tokens = program.command("tokens").description("Manage API tokens");
-    tokens
-        .command("list")
-        .alias("ls")
-        .description("List maker tokens")
-        .action(async () => {
-        const client = getClient();
-        const items = await client.listTokens();
-        if (items.length === 0) {
-            output.info("No tokens found.");
-            return;
-        }
-        console.log(output.table(["Label", "Last 4", "Scope", "Created"], items.map((t) => [
-            t.label,
-            `...${t.lastFour}`,
-            t.productId ? `product:${t.productId.slice(0, 8)}` : "org-wide",
-            output.formatDate(t.createdAt),
-        ])));
-    });
-    tokens
-        .command("revoke <id>")
-        .description("Revoke a token")
-        .action(async (id) => {
-        const client = getClient();
-        await client.revokeToken(id);
-        output.success(`Token ${id} revoked.`);
-    });
-}

package/dist/commands/usage.d.ts

@@ -1,3 +0,0 @@
-import { Command } from "commander";
-import type { ApiClient } from "../client.js";
-export declare function registerUsageCommands(program: Command, getClient: () => ApiClient): void;

package/dist/commands/usage.js

@@ -1,23 +0,0 @@
-import * as output from "../output.js";
-export function registerUsageCommands(program, getClient) {
-    program
-        .command("usage")
-        .description("Show usage analytics for a product")
-        .requiredOption("--product <id>", "Product ID")
-        .option("--live", "Poll for live updates every 5 seconds")
-        .action(async (opts) => {
-        const client = getClient();
-        async function showUsage() {
-            const data = await client.getUsage(opts.product);
-            if (opts.live)
-                console.clear();
-            output.heading("Usage Summary");
-            console.log(output.json(data));
-        }
-        await showUsage();
-        if (opts.live) {
-            output.info("Polling every 5s. Press Ctrl+C to stop.");
-            setInterval(showUsage, 5000);
-        }
-    });
-}