letsfg 2026.5.53 → 2026.5.55

package/dist/cli.js

@@ -1,27 +1,171 @@
 #!/usr/bin/env node
 "use strict";
-var __create = Object.create;
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __getProtoOf = Object.getPrototypeOf;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
+
+// src/ranking.ts
+var W = {
+  // Generic solo / default — price-driven
+  default: {
+    price: 0.34,
+    stops: 0.22,
+    duration: 0.12,
+    depTime: 0.08,
+    arrivalTime: 0.04,
+    baggage: 0.02,
+    savings: 0.06,
+    comfortHours: 0.04,
+    layover: 0.08
+  },
+  // Business — time and directness > price; long layovers are unacceptable
+  business_traveler: {
+    price: 0.1,
+    stops: 0.26,
+    duration: 0.2,
+    depTime: 0.18,
+    arrivalTime: 0.04,
+    baggage: 0.06,
+    savings: 0,
+    comfortHours: 0.06,
+    layover: 0.1
+  },
+  // Family — directness + baggage practicality; kids + 8h layover = nightmare
+  family: {
+    price: 0.12,
+    stops: 0.2,
+    duration: 0.16,
+    depTime: 0.08,
+    arrivalTime: 0.04,
+    baggage: 0.2,
+    savings: 0.04,
+    comfortHours: 0.08,
+    layover: 0.08
+  },
+  // Couple — balance of price, comfort, arrival time, savings
+  couple: {
+    price: 0.22,
+    stops: 0.2,
+    duration: 0.12,
+    depTime: 0.1,
+    arrivalTime: 0.14,
+    baggage: 0.02,
+    savings: 0.1,
+    comfortHours: 0.04,
+    layover: 0.06
+  },
+  // Honeymoon — direct > everything; no one wants a 10h layover on their honeymoon
+  honeymoon: {
+    price: 0.08,
+    stops: 0.28,
+    duration: 0.1,
+    depTime: 0.14,
+    arrivalTime: 0.18,
+    baggage: 0.02,
+    savings: 0.02,
+    comfortHours: 0.08,
+    layover: 0.1
+  },
+  // Special occasion — still prioritize smooth timing/directness, but keep price meaningful.
+  special_occasion: {
+    price: 0.14,
+    stops: 0.24,
+    duration: 0.1,
+    depTime: 0.12,
+    arrivalTime: 0.16,
+    baggage: 0.02,
+    savings: 0.06,
+    comfortHours: 0.08,
+    layover: 0.08
+  },
+  // Ski — bag essential (equipment); early arrival to maximize slopes
+  ski: {
+    price: 0.12,
+    stops: 0.16,
+    duration: 0.1,
+    depTime: 0.16,
+    arrivalTime: 0.08,
+    baggage: 0.24,
+    savings: 0.04,
+    comfortHours: 0.02,
+    layover: 0.08
+  },
+  // Beach — arrive early to enjoy the day; price matters
+  beach: {
+    price: 0.24,
+    stops: 0.16,
+    duration: 0.1,
+    depTime: 0.1,
+    arrivalTime: 0.14,
+    baggage: 0.1,
+    savings: 0.06,
+    comfortHours: 0.04,
+    layover: 0.06
+  },
+  // City break — maximize time on the ground; 2-day trip loses half a day to a 6h layover
+  city_break: {
+    price: 0.26,
+    stops: 0.2,
+    duration: 0.08,
+    depTime: 0.12,
+    arrivalTime: 0.16,
+    baggage: 0.02,
+    savings: 0.04,
+    comfortHours: 0.04,
+    layover: 0.08
+  },
+  // Quick flight — user explicitly wants shortest possible total duration
+  quick_flight: {
+    price: 0.14,
+    stops: 0.2,
+    duration: 0.4,
+    depTime: 0.06,
+    arrivalTime: 0.04,
+    baggage: 0.02,
+    savings: 0.04,
+    comfortHours: 0.04,
+    layover: 0.06
+  },
+  // Cheapest — user explicitly asked for lowest price; price overwhelms all other factors
+  cheapest: {
+    price: 0.88,
+    stops: 0.06,
+    duration: 0.03,
+    depTime: 0.01,
+    arrivalTime: 0.01,
+    baggage: 0.01,
+    savings: 0,
+    comfortHours: 0,
+    layover: 0
+  },
+  // Cheapest direct — user asked for BOTH cheapest AND direct/nonstop.
+  // Stops must dominate enough that a direct flight wins even if it costs more;
+  // price wins within the same stop tier (all directs sorted by price, all 1-stops sorted
+  // by price below them, etc.). The scoreStops delta between 0-stop (1.00) and 1-stop (0.40)
+  // is 0.60; with stops weight 0.38 that gap is worth 0.228, which means a 1-stop would
+  // need an enormous price advantage to beat a direct — effectively "direct first".
+  cheapest_direct: {
+    price: 0.52,
+    stops: 0.38,
+    duration: 0.04,
+    depTime: 0.02,
+    arrivalTime: 0.01,
+    baggage: 0.01,
+    savings: 0,
+    comfortHours: 0,
+    layover: 0.02
+  }
+};
+var PURPOSE_WEIGHT_PROFILES = {
+  honeymoon: W.honeymoon,
+  special_occasion: W.special_occasion,
+  business: W.business_traveler,
+  ski: W.ski,
+  beach: W.beach,
+  city_break: W.city_break,
+  family_holiday: W.family,
+  graduation: W.city_break,
+  concert_festival: W.city_break,
+  sports_event: W.city_break,
+  spring_break: W.beach
 };
-var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
-  // If the importer is in node compatibility mode or this is not an ESM
-  // file that has been converted to a CommonJS file using a Babel-
-  // compatible transform (i.e. "__esModule" has not been set), then set
-  // "default" to the CommonJS "module.exports" for node compatibility.
-  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
-  mod
-));
 
 // src/index.ts
 var ErrorCode = {
@@ -134,7 +278,7 @@ var ValidationError = class extends LetsFGError {
 function routeStr(route) {
   if (!route.segments.length) return "";
   const codes = [route.segments[0].origin, ...route.segments.map((s) => s.destination)];
-  return codes.join(" \u2192 ");
+  return codes.join(" -> ");
 }
 function durationHuman(seconds) {
   const h = Math.floor(seconds / 3600);
@@ -147,79 +291,45 @@ function offerSummary(offer) {
   const airline = offer.owner_airline || offer.airlines[0] || "?";
   return `${offer.currency} ${offer.price.toFixed(2)} | ${airline} | ${route} | ${dur} | ${offer.outbound.stopovers} stop(s)`;
 }
-async function searchLocal(origin, destination, dateFrom, options = {}) {
-  const { spawn } = await import("child_process");
-  const params = JSON.stringify({
-    origin: origin.toUpperCase(),
-    destination: destination.toUpperCase(),
-    date_from: dateFrom,
-    adults: options.adults ?? 1,
-    children: options.children ?? 0,
-    currency: options.currency ?? "EUR",
-    limit: options.limit ?? 50,
-    return_date: options.returnDate,
-    cabin_class: options.cabinClass,
-    ...options.maxBrowsers != null && { max_browsers: options.maxBrowsers },
-    ...options.mode != null && { mode: options.mode }
-  });
-  return new Promise((resolve, reject) => {
-    const pythonCmd = process.platform === "win32" ? "python" : "python3";
-    const child = spawn(pythonCmd, ["-m", "letsfg.local"], {
-      stdio: ["pipe", "pipe", "pipe"]
-    });
-    let stdout = "";
-    let stderr = "";
-    child.stdout.on("data", (d) => {
-      stdout += d.toString();
-    });
-    child.stderr.on("data", (d) => {
-      stderr += d.toString();
-    });
-    child.on("close", (code) => {
-      try {
-        const data = JSON.parse(stdout);
-        if (data.error) reject(new LetsFGError(data.error));
-        else resolve(data);
-      } catch {
-        reject(new LetsFGError(
-          `Python search failed (code ${code}): ${stdout || stderr}
-Make sure LetsFG is installed: pip install letsfg && playwright install chromium`
-        ));
-      }
-    });
-    child.on("error", (err) => {
-      reject(new LetsFGError(
-        `Cannot start Python: ${err.message}
-Install: pip install letsfg && playwright install chromium`
-      ));
-    });
-    child.stdin.write(params);
-    child.stdin.end();
-  });
-}
-var DEFAULT_BASE_URL = "https://letsfg.co/developers";
+var DEFAULT_BASE_URL = "https://letsfg.co";
+var PFS_POLL_INTERVAL_MS = 1e4;
+var PFS_POLL_TIMEOUT_MS = 12e4;
 var LetsFG = class {
+  bearerToken;
   apiKey;
   baseUrl;
   timeout;
   constructor(config = {}) {
+    this.bearerToken = config.bearerToken || process.env.LETSFG_BEARER_TOKEN || "";
     this.apiKey = config.apiKey || process.env.LETSFG_API_KEY || "";
     this.baseUrl = (config.baseUrl || process.env.LETSFG_BASE_URL || DEFAULT_BASE_URL).replace(/\/$/, "");
     this.timeout = config.timeout || 3e4;
   }
+  requireAuth() {
+    if (!this.bearerToken && !this.apiKey) {
+      throw new AuthenticationError(
+        "Authentication required. Set bearerToken (from `letsfg auth`) or apiKey in config, or set LETSFG_BEARER_TOKEN / LETSFG_API_KEY env vars."
+      );
+    }
+  }
   requireApiKey() {
     if (!this.apiKey) {
       throw new AuthenticationError(
-        "API key required for this operation. Set apiKey in config or LETSFG_API_KEY env var.\nNote: searchLocal() works without an API key."
+        "Developer API key required for this operation. Set apiKey in config or LETSFG_API_KEY env var. Register at letsfg.co/developers."
       );
     }
   }
+  /** True when using PFS Bearer token (free search path) */
+  get usingPFS() {
+    return !!this.bearerToken;
+  }
   // ── Core methods ─────────────────────────────────────────────────────
   /**
-   * Search for flights — FREE, unlimited, runs locally on your machine.
+   * Search for flights — FREE.
    *
-   * Uses 200 airline connectors via Python subprocess. No backend call.
-   * Requires: pip install letsfg && playwright install chromium
+   * Uses PFS (Bearer token) or Developer API (X-API-Key) depending on config.
+   * PFS: async polling (POST /api/search -> poll /api/results/<id> every 10s).
+   * Developer API: synchronous 60-90s call.
    *
    * @param origin - IATA code (e.g., "GDN", "LON")
    * @param destination - IATA code (e.g., "BER", "BCN")
@@ -227,57 +337,60 @@ var LetsFG = class {
    * @param options - Optional search parameters
    */
   async search(origin, destination, dateFrom, options = {}) {
-    return searchLocal(origin, destination, dateFrom, options);
+    this.requireAuth();
+    const body = {
+      origin: origin.toUpperCase(),
+      destination: destination.toUpperCase(),
+      date_from: dateFrom,
+      adults: options.adults ?? 1,
+      children: options.children ?? 0,
+      currency: options.currency ?? "EUR",
+      limit: options.limit ?? 50
+    };
+    if (options.returnDate) body.return_date = options.returnDate;
+    if (options.cabinClass) body.cabin_class = options.cabinClass;
+    if (options.maxStopovers != null) body.max_stopovers = options.maxStopovers;
+    if (options.sort) body.sort = options.sort;
+    if (this.usingPFS) {
+      return this.searchPFS(body);
+    }
+    return this.post("/developers/api/v1/flights/search", body);
+  }
+  /** PFS path: POST /api/search -> poll /api/results/<id> */
+  async searchPFS(body) {
+    const { search_id } = await this.postWithBearer("/api/search", body);
+    const deadline = Date.now() + PFS_POLL_TIMEOUT_MS;
+    while (Date.now() < deadline) {
+      await new Promise((r) => setTimeout(r, PFS_POLL_INTERVAL_MS));
+      const result = await this.getNoAuth(
+        `/api/results/${search_id}`
+      );
+      if (result.status !== "pending") {
+        return result;
+      }
+    }
+    throw new LetsFGError("Search timed out after 120s. Try polling /api/results/<id> directly.", 504);
   }
   /**
-   * Resolve a city/airport name to IATA codes — runs locally, no backend call.
+   * Resolve a city/airport name to IATA codes.
    */
   async resolveLocation(query) {
-    const { spawn } = await import("child_process");
-    const params = JSON.stringify({ __resolve_location: true, query });
-    return new Promise((resolve, reject) => {
-      const pythonCmd = process.platform === "win32" ? "python" : "python3";
-      const child = spawn(pythonCmd, ["-m", "letsfg.local"], {
-        stdio: ["pipe", "pipe", "pipe"]
-      });
-      let stdout = "";
-      let stderr = "";
-      child.stdout.on("data", (d) => {
-        stdout += d.toString();
-      });
-      child.stderr.on("data", (d) => {
-        stderr += d.toString();
-      });
-      child.on("close", (code) => {
-        try {
-          const data = JSON.parse(stdout);
-          if (data.error) reject(new LetsFGError(data.error));
-          else resolve(Array.isArray(data) ? data : data.locations || [data]);
-        } catch {
-          reject(new LetsFGError(
-            `Location resolution failed (code ${code}): ${stdout || stderr}`
-          ));
-        }
-      });
-      child.on("error", (err) => {
-        reject(new LetsFGError(`Cannot start Python: ${err.message}`));
-      });
-      child.stdin.write(params);
-      child.stdin.end();
-    });
+    this.requireAuth();
+    const path = this.usingPFS ? `/api/locations?q=${encodeURIComponent(query)}` : `/developers/api/v1/flights/locations/${encodeURIComponent(query)}`;
+    const data = await this.getWithAuth(path);
+    return Array.isArray(data) ? data : data.locations || [];
   }
   /**
-   * Unlock a flight offer — FREE with GitHub star.
-   * Confirms price, reserves for 30 minutes.
+   * Unlock a flight offer — confirms live price, reveals direct airline booking URL.
+   * Cost: 1% of ticket price, min $3. Free with Developer API.
    */
   async unlock(offerId) {
-    this.requireApiKey();
-    return this.post("/api/v1/bookings/unlock", { offer_id: offerId });
+    this.requireAuth();
+    const path = this.usingPFS ? "/api/unlock" : "/developers/api/v1/bookings/unlock";
+    return this.postWithAuth(path, { offer_id: offerId });
   }
   /**
-   * Book a flight — charges ticket price via Stripe.
-   * Creates a real airline reservation with PNR.
-   *
+   * Book a flight via Developer API — charges ticket price via Stripe, creates real PNR.
    * Always provide idempotencyKey to prevent double-bookings on retry.
    */
   async book(offerId, passengers, contactEmail, contactPhone = "", idempotencyKey = "") {
@@ -290,113 +403,32 @@ var LetsFG = class {
       contact_phone: contactPhone
     };
     if (idempotencyKey) body.idempotency_key = idempotencyKey;
-    return this.post("/api/v1/bookings/book", body);
+    return this.post("/developers/api/v1/bookings/book", body);
   }
   /**
-   * Set up payment method (required before booking).
+   * Set up payment method (required before unlock/booking).
    */
   async setupPayment(token = "tok_visa") {
     this.requireApiKey();
-    return this.post("/api/v1/agents/setup-payment", { token });
-  }
-  /**
-   * Start automated checkout — drives to payment page, NEVER submits payment.
-   *
-   * Requires unlock first. Returns progress with screenshot and
-   * booking URL for manual completion.
-   *
-   * @param offerId - Offer ID from search results
-   * @param passengers - Passenger details (use test data for safety)
-   * @param checkoutToken - Token from unlock() response
-   */
-  async startCheckout(offerId, passengers, checkoutToken) {
-    this.requireApiKey();
-    return this.post("/api/v1/bookings/start-checkout", {
-      offer_id: offerId,
-      passengers,
-      checkout_token: checkoutToken
-    });
-  }
-  /**
-   * Start checkout locally via Python (runs on your machine).
-   * Requires: pip install letsfg && playwright install chromium
-   *
-   * @param offer - Full FlightOffer object from search results
-   * @param passengers - Passenger details
-   * @param checkoutToken - Token from unlock()
-   */
-  async startCheckoutLocal(offer, passengers, checkoutToken) {
-    const { spawn } = await import("child_process");
-    const input = JSON.stringify({
-      __checkout: true,
-      offer,
-      passengers,
-      checkout_token: checkoutToken,
-      api_key: this.apiKey,
-      base_url: this.baseUrl
-    });
-    return new Promise((resolve, reject) => {
-      const pythonCmd = process.platform === "win32" ? "python" : "python3";
-      const child = spawn(pythonCmd, ["-m", "letsfg.local"], {
-        stdio: ["pipe", "pipe", "pipe"],
-        timeout: 18e4
-      });
-      let stdout = "";
-      let stderr = "";
-      child.stdout.on("data", (d) => {
-        stdout += d.toString();
-      });
-      child.stderr.on("data", (d) => {
-        stderr += d.toString();
-      });
-      child.on("close", (code) => {
-        try {
-          const data = JSON.parse(stdout);
-          if (data.error) reject(new LetsFGError(data.error));
-          else resolve(data);
-        } catch {
-          reject(new LetsFGError(`Checkout failed (code ${code}): ${stdout || stderr}`));
-        }
-      });
-      child.on("error", (err) => {
-        reject(new LetsFGError(`Cannot start Python: ${err.message}`));
-      });
-      child.stdin.write(input);
-      child.stdin.end();
-    });
-  }
-  /**
-   * Link GitHub account for FREE unlimited access.
-   *
-   * Star https://github.com/LetsFG/LetsFG, then call this with your username.
-   * Once verified, access is permanent.
-   */
-  async linkGithub(githubUsername) {
-    this.requireApiKey();
-    return this.post("/api/v1/agents/link-github", { github_username: githubUsername });
+    return this.post("/developers/api/v1/agents/setup-payment", { token });
   }
   /**
    * Get current agent profile and usage stats.
    */
   async me() {
     this.requireApiKey();
-    return this.get("/api/v1/agents/me");
+    return this.get("/developers/api/v1/agents/me");
   }
   // ── Static methods ───────────────────────────────────────────────────
   /**
-   * Register a new agent — no API key needed.
+   * Register a new Developer API agent — no auth needed.
    */
   static async register(agentName, email, baseUrl, ownerName = "", description = "") {
     const url = (baseUrl || DEFAULT_BASE_URL).replace(/\/$/, "");
-    const resp = await fetch(`${url}/api/v1/agents/register`, {
+    const resp = await fetch(`${url}/developers/api/v1/agents/register`, {
       method: "POST",
       headers: { "Content-Type": "application/json" },
-      body: JSON.stringify({
-        agent_name: agentName,
-        email,
-        owner_name: ownerName,
-        description
-      })
+      body: JSON.stringify({ agent_name: agentName, email, owner_name: ownerName, description })
     });
     const data = await resp.json();
     if (!resp.ok) {
@@ -409,28 +441,39 @@ var LetsFG = class {
     return data;
   }
   // ── Internal ────────────────────────────────────────────────────────
+  async postWithBearer(path, body) {
+    return this.requestWithHeaders(path, "POST", { "Authorization": `Bearer ${this.bearerToken}` }, body);
+  }
+  async getNoAuth(path) {
+    return this.requestWithHeaders(path, "GET", {});
+  }
+  async getWithAuth(path) {
+    const headers = this.usingPFS ? { "Authorization": `Bearer ${this.bearerToken}` } : { "X-API-Key": this.apiKey };
+    return this.requestWithHeaders(path, "GET", headers);
+  }
+  async postWithAuth(path, body) {
+    const headers = this.usingPFS ? { "Authorization": `Bearer ${this.bearerToken}` } : { "X-API-Key": this.apiKey };
+    return this.requestWithHeaders(path, "POST", headers, body);
+  }
   async post(path, body) {
-    return this.request(path, {
-      method: "POST",
-      body: JSON.stringify(body)
-    });
+    return this.requestWithHeaders(path, "POST", { "X-API-Key": this.apiKey }, body);
   }
   async get(path) {
-    return this.request(path, { method: "GET" });
+    return this.requestWithHeaders(path, "GET", { "X-API-Key": this.apiKey });
   }
-  async request(path, init) {
+  async requestWithHeaders(path, method, extraHeaders, body) {
     const controller = new AbortController();
     const timer = setTimeout(() => controller.abort(), this.timeout);
     try {
       const resp = await fetch(`${this.baseUrl}${path}`, {
-        ...init,
+        method,
         headers: {
           "Content-Type": "application/json",
-          "X-API-Key": this.apiKey,
           "User-Agent": "LetsFG-js/0.1.0",
           "X-Client-Type": "js-sdk",
-          ...init.headers || {}
+          ...extraHeaders
         },
+        ...body != null ? { body: JSON.stringify(body) } : {},
         signal: controller.signal
       });
       const data = await resp.json();
@@ -663,50 +706,9 @@ async function cmdRegister(args) {
     Save your API key:`);
   console.log(`    export LETSFG_API_KEY=${result.api_key}`);
   console.log(`
-    Next: Star the repo and link your GitHub:`);
-  console.log(`    1. Star https://github.com/LetsFG/LetsFG`);
-  console.log(`    2. letsfg star --github <your-github-username>
+    Next: letsfg search GDN BCN 2026-07-15
 `);
 }
-async function cmdStar(args) {
-  const jsonOut = hasFlag(args, "--json") || hasFlag(args, "-j");
-  const apiKey = getFlag(args, "--api-key", "-k");
-  const baseUrl = getFlag(args, "--base-url");
-  const github = getFlag(args, "--github", "-g");
-  if (!github) {
-    console.error("Usage: letsfg star --github <your-github-username>");
-    process.exit(1);
-  }
-  const bt = new LetsFG({ apiKey, baseUrl });
-  const result = await bt.linkGithub(github);
-  if (jsonOut) {
-    console.log(JSON.stringify(result, null, 2));
-    return;
-  }
-  const status = result.status;
-  if (status === "verified") {
-    console.log(`
-  \u2713 GitHub star verified! Unlimited access granted.`);
-    console.log(`    Username: ${result.github_username}`);
-    console.log(`
-    You're all set \u2014 search, unlock, and book for free.
-`);
-  } else if (status === "already_verified") {
-    console.log(`
-  \u2713 Already verified! You have unlimited access.`);
-    console.log(`    Username: ${result.github_username}
-`);
-  } else if (status === "star_required") {
-    console.log(`
-  \u2717 Star not found for '${github}'.`);
-    console.log(`    1. Star the repo: https://github.com/LetsFG/LetsFG`);
-    console.log(`    2. Run this command again.
-`);
-  } else {
-    console.error(`  \u2717 Unexpected status: ${status}`);
-    process.exit(1);
-  }
-}
 async function cmdSetupPayment(args) {
   const jsonOut = hasFlag(args, "--json") || hasFlag(args, "-j");
   const apiKey = getFlag(args, "--api-key", "-k");
@@ -743,17 +745,8 @@ async function cmdMe(args) {
   Agent: ${p.agent_name} (${p.agent_id})`);
   console.log(`  Email: ${p.email}`);
   console.log(`  Tier:  ${p.tier}`);
-  const gh = p.github_username || "";
-  const starOk = p.github_star_verified || false;
-  if (starOk) {
-    console.log(`  GitHub:  \u2713 ${gh} (star verified)`);
-  } else if (gh) {
-    console.log(`  GitHub:  ${gh} (star not yet verified \u2014 run: letsfg star --github ${gh})`);
-  } else {
-    console.log(`  GitHub:  Not linked \u2014 run: letsfg star --github <username>`);
-  }
   const access = p.access_granted || false;
-  console.log(`  Access:  ${access ? "\u2713 Granted (search, unlock, book)" : "\u2717 Not granted \u2014 star the repo to unlock"}`);
+  console.log(`  Access:  ${access ? "\u2713 Granted (search, unlock, book)" : "\u2717 Not granted"}`);
   console.log(`  Payment: ${p.payment_ready ? "\u2713 Ready" : "\u2014"}`);
   console.log(`  Searches: ${u.total_searches || 0}`);
   console.log(`  Unlocks:  ${u.total_unlocks || 0}`);
@@ -764,17 +757,16 @@ async function cmdMe(args) {
 var HELP = `
 LetsFG \u2014 Agent-native flight search & booking.
 
-Search 400+ airlines at raw airline prices \u2014 $20-50 cheaper than OTAs.
-100% FREE \u2014 just star our GitHub repo for unlimited access.
+Search hundreds of airlines via the LetsFG cloud engine.
+Free search: authenticate once with Twitter/X, then search instantly.
 
 Commands:
-  search <origin> <dest> <date>   Search for flights (FREE)
+  search <origin> <dest> <date>   Search for flights (free)
   locations <query>               Resolve city name to IATA codes
-  star --github <username>        Link GitHub \u2014 star repo for free access
-  unlock <offer_id>               Unlock offer (FREE with GitHub star)
-  book <offer_id> --passenger ... Book flight (FREE after unlock)
-  register --name ... --email ... Register new agent
-  setup-payment                   Legacy payment setup
+  unlock <offer_id>               Unlock offer \u2014 1% of ticket (min $3)
+  book <offer_id> --passenger ... Book flight \u2014 charges ticket price via Stripe
+  register --name ... --email ... Register for a Developer API key
+  setup-payment                   Attach Stripe payment method
   me                              Show agent profile
 
 Options:
@@ -784,7 +776,6 @@ Options:
 
 Examples:
   letsfg register --name my-agent --email me@example.com
-  letsfg star --github octocat
   letsfg search GDN BER 2026-03-03 --sort price
   letsfg unlock off_xxx
   letsfg book off_xxx -p '{"id":"pas_xxx",...}' -e john@ex.com
@@ -809,9 +800,6 @@ async function main() {
       case "register":
         await cmdRegister(args);
         break;
-      case "star":
-        await cmdStar(args);
-        break;
       case "setup-payment":
         await cmdSetupPayment(args);
         break;