@reporting-bi/cli 0.1.13 → 0.1.15

package/dist/index.js

@@ -2533,11 +2533,11 @@ var require_lib = __commonJS({
   "../../.yarn/cache/qs-npm-6.15.0-2165244317-ff341078a7.zip/node_modules/qs/lib/index.js"(exports2, module2) {
     "use strict";
     var stringify = require_stringify();
-    var parse3 = require_parse();
+    var parse6 = require_parse();
     var formats = require_formats();
     module2.exports = {
       formats,
-      parse: parse3,
+      parse: parse6,
       stringify
     };
   }
@@ -6089,24 +6089,24 @@ var require_fast_uri = __commonJS({
     function normalize(uri, options) {
       if (typeof uri === "string") {
         uri = /** @type {T} */
-        serialize(parse3(uri, options), options);
+        serialize(parse6(uri, options), options);
       } else if (typeof uri === "object") {
         uri = /** @type {T} */
-        parse3(serialize(uri, options), options);
+        parse6(serialize(uri, options), options);
       }
       return uri;
     }
     function resolve8(baseURI, relativeURI, options) {
       const schemelessOptions = options ? Object.assign({ scheme: "null" }, options) : { scheme: "null" };
-      const resolved = resolveComponent(parse3(baseURI, schemelessOptions), parse3(relativeURI, schemelessOptions), schemelessOptions, true);
+      const resolved = resolveComponent(parse6(baseURI, schemelessOptions), parse6(relativeURI, schemelessOptions), schemelessOptions, true);
       schemelessOptions.skipEscape = true;
       return serialize(resolved, schemelessOptions);
     }
     function resolveComponent(base, relative6, options, skipNormalization) {
       const target = {};
       if (!skipNormalization) {
-        base = parse3(serialize(base, options), options);
-        relative6 = parse3(serialize(relative6, options), options);
+        base = parse6(serialize(base, options), options);
+        relative6 = parse6(serialize(relative6, options), options);
       }
       options = options || {};
       if (!options.tolerant && relative6.scheme) {
@@ -6158,13 +6158,13 @@ var require_fast_uri = __commonJS({
     function equal(uriA, uriB, options) {
       if (typeof uriA === "string") {
         uriA = unescape(uriA);
-        uriA = serialize(normalizeComponentEncoding(parse3(uriA, options), true), { ...options, skipEscape: true });
+        uriA = serialize(normalizeComponentEncoding(parse6(uriA, options), true), { ...options, skipEscape: true });
       } else if (typeof uriA === "object") {
         uriA = serialize(normalizeComponentEncoding(uriA, true), { ...options, skipEscape: true });
       }
       if (typeof uriB === "string") {
         uriB = unescape(uriB);
-        uriB = serialize(normalizeComponentEncoding(parse3(uriB, options), true), { ...options, skipEscape: true });
+        uriB = serialize(normalizeComponentEncoding(parse6(uriB, options), true), { ...options, skipEscape: true });
       } else if (typeof uriB === "object") {
         uriB = serialize(normalizeComponentEncoding(uriB, true), { ...options, skipEscape: true });
       }
@@ -6233,7 +6233,7 @@ var require_fast_uri = __commonJS({
       return uriTokens.join("");
     }
     var URI_PARSE = /^(?:([^#/:?]+):)?(?:\/\/((?:([^#/?@]*)@)?(\[[^#/?\]]+\]|[^#/:?]*)(?::(\d*))?))?([^#?]*)(?:\?([^#]*))?(?:#((?:.|[\n\r])*))?/u;
-    function parse3(uri, opts) {
+    function parse6(uri, opts) {
       const options = Object.assign({}, opts);
       const parsed = {
         scheme: void 0,
@@ -6327,7 +6327,7 @@ var require_fast_uri = __commonJS({
       resolveComponent,
       equal,
       serialize,
-      parse: parse3
+      parse: parse6
     };
     module2.exports = fastUri;
     module2.exports.default = fastUri;
@@ -9315,6 +9315,7 @@ var require_dist = __commonJS({
 // src/commands/login.ts
 var http = __toESM(require("node:http"));
 var import_node_child_process2 = require("node:child_process");
+var readline = __toESM(require("node:readline"));
 
 // src/config.ts
 var fs2 = __toESM(require("node:fs"));
@@ -9536,13 +9537,23 @@ var ReportingAuthClient = class {
     }
     return tokenInfo;
   }
+  /**
+   * Revokes the session. A SAML2 session answers with `logout_url` - the caller navigates there so
+   * the identity provider session ends too; every other session answers with an empty body.
+   */
   async logout() {
-    await this.fetchWithAuth(`${this.options.serviceUrl}/revoke`, {
+    const response = await this.fetchWithAuth(`${this.options.serviceUrl}/revoke`, {
       method: "GET",
       headers: {
         "Content-Type": "application/json"
       }
     });
+    const text2 = response.ok ? await response.text() : "";
+    try {
+      return text2 ? JSON.parse(text2) : {};
+    } catch {
+      return {};
+    }
   }
   redirectToLogin() {
     if (typeof window === "undefined") throw new Error("Not in browser environment");
@@ -9757,13 +9768,13 @@ var Service = class extends EventTarget {
       throw new ServiceException({ data: error48, url: response.url });
     }
   }
-  async handleResponse(response, parse3) {
+  async handleResponse(response, parse6) {
     if (!response.ok) {
       await this.handleError(response);
       return null;
     }
     const contentType = response.headers.get("Content-Type");
-    if (contentType?.includes("application/json") && parse3 !== false) {
+    if (contentType?.includes("application/json") && parse6 !== false) {
       return await response.json();
     } else {
       return await response.text();
@@ -9921,6 +9932,12 @@ var CLIENT_SECRET = "48481427819bb41798bd74fa109c90b184ca4d64d20e60dfbe8430299f0
 var EXIT_LOGIN_REQUIRED = 2;
 var LOGIN_REQUIRED_MARKER = "rpbi: login_required";
 var SPID_MARKER = "rpbi: spid";
+function readSqlInput(flags) {
+  if (flags.stdin) return fs2.readFileSync(0, "utf-8");
+  if (flags.file) return fs2.readFileSync(flags.file, "utf-8");
+  if (flags.sql) return flags.sql;
+  return void 0;
+}
 var LoginRequiredError = class extends Error {
   constructor(domain2, detail) {
     super(`Session expired. Run "rpbi login ${domain2}" again.`);
@@ -10270,6 +10287,21 @@ function output(data, flags) {
     console.log(data);
   }
 }
+function outputParseResult(result, flags) {
+  const errors = result?.errors ?? [];
+  if (flags.json) {
+    output({ errors }, flags);
+    return;
+  }
+  if (errors.length === 0) {
+    console.log("No syntax errors.");
+    return;
+  }
+  for (const error48 of errors) {
+    console.log(error48.line ? `Line ${error48.line}: ${error48.error}` : `${error48.error}`);
+  }
+  process.exitCode = 1;
+}
 function errorMessage(err) {
   const data = err?.data;
   return data?.message || data?.error || (err instanceof Error ? err.message : String(err));
@@ -10366,17 +10398,37 @@ var callback_default = `<!DOCTYPE html>
 function renderCallback(status6, title, message) {
   return callback_default.replace("{{status}}", status6).replace("{{title}}", title).replace("{{message}}", message);
 }
-function openBrowser(url2) {
+function canOpenBrowser() {
+  const env = process.env;
+  if (process.platform === "linux" || process.platform === "freebsd" || process.platform === "openbsd") {
+    return !!(env.DISPLAY || env.WAYLAND_DISPLAY);
+  }
+  return !(env.SSH_CONNECTION || env.SSH_TTY);
+}
+function openBrowser(url2, onError) {
   const platform = process.platform;
   const cmd = platform === "darwin" ? "open" : platform === "win32" ? 'start ""' : "xdg-open";
-  (0, import_node_child_process2.exec)(`${cmd} ${JSON.stringify(url2)}`);
+  (0, import_node_child_process2.exec)(`${cmd} ${JSON.stringify(url2)}`, (err) => {
+    if (err) onError();
+  });
+}
+function parsePastedCode(input) {
+  const text2 = input.trim();
+  if (!text2) return {};
+  if (/[?&](code|error)=/.test(text2)) {
+    const params3 = new URL(text2, "http://localhost").searchParams;
+    return { code: params3.get("code") || void 0, error: params3.get("error") || void 0 };
+  }
+  return { code: text2 };
 }
 async function login(args) {
   const { positional, flags } = parseArgs(args);
   const domain2 = positional[0] || "https://reporting.bi";
   const accounting2 = flags.accounting ? parseInt(flags.accounting) : void 0;
+  const port = flags.port ? parseInt(flags.port) : 0;
+  const browser = flags["no-browser"] !== "true" && canOpenBrowser();
   console.log(`Logging in to ${domain2}...`);
-  const code = await getAuthorizationCode(domain2);
+  const code = await getAuthorizationCode(domain2, port, browser);
   if (!code) {
     console.error("Login cancelled or timed out.");
     process.exit(1);
@@ -10409,12 +10461,17 @@ async function login(args) {
     console.log('No accounting set. Use "rpbi use <domain> --accounting <id>" to set one.');
   }
 }
-function getAuthorizationCode(domain2) {
+function getAuthorizationCode(domain2, port, browser) {
   return new Promise((resolve8) => {
     let timeout;
+    let rl;
+    let finished = false;
     const done = (result) => {
+      if (finished) return;
+      finished = true;
       clearTimeout(timeout);
       server.close();
+      rl?.close();
       resolve8(result);
     };
     const server = http.createServer((req, res) => {
@@ -10432,17 +10489,57 @@ function getAuthorizationCode(domain2) {
         res.end("Waiting for authentication...");
       }
     });
-    server.listen(0, "localhost", () => {
+    server.on("error", (err) => {
+      console.error(`Cannot listen for the login callback: ${err.message}`);
+      done(null);
+    });
+    server.listen(port, "localhost", () => {
       const address = server.address();
       if (!address || typeof address === "string") {
         done(null);
         return;
       }
-      const port = address.port;
-      const redirectUri = `http://localhost:${port}`;
+      const redirectUri = `http://localhost:${address.port}`;
       const authUrl = `${domain2}/auth?client_id=${CLIENT_ID}&redirect_uri=${encodeURIComponent(redirectUri)}`;
-      console.log(`Opening browser for authentication...`);
-      openBrowser(authUrl);
+      const printManual = () => {
+        console.log("Open this URL in a browser and sign in:");
+        console.log("");
+        console.log(`  ${authUrl}`);
+        console.log("");
+        if (process.stdin.isTTY) {
+          console.log(`The browser then goes to ${redirectUri}/?code=... - if that page does not load`);
+          console.log("(the browser runs on another machine), copy its whole address from the address bar");
+          console.log("and paste it here.");
+        }
+      };
+      if (browser) {
+        console.log("Opening browser for authentication...");
+        console.log(`If it does not open, visit: ${authUrl}`);
+        openBrowser(authUrl, () => {
+          console.log("Could not open a browser.");
+          printManual();
+        });
+      } else {
+        printManual();
+      }
+      if (process.stdin.isTTY) {
+        rl = readline.createInterface({ input: process.stdin, output: process.stdout, terminal: false });
+        rl.on("line", (line) => {
+          let pasted;
+          try {
+            pasted = parsePastedCode(line);
+          } catch {
+            console.error("Not a valid address, paste the whole URL from the address bar.");
+            return;
+          }
+          if (pasted.error) {
+            console.error(`Login failed: ${pasted.error}`);
+            done(null);
+          } else if (pasted.code) {
+            done(pasted.code);
+          }
+        });
+      }
     });
     timeout = setTimeout(() => done(null), 5 * 60 * 1e3);
   });
@@ -11829,12 +11926,7 @@ async function content(id, flags) {
 }
 async function exec2(id, flags) {
   const service = await createService("etl", { cwd: flags.dir || "." });
-  let body = void 0;
-  if (flags.file) {
-    body = fs8.readFileSync(flags.file, "utf-8");
-  } else if (flags.sql) {
-    body = flags.sql;
-  }
+  const body = readSqlInput(flags);
   if (flags.output) {
     const response = await service.postRaw(`exec/${id}`, body, {
       csv_delimiter: "	",
@@ -11860,6 +11952,12 @@ async function exec2(id, flags) {
     process.stdout.write(result || "");
   }
 }
+async function parse(id, flags) {
+  const service = await createService("etl", { cwd: flags.dir || "." });
+  const body = readSqlInput(flags) ?? await service.get(`threads/${id}/content`, void 0, { parseResponse: false }) ?? "";
+  const result = await service.post(`parse/${id}`, body).catch((err) => fail(err, "Parse failed"));
+  outputParseResult(result, flags);
+}
 async function abort2(spid, flags) {
   const service = await createService("etl", { cwd: flags.dir || "." });
   const result = await service.get(`abort/${spid}`);
@@ -11914,10 +12012,16 @@ async function etl(args) {
       return content(rest[0], flags);
     case "exec":
       if (!rest[0]) {
-        console.error('Usage: rpbi etl exec <id> [--file path] [--sql "..."]');
+        console.error('Usage: rpbi etl exec <id> [--file path] [--sql "..."] [--stdin]');
         process.exit(1);
       }
       return exec2(rest[0], flags);
+    case "parse":
+      if (!rest[0]) {
+        console.error('Usage: rpbi etl parse <id> [--file path] [--sql "..."] [--stdin]');
+        process.exit(1);
+      }
+      return parse(rest[0], flags);
     case "abort":
       if (!rest[0]) {
         console.error("Usage: rpbi etl abort <spid>");
@@ -11947,7 +12051,7 @@ async function etl(args) {
     case "watch":
       return watch4(flags);
     default:
-      console.log("Usage: rpbi etl <list|get|content|exec|abort|search|params|pull|push|context|status|watch> [options]");
+      console.log("Usage: rpbi etl <list|get|content|exec|parse|abort|search|params|pull|push|context|status|watch> [options]");
       break;
   }
 }
@@ -12329,12 +12433,7 @@ async function doc(id, flags) {
 }
 async function exec3(id, flags) {
   const service = await createService("deployment", { cwd: flags.dir || "." });
-  let body = void 0;
-  if (flags.file) {
-    body = fs10.readFileSync(flags.file, "utf-8");
-  } else if (flags.sql) {
-    body = flags.sql;
-  }
+  const body = readSqlInput(flags);
   const params3 = {};
   if (flags.database) params3.database = flags.database;
   if (flags.output) {
@@ -12357,6 +12456,20 @@ async function exec3(id, flags) {
     process.stdout.write(result || "");
   }
 }
+async function parse2(id, flags) {
+  let body = readSqlInput(flags);
+  if (body === void 0) {
+    if (!id) {
+      console.error('Usage: rpbi deployment parse [<id>] [--file path] [--sql "..."] [--stdin]');
+      process.exit(1);
+    }
+    const deploymentService = await createService("deployment", { cwd: flags.dir || "." });
+    body = await deploymentService.get(`threads/${id}/content`, void 0, { parseResponse: false }) ?? "";
+  }
+  const service = await createService("server", { cwd: flags.dir || "." });
+  const result = await service.post("parse", body).catch((err) => fail(err, "Parse failed"));
+  outputParseResult(result, flags);
+}
 async function deployment(args) {
   const { positional, flags } = parseArgs(args);
   const [subcommand, ...rest] = positional;
@@ -12383,10 +12496,12 @@ async function deployment(args) {
       return doc(rest[0], flags);
     case "exec":
       if (!rest[0]) {
-        console.error('Usage: rpbi deployment exec <id> [--file path] [--sql "..."] [--database all]');
+        console.error('Usage: rpbi deployment exec <id> [--file path] [--sql "..."] [--stdin] [--database all]');
         process.exit(1);
       }
       return exec3(rest[0], flags);
+    case "parse":
+      return parse2(rest[0], flags);
     case "pull":
       return pull3(flags);
     case "push":
@@ -12396,7 +12511,7 @@ async function deployment(args) {
     case "watch":
       return watch5(flags);
     default:
-      console.log("Usage: rpbi deployment <list|get|content|doc|exec|pull|push|status|watch> [options]");
+      console.log("Usage: rpbi deployment <list|get|content|doc|exec|parse|pull|push|status|watch> [options]");
       break;
   }
 }
@@ -12921,12 +13036,7 @@ async function deps(flags) {
 }
 async function exec4(id, flags) {
   const service = await createService("extensions", { cwd: flags.dir || "." });
-  let body = void 0;
-  if (flags.file) {
-    body = fs12.readFileSync(flags.file, "utf-8");
-  } else if (flags.sql) {
-    body = flags.sql;
-  }
+  const body = readSqlInput(flags);
   if (flags.output) {
     const response = await service.postRaw(`exec/${id}`, body, {
       csv_delimiter: "	",
@@ -12952,6 +13062,12 @@ async function exec4(id, flags) {
     process.stdout.write(result || "");
   }
 }
+async function parse3(id, flags) {
+  const service = await createService("extensions", { cwd: flags.dir || "." });
+  const body = readSqlInput(flags) ?? await service.get(`queryContent/${id}`, void 0, { parseResponse: false }) ?? "";
+  const result = await service.post(`parse/${id}`, body).catch((err) => fail(err, "Parse failed"));
+  outputParseResult(result, flags);
+}
 async function abort3(spid, flags) {
   const service = await createService("extensions", { cwd: flags.dir || "." });
   const result = await service.get(`abort/${spid}`);
@@ -12975,10 +13091,16 @@ async function ext(args) {
       return content3(rest[0], flags);
     case "exec":
       if (!rest[0]) {
-        console.error('Usage: rpbi ext exec <query_id> [--file path] [--sql "..."]');
+        console.error('Usage: rpbi ext exec <query_id> [--file path] [--sql "..."] [--stdin]');
         process.exit(1);
       }
       return exec4(rest[0], flags);
+    case "parse":
+      if (!rest[0]) {
+        console.error('Usage: rpbi ext parse <query_id> [--file path] [--sql "..."] [--stdin]');
+        process.exit(1);
+      }
+      return parse3(rest[0], flags);
     case "abort":
       if (!rest[0]) {
         console.error("Usage: rpbi ext abort <spid>");
@@ -13002,7 +13124,7 @@ async function ext(args) {
     case "watch":
       return watch6(flags);
     default:
-      console.log("Usage: rpbi ext <projects|resources|queries|content|exec|abort|params|deps|pull|push|status|watch> [options]");
+      console.log("Usage: rpbi ext <projects|resources|queries|content|exec|parse|abort|params|deps|pull|push|status|watch> [options]");
       break;
   }
 }
@@ -17483,7 +17605,7 @@ __export(core_exports2, {
   isValidJWT: () => isValidJWT2,
   locales: () => locales_exports,
   meta: () => meta,
-  parse: () => parse,
+  parse: () => parse4,
   parseAsync: () => parseAsync,
   prettifyError: () => prettifyError,
   process: () => process2,
@@ -18406,7 +18528,7 @@ var _parse = (_Err) => (schema, value, _ctx, _params) => {
   }
   return result.value;
 };
-var parse = /* @__PURE__ */ _parse($ZodRealError);
+var parse4 = /* @__PURE__ */ _parse($ZodRealError);
 var _parseAsync = (_Err) => async (schema, value, _ctx, params3) => {
   const ctx = _ctx ? Object.assign(_ctx, { async: true }) : { async: true };
   let result = schema._zod.run({ value, issues: [] }, ctx);
@@ -21079,10 +21201,10 @@ var $ZodFunction = /* @__PURE__ */ $constructor("$ZodFunction", (inst, def2) =>
       throw new Error("implement() must be called with a function");
     }
     return function(...args) {
-      const parsedArgs = inst._def.input ? parse(inst._def.input, args) : args;
+      const parsedArgs = inst._def.input ? parse4(inst._def.input, args) : args;
       const result = Reflect.apply(func, this, parsedArgs);
       if (inst._def.output) {
-        return parse(inst._def.output, result);
+        return parse4(inst._def.output, result);
       }
       return result;
     };
@@ -28853,7 +28975,7 @@ var ZodMiniType = /* @__PURE__ */ $constructor("ZodMiniType", (inst, def2) => {
   $ZodType.init(inst, def2);
   inst.def = def2;
   inst.type = def2.type;
-  inst.parse = (data, params3) => parse(inst, data, params3, { callee: inst.parse });
+  inst.parse = (data, params3) => parse4(inst, data, params3, { callee: inst.parse });
   inst.safeParse = (data, params3) => safeParse(inst, data, params3);
   inst.parseAsync = async (data, params3) => parseAsync(inst, data, params3, { callee: inst.parseAsync });
   inst.safeParseAsync = async (data, params3) => safeParseAsync(inst, data, params3);
@@ -29215,7 +29337,7 @@ __export(external_exports3, {
   object: () => object2,
   optional: () => optional,
   overwrite: () => _overwrite,
-  parse: () => parse2,
+  parse: () => parse5,
   parseAsync: () => parseAsync2,
   partialRecord: () => partialRecord,
   pipe: () => pipe,
@@ -29560,7 +29682,7 @@ var ZodRealError = $constructor("ZodError", initializer2, {
 });
 
 // ../../.yarn/cache/zod-npm-4.3.6-a096e305e6-860d25a81a.zip/node_modules/zod/v4/classic/parse.js
-var parse2 = /* @__PURE__ */ _parse(ZodRealError);
+var parse5 = /* @__PURE__ */ _parse(ZodRealError);
 var parseAsync2 = /* @__PURE__ */ _parseAsync(ZodRealError);
 var safeParse3 = /* @__PURE__ */ _safeParse(ZodRealError);
 var safeParseAsync3 = /* @__PURE__ */ _safeParseAsync(ZodRealError);
@@ -29603,7 +29725,7 @@ var ZodType2 = /* @__PURE__ */ $constructor("ZodType", (inst, def2) => {
     reg.add(inst, meta3);
     return inst;
   };
-  inst.parse = (data, params3) => parse2(inst, data, params3, { callee: inst.parse });
+  inst.parse = (data, params3) => parse5(inst, data, params3, { callee: inst.parse });
   inst.safeParse = (data, params3) => safeParse3(inst, data, params3);
   inst.parseAsync = async (data, params3) => parseAsync2(inst, data, params3, { callee: inst.parseAsync });
   inst.safeParseAsync = async (data, params3) => safeParseAsync3(inst, data, params3);
@@ -36532,7 +36654,7 @@ async function mcp() {
   setMcpMode();
   const server = new McpServer({
     name: "reporting-bi",
-    version: "0.1.13"
+    version: "0.1.15"
   });
   server.tool(
     "status",
@@ -36868,10 +36990,18 @@ async function mcp() {
   server.tool(
     "wiki_search",
     "Search wiki pages",
-    { query: external_exports3.string().describe("Search query"), ...ListParams },
+    {
+      query: external_exports3.string().describe("Search query"),
+      semantic: external_exports3.boolean().optional().describe("Also return pages semantically close to the query (needs a vector model configured on the server; results then carry a similarity score)"),
+      ...ListParams
+    },
     async (params3) => {
       const service = await createService("wiki");
-      const result = await service.get("search", { ...toRequestParams(params3), q: params3.query });
+      const result = await service.get("search", {
+        ...toRequestParams(params3),
+        q: params3.query,
+        ...params3.semantic ? { mode: "semantic" } : {}
+      });
       return json2(result || []);
     }
   );
@@ -37065,8 +37195,8 @@ async function checkForUpdate() {
     saveUpdateCheck({ lastCheck: now });
     const latest = await fetchLatestVersion();
     if (!latest) return;
-    if (!isNewer(latest, "0.1.13")) return;
-    console.error(`\x1B[33mUpdating ${PACKAGE_NAME} ${"0.1.13"} \u2192 ${latest}...\x1B[0m`);
+    if (!isNewer(latest, "0.1.15")) return;
+    console.error(`\x1B[33mUpdating ${PACKAGE_NAME} ${"0.1.15"} \u2192 ${latest}...\x1B[0m`);
     (0, import_node_child_process3.execSync)(npmInstallCmd(latest), { stdio: ["ignore", 2, 2] });
     console.error(`\x1B[32mUpdated to ${latest}.\x1B[0m`);
   } catch {
@@ -37078,11 +37208,11 @@ async function forceUpdate() {
     console.error("Could not fetch latest version from npm.");
     process.exit(1);
   }
-  if (!isNewer(latest, "0.1.13")) {
-    console.log(`Already up to date (${"0.1.13"}).`);
+  if (!isNewer(latest, "0.1.15")) {
+    console.log(`Already up to date (${"0.1.15"}).`);
     return;
   }
-  console.log(`Updating ${PACKAGE_NAME} ${"0.1.13"} \u2192 ${latest}...`);
+  console.log(`Updating ${PACKAGE_NAME} ${"0.1.15"} \u2192 ${latest}...`);
   (0, import_node_child_process3.execSync)(npmInstallCmd(latest), { stdio: "inherit" });
   console.log(`\x1B[32mUpdated to ${latest}.\x1B[0m`);
   saveUpdateCheck({ lastCheck: Date.now() });
@@ -37103,7 +37233,10 @@ pull removes local files deleted on the server (a locally modified file is kept)
 deletes on the server what was deleted locally \u2014 single files or whole folders.
 
 Commands:
-  login [domain] [--accounting <id>]    Login to a Reporting.bi instance (opens browser)
+  login [domain] [--accounting <id>] [--no-browser] [--port <n>]
+                                        Login to a Reporting.bi instance (opens browser; without a
+                                        display prints the URL - paste back the address the browser
+                                        ends at, or forward --port over SSH)
   logout [domain]                       Logout and revoke tokens (default: active connection)
   use <domain> [--accounting <id>]      Switch active connection and/or set accounting
   status [--json]                       Show all connections, token and session expiry
@@ -37118,7 +37251,8 @@ ETL:
   etl list                              List all threads
   etl get <id>                          Get thread metadata
   etl content <id>                      Get thread SQL content (plain text)
-  etl exec <id> [--sql "..."|--file f]  Execute thread (optionally with custom SQL)
+  etl exec <id> [--sql "..."|--file f|--stdin]  Execute thread (optionally with custom SQL)
+  etl parse <id> [--sql "..."|--file f|--stdin]  Syntax check (set parseonly) of the thread or the given SQL; exit 1 on errors (--json: {errors}, exit 0)
   etl abort <spid>                      Abort a running exec (exec reports "rpbi: spid <n>" on stderr)
   etl search <query>                    Search threads
   etl params <id> [--save <json>|--delete <idz>]  List, save or delete thread parameters (save creates, or updates when the JSON carries "idz"; a name already declared alongside is refused)
@@ -37133,7 +37267,8 @@ Deployment (requires the "deployment" right):
   deployment get <id>                   Get thread metadata
   deployment content <id>               Get thread SQL content (plain text)
   deployment doc <id>                   Get thread documentation (markdown)
-  deployment exec <id> [--sql "..."|--file f] [--database all]  Execute thread (optionally with custom SQL)
+  deployment exec <id> [--sql "..."|--file f|--stdin] [--database all]  Execute thread (optionally with custom SQL)
+  deployment parse [<id>] [--sql "..."|--file f|--stdin]  Syntax check (set parseonly, no placeholder replacement) of the thread or the given SQL
   deployment pull [--dir <path>]        Pull all deployment threads (.sql) & docs (.md) to local files
   deployment push [files...] [--dir <path>] [--force]  Push modified/new files back to server
   deployment status [--dir <path>] [--remote] [--json]  Show local changes (--remote compares with server)
@@ -37144,7 +37279,8 @@ Extensions (requires the "custom.define" right):
   ext resources                         List resources
   ext queries                           List queries
   ext content <id> [--query]            Get resource content (--query for query SQL)
-  ext exec <query_id> [--sql "..."|--file f]  Execute query (optionally with custom SQL)
+  ext exec <query_id> [--sql "..."|--file f|--stdin]  Execute query (optionally with custom SQL)
+  ext parse <query_id> [--sql "..."|--file f|--stdin]  Syntax check (set parseonly) of the query or the given SQL; exit 1 on errors (--json: {errors}, exit 0)
   ext abort <spid>                      Abort a running exec (exec reports "rpbi: spid <n>" on stderr)
   ext params <query_id> [--save <json>|--delete <idz>]  List, save or delete query parameters (save creates, or updates when the JSON carries "idz"; a name already declared alongside is refused)
   ext deps --project <id>|--query <id>|--resource <id>  List SQL dependencies (resource \u2194 query links)
@@ -37270,7 +37406,7 @@ Examples:
 (async () => {
   const [command, ...args] = process.argv.slice(2);
   if (command === "--version" || command === "-v") {
-    console.log("0.1.13");
+    console.log("0.1.15");
     return;
   }
   await checkForUpdate();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@reporting-bi/cli",
-  "version": "0.1.13",
+  "version": "0.1.15",
   "license": "UNLICENSED",
   "description": "Reporting.bi CLI — command-line interface for the Reporting.bi platform",
   "main": "./dist/index.js",