@go-labs-sg/bb 2.48.0 → 3.0.0

package/dist/index.js

@@ -35,31 +35,31 @@ var __toESM = (mod, isNodeMode, target) => {
 var __commonJS = (cb, mod) => () => (mod || cb((mod = { exports: {} }).exports, mod), mod.exports);
 var __require = import.meta.require;
 
-// ../../../node_modules/.bun/dotenv@18.0.6/node_modules/dotenv/dist/index.cjs
+// ../../../node_modules/.bun/dotenv@18.0.7/node_modules/dotenv/dist/index.cjs
 var require_dist = __commonJS(function(exports, module) {
-  var S = (e, o) => () => {
+  var k = (e, n) => () => {
     try {
-      return o || e((o = { exports: {} }).exports, o), o.exports;
+      return n || e((n = { exports: {} }).exports, n), n.exports;
     } catch (t) {
-      throw o = 0, t;
+      throw n = 0, t;
     }
   };
-  var j = S((xe, U) => {
+  var I = k((xe, U) => {
     function G(e) {
       return typeof e == "string" ? !["false", "0", "no", "off", ""].includes(e.toLowerCase()) : !!e;
     }
-    function X(e = process.env) {
-      let o = {};
+    function Y(e = process.env) {
+      let n = {};
       for (let t of ["ENCODING", "PATH", "QUIET", "DEBUG", "OVERRIDE", "FAST"]) {
-        let n = e[`DOTENV_${t}`] != null ? e[`DOTENV_${t}`] : e[`DOTENV_CONFIG_${t}`];
-        n != null && (o[t.toLowerCase()] = t === "ENCODING" || t === "PATH" ? n : G(n));
+        let o = e[`DOTENV_${t}`] != null ? e[`DOTENV_${t}`] : e[`DOTENV_CONFIG_${t}`];
+        o != null && (n[t.toLowerCase()] = t === "ENCODING" || t === "PATH" ? o : G(o));
       }
-      return o;
+      return n;
     }
-    U.exports = { parseBoolean: G, optionsFromEnv: X };
+    U.exports = { parseBoolean: G, optionsFromEnv: Y };
   });
-  var N = S((ye, x) => {
-    var Y = __require("fs"), k = __require("path"), z = __require("os"), { URL: Z, fileURLToPath: ee } = __require("url"), { parseBoolean: $, optionsFromEnv: B } = j(), te = /(?:^|^)\s*(?:export\s+)?([\w.-]+)(?:\s*=\s*?|:\s+?)(\s*'(?:\\'|[^'])*'|\s*"(?:\\"|[^"])*"|\s*`(?:\\`|[^`])*`|[^#\r\n]+)?\s*(?:#.*)?(?:$|$)/mg, b = new Uint8Array(256);
+  var N = k((ye, x) => {
+    var z = __require("fs"), S = __require("path"), Z = __require("os"), { URL: ee, fileURLToPath: te } = __require("url"), { parseBoolean: $, optionsFromEnv: B } = I(), re = /(?:^|^)\s*(?:export\s+)?([\w.-]+)(?:\s*=\s*?|:\s+?)(\s*'(?:\\'|[^'])*'|\s*"(?:\\"|[^"])*"|\s*`(?:\\`|[^`])*`|[^#\r\n]+)?\s*(?:#.*)?(?:$|$)/mg, b = new Uint8Array(256);
     for (let e = 48;e <= 57; e++)
       b[e] = 1;
     for (let e = 65;e <= 90; e++)
@@ -69,92 +69,92 @@ var require_dist = __commonJS(function(exports, module) {
     b[45] = 1;
     b[46] = 1;
     b[95] = 1;
-    function re(e) {
-      let o = {}, t = e.toString();
+    function ne(e) {
+      let n = {}, t = e.toString();
       t = t.replace(/\r\n?/mg, `
 `);
-      let n;
-      for (;(n = te.exec(t)) != null; ) {
-        let r = n[1], s = n[2] || "";
+      let o;
+      for (;(o = re.exec(t)) != null; ) {
+        let r = o[1], s = o[2] || "";
         s = s.trim();
         let i = s[0];
         s = s.replace(/^(['"`])([\s\S]*)\1$/mg, "$2"), i === '"' && (s = s.replace(/\\n/g, `
-`), s = s.replace(/\\r/g, "\r")), o[r] = s;
+`), s = s.replace(/\\r/g, "\r")), n[r] = s;
       }
-      return o;
+      return n;
     }
     function w(e) {
       return e <= 32 ? e === 32 || e >= 9 && e <= 13 : e >= 160 && (e === 160 || e === 5760 || e >= 8192 && e <= 8202 || e === 8232 || e === 8233 || e === 8239 || e === 8287 || e === 12288 || e === 65279);
     }
-    function O(e) {
+    function q(e) {
       return e === 10 || e === 8232 || e === 8233;
     }
     function oe(e) {
-      let o = {}, t = typeof e == "string" ? e : e.toString();
+      let n = {}, t = typeof e == "string" ? e : e.toString();
       t.indexOf("\r") !== -1 && (t = t.replace(/\r\n?/g, `
 `));
-      let n = t.length, r = 0;
-      for (;r < n; ) {
+      let o = t.length, r = 0;
+      for (;r < o; ) {
         let s = t.charCodeAt(r);
-        for (;r < n && w(s); )
+        for (;r < o && w(s); )
           r++, s = t.charCodeAt(r);
-        if (r >= n)
+        if (r >= o)
           break;
         if (s === 35) {
-          for (;r < n && !O(t.charCodeAt(r)); )
+          for (;r < o && !q(t.charCodeAt(r)); )
             r++;
           continue;
         }
         let i = -1;
-        if (s === 101 && r + 6 < n && t.charCodeAt(r + 1) === 120 && t.charCodeAt(r + 2) === 112 && t.charCodeAt(r + 3) === 111 && t.charCodeAt(r + 4) === 114 && t.charCodeAt(r + 5) === 116) {
+        if (s === 101 && r + 6 < o && t.charCodeAt(r + 1) === 120 && t.charCodeAt(r + 2) === 112 && t.charCodeAt(r + 3) === 111 && t.charCodeAt(r + 4) === 114 && t.charCodeAt(r + 5) === 116) {
           let v = t.charCodeAt(r + 6);
           if (w(v)) {
             let u = r + 7;
-            for (;u < n && w(t.charCodeAt(u)); )
+            for (;u < o && w(t.charCodeAt(u)); )
               u++;
             b[t.charCodeAt(u)] && (i = r + 6, r = u);
           } else
             s = t.charCodeAt(r);
         }
         let l = r, d = 0;
-        for (;r < n && (d = t.charCodeAt(r), b[d]); )
+        for (;r < o && (d = t.charCodeAt(r), b[d]); )
           r++;
         if (r === l) {
-          for (;r < n && !O(t.charCodeAt(r)); )
+          for (;r < o && !q(t.charCodeAt(r)); )
             r++;
           continue;
         }
         let p = t.slice(l, r), f = r;
-        if (r >= n && (d = 0), w(d))
+        if (r >= o && (d = 0), w(d))
           do
-            r++, d = r < n ? t.charCodeAt(r) : 0;
+            r++, d = r < o ? t.charCodeAt(r) : 0;
           while (w(d));
         if (d === 61)
           r++;
-        else if (d === 58 && r === f && r + 1 < n && w(t.charCodeAt(r + 1)))
+        else if (d === 58 && r === f && r + 1 < o && w(t.charCodeAt(r + 1)))
           r += 2;
         else {
-          for (r = i === -1 ? f : i;r < n && !O(t.charCodeAt(r)); )
+          for (r = i === -1 ? f : i;r < o && !q(t.charCodeAt(r)); )
             r++;
           continue;
         }
         let c = r, a = r;
-        for (;a < n && w(t.charCodeAt(a)); )
+        for (;a < o && w(t.charCodeAt(a)); )
           a++;
-        let g = t.charCodeAt(a), h, y = false;
-        if (g === 39 || g === 34 || g === 96) {
+        let h = t.charCodeAt(a), g, y = false;
+        if (h === 39 || h === 34 || h === 96) {
           let v = t[a], u = t.indexOf(v, a + 1), m = -1, C = -1;
           for (;u !== -1; ) {
-            let q = t.charCodeAt(u - 1) === 92, E = u + 1;
-            for (;E < n && !O(t.charCodeAt(E)) && w(t.charCodeAt(E)); )
+            let O = t.charCodeAt(u - 1) === 92, E = u + 1;
+            for (;E < o && !q(t.charCodeAt(E)) && w(t.charCodeAt(E)); )
               E++;
-            if ((E === n || O(t.charCodeAt(E)) || t.charCodeAt(E) === 35) && (m = u, C = E), !q)
+            if ((E === o || q(t.charCodeAt(E)) || t.charCodeAt(E) === 35) && (m = u, C = E), !O)
               break;
             u = t.indexOf(v, u + 1);
           }
           if (m !== -1) {
-            if (h = t.slice(a + 1, m), r = C, t.charCodeAt(r) === 35)
-              for (;r < n && !O(t.charCodeAt(r)); )
+            if (g = t.slice(a + 1, m), r = C, t.charCodeAt(r) === 35)
+              for (;r < o && !q(t.charCodeAt(r)); )
                 r++;
             y = true;
           }
@@ -162,9 +162,9 @@ var require_dist = __commonJS(function(exports, module) {
         if (!y) {
           let v = t.indexOf(`
 `, c);
-          v === -1 && (v = n);
+          v === -1 && (v = o);
           let u;
-          if (n < 4096)
+          if (o < 4096)
             u = t.indexOf("#", c), (u === -1 || u > v) && (u = v);
           else
             for (u = c;u < v && t.charCodeAt(u) !== 35; )
@@ -174,38 +174,41 @@ var require_dist = __commonJS(function(exports, module) {
             m++;
           for (;C > m && w(t.charCodeAt(C - 1)); )
             C--;
-          let q = t.charCodeAt(m);
-          if (C - m >= 2 && (q === 39 || q === 34 || q === 96) && t.charCodeAt(C - 1) === q ? h = t.slice(m + 1, C - 1) : h = t.slice(m, C), r = u, u < v)
-            for (;r < n && !O(t.charCodeAt(r)); )
+          let O = t.charCodeAt(m);
+          if (C - m >= 2 && (O === 39 || O === 34 || O === 96) && t.charCodeAt(C - 1) === O ? g = t.slice(m + 1, C - 1) : g = t.slice(m, C), r = u, u < v)
+            for (;r < o && !q(t.charCodeAt(r)); )
               r++;
         }
-        g === 34 && (y || a < r) && h.indexOf("\\") !== -1 && (h = h.replace(/\\n/g, `
-`).replace(/\\r/g, "\r")), o[p] = h;
+        h === 34 && (y || a < r) && g.indexOf("\\") !== -1 && (g = g.replace(/\\n/g, `
+`).replace(/\\r/g, "\r")), n[p] = g;
       }
-      return o;
+      return n;
     }
-    function ne(e, o) {
-      return o && $(o.fast) ? oe(e) : re(e);
+    function se(e, n) {
+      return n && $(n.fast) ? oe(e) : ne(e);
     }
     function T(e) {
       console.log(`\u2506 ${e}`);
     }
-    function se(e) {
+    function ie(e) {
       console.error(`\u25C7 ${e}`);
     }
     function V(e) {
-      return e[0] === "~" ? k.join(z.homedir(), e.slice(1)) : e;
+      return e[0] === "~" ? S.join(Z.homedir(), e.slice(1)) : e;
     }
-    function ie(e = {}) {
-      return { ...B(), ...e };
+    function ce(e = {}) {
+      let n = { ...e };
+      for (let t of Object.keys(n))
+        n[t] === undefined && delete n[t];
+      return { ...B(), ...n };
     }
-    function ce(e) {
-      e = ie(e);
-      let o = k.resolve(process.cwd(), ".env"), t = "utf8", n = process.env;
-      e && e.processEnv != null && (n = e.processEnv);
+    function ae(e) {
+      e = ce(e);
+      let n = S.resolve(process.cwd(), ".env"), t = "utf8", o = process.env;
+      e && e.processEnv != null && (o = e.processEnv);
       let r = $(e && e.debug);
       e && e.encoding ? t = e.encoding : r && T("no encoding is specified (UTF-8 is used by default)");
-      let s = [o];
+      let s = [n];
       if (e && e.path)
         if (!Array.isArray(e.path))
           s = [V(e.path)];
@@ -217,106 +220,106 @@ var require_dist = __commonJS(function(exports, module) {
       let i, l = {}, d = { fast: e.fast };
       for (let c of s)
         try {
-          let a = A.parse(Y.readFileSync(c, { encoding: t }), d);
+          let a = A.parse(z.readFileSync(c, { encoding: t }), d);
           A.populate(l, a, e);
         } catch (a) {
           r && T(`failed to load ${c} ${a.message}`), i = a;
         }
-      let p = A.populate(n, l, e), f = $(Object.prototype.hasOwnProperty.call(e, "quiet") ? e.quiet : B(n).quiet);
+      let p = A.populate(o, l, e), f = $(Object.prototype.hasOwnProperty.call(e, "quiet") ? e.quiet : B(o).quiet);
       if (r || !f) {
         let c = Object.keys(p).length, a = [];
-        for (let g of s)
+        for (let h of s)
           try {
-            let h = k.relative(process.cwd(), g instanceof Z ? ee(g) : g);
-            a.push(h);
-          } catch (h) {
-            r && T(`failed to load ${g} ${h.message}`), i = h;
+            let g = S.relative(process.cwd(), h instanceof ee ? te(h) : h);
+            a.push(g);
+          } catch (g) {
+            r && T(`failed to load ${h} ${g.message}`), i = g;
           }
-        se(`injected env (${c}) from ${a.join(",")}`);
+        ie(`injected env (${c}) from ${a.join(",")}`);
       }
       return i ? { parsed: l, error: i } : { parsed: l };
     }
-    function ae(e) {
+    function le(e) {
       return A.configDotenv(e);
     }
-    function le(e, o, t = {}) {
-      let n = $(t && t.debug), r = $(t && t.override), s = {};
-      if (e === null || typeof e != "object" || o === null || typeof o != "object") {
+    function fe(e, n, t = {}) {
+      let o = $(t && t.debug), r = $(t && t.override), s = {};
+      if (e === null || typeof e != "object" || n === null || typeof n != "object") {
         let i = new Error("OBJECT_REQUIRED: Please check the processEnv argument being passed to populate");
         throw i.code = "OBJECT_REQUIRED", i;
       }
-      for (let i of Object.keys(o))
-        Object.prototype.hasOwnProperty.call(e, i) ? (r === true && (e[i] = o[i], s[i] = o[i]), n && T(r === true ? `"${i}" is already defined and WAS overwritten` : `"${i}" is already defined and was NOT overwritten`)) : (e[i] = o[i], s[i] = o[i]);
+      for (let i of Object.keys(n))
+        Object.prototype.hasOwnProperty.call(e, i) ? (r === true && (e[i] = n[i], s[i] = n[i]), o && T(r === true ? `"${i}" is already defined and WAS overwritten` : `"${i}" is already defined and was NOT overwritten`)) : (e[i] = n[i], s[i] = n[i]);
       return s;
     }
-    var A = { configDotenv: ce, config: ae, parse: ne, populate: le };
+    var A = { configDotenv: ae, config: le, parse: se, populate: fe };
     x.exports.configDotenv = A.configDotenv;
     x.exports.config = A.config;
     x.exports.parse = A.parse;
     x.exports.populate = A.populate;
     x.exports = A;
   });
-  var M = S((Te, W) => {
-    var _ = __require("child_process"), fe = __require("fs"), L = __require("path");
-    function ue(e) {
-      let o = ['"'], t = 0;
-      for (let n of e) {
-        if (n === "\\") {
+  var M = k((Te, W) => {
+    var _ = __require("child_process"), ue = __require("fs"), L = __require("path");
+    function de(e) {
+      let n = ['"'], t = 0;
+      for (let o of e) {
+        if (o === "\\") {
           t++;
           continue;
         }
-        n === '"' ? o.push("\\".repeat(t * 2 + 1), '"') : o.push("\\".repeat(t), n), t = 0;
+        o === '"' ? n.push("\\".repeat(t * 2 + 1), '"') : n.push("\\".repeat(t), o), t = 0;
       }
-      return o.push("\\".repeat(t * 2), '"'), o.join("");
+      return n.push("\\".repeat(t * 2), '"'), n.join("");
     }
-    function H(e, o = 1) {
-      for (let t = 0;t < o; t++) {
-        let n = [];
+    function H(e, n = 1) {
+      for (let t = 0;t < n; t++) {
+        let o = [];
         for (let r of e) {
           let s = r.charCodeAt(0), i = s >= 48 && s <= 57 || s >= 65 && s <= 90 || s >= 97 && s <= 122, l = "\\/:._-".includes(r);
-          !i && !l && s < 128 && n.push("^"), n.push(r);
+          !i && !l && s < 128 && o.push("^"), o.push(r);
         }
-        e = n.join("");
+        e = o.join("");
       }
       return e;
     }
-    function P(e, o) {
-      let t = Object.keys(e).reverse().find((n) => n.toUpperCase() === o);
+    function P(e, n) {
+      let t = Object.keys(e).reverse().find((o) => o.toUpperCase() === n);
       return t === undefined ? undefined : e[t];
     }
-    function de(e, o, t) {
-      let n = (P(o, "PATHEXT") || ".COM;.EXE;.BAT;.CMD").split(";").filter(Boolean), s = n.some((l) => e.toLowerCase().endsWith(l.toLowerCase())) ? ["", ...n] : [...n, ""], i = /[\\/]/.test(e) ? [t] : [t, ...(P(o, "PATH") || "").split(";")];
+    function pe(e, n, t) {
+      let o = (P(n, "PATHEXT") || ".COM;.EXE;.BAT;.CMD").split(";").filter(Boolean), s = o.some((l) => e.toLowerCase().endsWith(l.toLowerCase())) ? ["", ...o] : [...o, ""], i = /[\\/]/.test(e) ? [t] : [t, ...(P(n, "PATH") || "").split(";")];
       for (let l of i)
         for (let d of s) {
           let p = L.resolve(t, l.replace(/^"|"$/g, ""), e + d);
           try {
-            if (fe.statSync(p).isFile())
+            if (ue.statSync(p).isFile())
               return p;
           } catch {}
         }
     }
-    function pe(e, o, t) {
+    function he(e, n, t) {
       if (process.platform !== "win32")
-        return _.spawn(e, o, t);
-      let n = t.env || process.env, r = de(e, n, t.cwd || process.cwd());
+        return _.spawn(e, n, t);
+      let o = t.env || process.env, r = pe(e, o, t.cwd || process.cwd());
       if (r && /\.(?:exe|com)$/i.test(r))
-        return _.spawn(r, o, t);
+        return _.spawn(r, n, t);
       let s = /\.(?:bat|cmd)$/i.test(r || e), i = [H(L.normalize(r || e))];
-      for (let d of o)
-        i.push(H(ue(d), s ? 2 : 1));
+      for (let d of n)
+        i.push(H(de(d), s ? 2 : 1));
       let l = i.join(" ");
-      return _.spawn(P(n, "COMSPEC") || "cmd.exe", ["/d", "/v:off", "/s", "/c", `"${l}"`], { ...t, windowsVerbatimArguments: true });
+      return _.spawn(P(o, "COMSPEC") || "cmd.exe", ["/d", "/v:off", "/s", "/c", `"${l}"`], { ...t, windowsVerbatimArguments: true });
     }
-    W.exports = pe;
+    W.exports = he;
   });
-  var K = S(($e, F) => {
-    var he = __require("fs"), ge = __require("os"), Q = __require("path"), me = __require("child_process"), ve = M(), R = N(), { optionsFromEnv: Ce } = j();
+  var X = k(($e, F) => {
+    var ge = __require("fs"), me = __require("os"), Q = __require("path"), ve = __require("child_process"), Ce = M(), R = N(), { optionsFromEnv: J } = I();
     function D() {
       console.log(["Usage: dotenv run [--help] [-q|--quiet] [--debug] [--override] [--fast] [-f|--file <paths>] [--] <command> [args...]", "", "Run a command with environment variables from a .env file.", "Place dotenv options before the command; all following arguments go to the command.", "", "Options:", "  -f, --file <paths>  .env paths, comma-separated or repeated (default: .env)", "  -q, --quiet suppress the injected env message", "  --debug     enable debug logging", "  --override  override existing environment variables", "  --fast      use the faster character-scanner parser", "", "Environment variables (DOTENV_CONFIG_* names remain as fallbacks):", "  DOTENV_PATH, DOTENV_ENCODING, DOTENV_QUIET,", "  DOTENV_DEBUG, DOTENV_OVERRIDE,", "  DOTENV_FAST"].join(`
 `));
     }
     function we(e) {
-      let o = [], t = false, n, r, s, i, l = -1;
+      let n = [], t = false, o, r, s, i, l = -1;
       for (let p = 0;p < e.length; p++) {
         let f = e[p];
         if (f === "--") {
@@ -326,7 +329,7 @@ var require_dist = __commonJS(function(exports, module) {
         if (f === "--help" || f === "-h")
           return { help: true };
         if (f === "--quiet" || f === "-q") {
-          n = true;
+          o = true;
           continue;
         }
         if (f === "--debug") {
@@ -342,13 +345,13 @@ var require_dist = __commonJS(function(exports, module) {
           continue;
         }
         if (f === "-f" || f === "--file" || f.startsWith("-f=") || f.startsWith("--file=")) {
-          let c = f.indexOf("="), a = c === -1 ? f : f.slice(0, c), g = c === -1 ? e[++p] : f.slice(c + 1);
-          if (!g || g === "--")
+          let c = f.indexOf("="), a = c === -1 ? f : f.slice(0, c), h = c === -1 ? e[++p] : f.slice(c + 1);
+          if (!h || h === "--")
             return { error: `${a} requires a path` };
-          let h = g.split(",").map((y) => y.trim()).filter(Boolean);
-          if (h.length === 0)
+          let g = h.split(",").map((y) => y.trim()).filter(Boolean);
+          if (g.length === 0)
             return { error: `${a} requires a path` };
-          o.push(...h), t = true;
+          n.push(...g), t = true;
           continue;
         }
         if (f.startsWith("-"))
@@ -357,36 +360,36 @@ var require_dist = __commonJS(function(exports, module) {
         break;
       }
       let d = l === -1 ? [] : e.slice(l);
-      return { paths: o, pathSet: t, quiet: n, debug: r, override: s, fast: i, command: d };
+      return { paths: n, pathSet: t, quiet: o, debug: r, override: s, fast: i, command: d };
     }
     function Ae(e) {
-      return e[0] === "~" ? Q.join(ge.homedir(), e.slice(1)) : e;
+      return e[0] === "~" ? Q.join(me.homedir(), e.slice(1)) : e;
     }
     function Ee(e) {
-      let o = Ce(), t = { encoding: o.encoding || "utf8", quiet: o.quiet === true, debug: o.debug === true, override: o.override === true, fast: o.fast === true, paths: [".env"], defaultPath: true };
-      return o.path != null && (t.paths = [o.path], t.defaultPath = false), e.pathSet && (t.paths = e.paths, t.defaultPath = false), e.quiet != null && (t.quiet = e.quiet), e.debug != null && (t.debug = e.debug), e.override != null && (t.override = e.override), e.fast != null && (t.fast = e.fast), t;
+      let n = J(), t = { encoding: n.encoding || "utf8", quiet: n.quiet, debug: n.debug === true, override: n.override === true, fast: n.fast === true, paths: [".env"], defaultPath: true };
+      return n.path != null && (t.paths = [n.path], t.defaultPath = false), e.pathSet && (t.paths = e.paths, t.defaultPath = false), e.quiet != null && (t.quiet = e.quiet), e.debug != null && (t.debug = e.debug), e.override != null && (t.override = e.override), e.fast != null && (t.fast = e.fast), t;
     }
     function be(e) {
-      let o = {}, t = [], n = { override: e.override, debug: e.debug };
+      let n = {}, t = [], o = { override: e.override, debug: e.debug };
       for (let s of e.paths) {
         let i = Q.resolve(process.cwd(), Ae(s));
         try {
-          let l = R.parse(he.readFileSync(i, { encoding: e.encoding }), { fast: e.fast });
-          R.populate(o, l, n), t.push(s);
+          let l = R.parse(ge.readFileSync(i, { encoding: e.encoding }), { fast: e.fast });
+          R.populate(n, l, o), t.push(s);
         } catch (l) {
           if (e.debug && console.log(`\u2506 failed to load ${s} ${l.message}`), !(e.defaultPath && l.code === "ENOENT"))
             throw l;
         }
       }
-      return { injected: R.populate(process.env, o, n), loadedPaths: t };
+      return { injected: R.populate(process.env, n, o), loadedPaths: t };
     }
-    function J(e) {
-      let o = e[0];
-      if (o === "--help" || o === "-h") {
+    function K(e) {
+      let n = e[0];
+      if (n === "--help" || n === "-h") {
         D();
         return;
       }
-      if (o !== "run") {
+      if (n !== "run") {
         D(), process.exitCode = 1;
         return;
       }
@@ -403,22 +406,22 @@ var require_dist = __commonJS(function(exports, module) {
         D(), process.exitCode = 1;
         return;
       }
-      let n = Ee(t);
+      let o = Ee(t);
       try {
-        let c = be(n);
-        if (!n.quiet) {
-          let a = `\u25C7 injected env (${Object.keys(c.injected).length})`;
-          c.loadedPaths.length > 0 && (a += ` from ${c.loadedPaths.join(", ")}`), console.error(a);
+        let c = be(o);
+        if (!(o.quiet == null ? J().quiet : o.quiet)) {
+          let h = `\u25C7 injected env (${Object.keys(c.injected).length})`;
+          c.loadedPaths.length > 0 && (h += ` from ${c.loadedPaths.join(", ")}`), console.error(h);
         }
       } catch (c) {
         console.error(`dotenv: ${c.message}`), process.exitCode = 1;
         return;
       }
-      let r = !!process.stdin.isTTY, s = process.platform !== "win32" && !r, i = ve(t.command[0], t.command.slice(1), { stdio: "inherit", detached: s }), l = new Map, d = 0;
+      let r = !!process.stdin.isTTY, s = process.platform !== "win32" && !r, i = Ce(t.command[0], t.command.slice(1), { stdio: "inherit", detached: s }), l = new Map, d = 0;
       function p(c) {
         if (!(!i.pid || i.exitCode !== null || i.signalCode !== null)) {
           if (process.platform === "win32") {
-            me.spawnSync("taskkill", ["/pid", String(i.pid), "/T", "/F"], { stdio: "ignore" });
+            ve.spawnSync("taskkill", ["/pid", String(i.pid), "/T", "/F"], { stdio: "ignore" });
             return;
           }
           try {
@@ -453,16 +456,16 @@ var require_dist = __commonJS(function(exports, module) {
         f(), typeof c == "number" ? process.exit(c) : (setInterval(() => {}, 1000), process.kill(process.pid, a));
       });
     }
-    F.exports = J;
-    F === __require.main && J(process.argv.slice(2));
+    F.exports = K;
+    F === __require.main && K(process.argv.slice(2));
   });
-  var I = N();
-  var Oe = K();
-  module.exports = I;
-  module.exports.config = I.config;
-  module.exports.configDotenv = I.configDotenv;
-  module.exports.parse = I.parse;
-  module.exports.populate = I.populate;
+  var j = N();
+  var qe = X();
+  module.exports = j;
+  module.exports.config = j.config;
+  module.exports.configDotenv = j.configDotenv;
+  module.exports.parse = j.parse;
+  module.exports.populate = j.populate;
 });
 
 // src/load-env.ts
@@ -6716,6 +6719,155 @@ var logoutCliSession = async ({
 // src/cli.ts
 import { readFileSync } from "fs";
 
+// ../utils/src/data-table-sort-keys.ts
+var INVENTORY_SORT_IDS = [
+  "itemCategory",
+  "category",
+  "supplier",
+  "cost",
+  "name",
+  "createdAt",
+  "updatedAt"
+];
+var ITEM_CATEGORY_SORT_IDS = [
+  "name",
+  "itemCount",
+  "createdAt",
+  "createdBy"
+];
+
+// ../db/src/generated/prisma/enums.ts
+var EstimationMode = {
+  MICRO: "MICRO",
+  MANPOWER_SPECIFIED: "MANPOWER_SPECIFIED"
+};
+var ProjectStatus = {
+  PITCH: "PITCH",
+  WON: "WON",
+  COMPLETED: "COMPLETED",
+  RECONCILED: "RECONCILED",
+  LOST: "LOST"
+};
+var BudgetStatus = {
+  DRAFT: "DRAFT",
+  PENDING_APPROVAL: "PENDING_APPROVAL",
+  APPROVED: "APPROVED",
+  REJECTED: "REJECTED",
+  ESTIMATE_CREATED: "ESTIMATE_CREATED",
+  ESTIMATE_SENT: "ESTIMATE_SENT",
+  ESTIMATE_ACCEPTED: "ESTIMATE_ACCEPTED",
+  ESTIMATE_REJECTED: "ESTIMATE_REJECTED",
+  ESTIMATE_CLOSED: "ESTIMATE_CLOSED"
+};
+var ApprovalStatus = {
+  PENDING_APPROVAL: "PENDING_APPROVAL",
+  APPROVED: "APPROVED",
+  REJECTED: "REJECTED",
+  SUPERSEDED: "SUPERSEDED"
+};
+var ApprovalType = {
+  BUDGET: "BUDGET",
+  SUPPLIER: "SUPPLIER",
+  BILL: "BILL",
+  CUSTOMER_INVOICE: "CUSTOMER_INVOICE",
+  QUOTATION: "QUOTATION"
+};
+var ErrorSeverity = {
+  LOW: "LOW",
+  MEDIUM: "MEDIUM",
+  HIGH: "HIGH",
+  CRITICAL: "CRITICAL"
+};
+var ErrorStatus = {
+  UNRESOLVED: "UNRESOLVED",
+  INVESTIGATING: "INVESTIGATING",
+  RESOLVED: "RESOLVED",
+  IGNORED: "IGNORED"
+};
+var CustomerInvoiceBatchStatus = {
+  CREATING: "CREATING",
+  PENDING_APPROVAL: "PENDING_APPROVAL",
+  APPROVED: "APPROVED",
+  REJECTED_VOIDED: "REJECTED_VOIDED",
+  EXPIRED_VOIDED: "EXPIRED_VOIDED",
+  PARTIAL_QBO_FAILURE: "PARTIAL_QBO_FAILURE"
+};
+var CustomerInvoiceStatus = {
+  CREATED_IN_QBO: "CREATED_IN_QBO",
+  APPROVED: "APPROVED",
+  SENT: "SENT",
+  PAID: "PAID",
+  VOIDED: "VOIDED",
+  QBO_SYNC_ERROR: "QBO_SYNC_ERROR"
+};
+var BillStatus = {
+  DRAFT: "DRAFT",
+  PENDING_APPROVAL: "PENDING_APPROVAL",
+  CHECKED: "CHECKED",
+  APPROVED: "APPROVED",
+  PAID: "PAID",
+  REJECTED: "REJECTED"
+};
+
+// ../utils/src/filter-enums.ts
+var ExtendedApprovalStatus = {
+  ...ApprovalStatus,
+  ALL: "ALL"
+};
+var ExtendedApprovalType = {
+  ...ApprovalType,
+  ALL: "ALL"
+};
+var ExtendedProjectStatus = {
+  ...ProjectStatus,
+  ALL: "ALL"
+};
+var ExtendedBudgetStatus = {
+  ...BudgetStatus,
+  ALL: "ALL"
+};
+var ExtendedBillStatus = {
+  ...BillStatus,
+  ALL: "ALL"
+};
+var ExtendedEstimationMode = {
+  ...EstimationMode,
+  ALL: "ALL"
+};
+var BudgetRole = {
+  ALL: "ALL",
+  BD: "BD",
+  CREATOR: "CREATOR",
+  INSIDE_SALES: "INSIDE_SALES"
+};
+var Deals = {
+  ALL: "ALL",
+  SUCCESSFUL: "SUCCESSFUL",
+  LOST: "LOST"
+};
+var TimeFrame = {
+  ALL: "ALL",
+  LAST_YEAR: "LAST_YEAR",
+  LAST_6_MONTHS: "LAST_6_MONTHS",
+  LAST_3_MONTHS: "LAST_3_MONTHS",
+  CUSTOM: "CUSTOM"
+};
+var ChartTimeFrame = {
+  LAST_30_DAYS: "last_30_days",
+  LAST_3_MONTHS: "last_3_months",
+  LAST_6_MONTHS: "last_6_months",
+  LAST_1_YEAR: "last_1_year",
+  ALL_TIME: "all_time"
+};
+var ExtendedErrorSeverity = {
+  ALL: "ALL",
+  ...ErrorSeverity
+};
+var ExtendedErrorStatus = {
+  ALL: "ALL",
+  ...ErrorStatus
+};
+
 // src/cli-trace.ts
 var cliQuietSession = false;
 var setCliQuiet = (quiet) => {
@@ -6737,6 +6889,7 @@ var SENSITIVE_FLAG = new Set([
   "authorization"
 ]);
 var SENSITIVE_TRACE_FIELD = new Set([
+  "secret",
   "paymentproof",
   "paymentproofattachments",
   "paymentproofpath",
@@ -6754,6 +6907,14 @@ var sanitizeValueForTrace = (value, seen = new WeakSet) => {
   if (Array.isArray(value)) {
     return value.map((item) => sanitizeValueForTrace(item, seen));
   }
+  if (value instanceof Error) {
+    return sanitizeValueForTrace({
+      ...value,
+      name: value.name,
+      message: value.message,
+      stack: value.stack
+    }, seen);
+  }
   const prototype = Object.getPrototypeOf(value);
   if (prototype !== Object.prototype && prototype !== null)
     return value;
@@ -6776,9 +6937,8 @@ var sanitizeFlagsForTrace = (flags) => {
 };
 var consumeCliQuietFlags = (flags) => {
   const fromEnv = process.env.BB_CLI_QUIET === "1";
-  const fromFlags = flags.quiet === true || flags.q === true;
+  const fromFlags = flags.quiet === true;
   delete flags.quiet;
-  delete flags.q;
   return fromEnv || fromFlags;
 };
 var logCliAction = (record) => {
@@ -6864,7 +7024,7 @@ var api2 = new Proxy({}, {
 });
 
 // src/prisma-enums.ts
-var ProjectStatus = {
+var ProjectStatus2 = {
   PITCH: "PITCH",
   WON: "WON",
   COMPLETED: "COMPLETED",
@@ -6878,7 +7038,7 @@ var SupplierQuotationStatus = {
   REJECTED: "REJECTED",
   SUPERSEDED: "SUPERSEDED"
 };
-var BudgetStatus = {
+var BudgetStatus2 = {
   DRAFT: "DRAFT",
   PENDING_APPROVAL: "PENDING_APPROVAL",
   APPROVED: "APPROVED",
@@ -6889,13 +7049,13 @@ var BudgetStatus = {
   ESTIMATE_REJECTED: "ESTIMATE_REJECTED",
   ESTIMATE_CLOSED: "ESTIMATE_CLOSED"
 };
-var ApprovalStatus = {
+var ApprovalStatus2 = {
   PENDING_APPROVAL: "PENDING_APPROVAL",
   APPROVED: "APPROVED",
   REJECTED: "REJECTED",
   SUPERSEDED: "SUPERSEDED"
 };
-var ApprovalType = {
+var ApprovalType2 = {
   BUDGET: "BUDGET",
   SUPPLIER: "SUPPLIER",
   BILL: "BILL",
@@ -6909,7 +7069,7 @@ var UserRole = {
   INSIDE_SALES: "INSIDE_SALES",
   ACCOUNTING_TEAM: "ACCOUNTING_TEAM"
 };
-var BillStatus = {
+var BillStatus2 = {
   DRAFT: "DRAFT",
   PENDING_APPROVAL: "PENDING_APPROVAL",
   CHECKED: "CHECKED",
@@ -6950,222 +7110,97 @@ import { readFile as readFile2, writeFile } from "fs/promises";
 import { basename } from "path";
 import { createInterface as createInterface2 } from "readline/promises";
 
-// ../db/src/generated/prisma/enums.ts
-var EstimationMode = {
-  MICRO: "MICRO",
-  MANPOWER_SPECIFIED: "MANPOWER_SPECIFIED"
+// src/runtime/error.ts
+var invocationErrorCodes = new Set([
+  "USAGE",
+  "VALIDATION",
+  "CONFIRMATION_REQUIRED"
+]);
+var trpcCodeMap = {
+  BAD_REQUEST: "VALIDATION",
+  CONFLICT: "CONFLICT",
+  FORBIDDEN: "AUTHORIZATION",
+  INTERNAL_SERVER_ERROR: "API",
+  METHOD_NOT_SUPPORTED: "API",
+  NOT_FOUND: "NOT_FOUND",
+  PARSE_ERROR: "VALIDATION",
+  PAYLOAD_TOO_LARGE: "VALIDATION",
+  PRECONDITION_FAILED: "CONFLICT",
+  TIMEOUT: "NETWORK",
+  TOO_MANY_REQUESTS: "API",
+  UNAUTHORIZED: "AUTHENTICATION",
+  UNPROCESSABLE_CONTENT: "VALIDATION"
 };
-var ProjectStatus2 = {
-  PITCH: "PITCH",
-  WON: "WON",
-  COMPLETED: "COMPLETED",
-  RECONCILED: "RECONCILED",
-  LOST: "LOST"
+var cliErrorCodes = new Set([
+  "USAGE",
+  "VALIDATION",
+  "CONFIRMATION_REQUIRED",
+  "AUTHENTICATION",
+  "AUTHORIZATION",
+  "NOT_FOUND",
+  "CONFLICT",
+  "API",
+  "NETWORK",
+  "ABORTED",
+  "INTERRUPTED",
+  "INTERNAL"
+]);
+
+class CliRuntimeError extends Error {
+  code;
+  details;
+  requestId;
+  constructor(code, message, options = {}) {
+    super(message);
+    this.name = "CliRuntimeError";
+    this.code = code;
+    this.details = options.details;
+    this.requestId = options.requestId;
+  }
+}
+var isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+var asNonEmptyString = (value) => typeof value === "string" && value.trim() !== "" ? value : undefined;
+var formatValidationMessage = (message, data) => {
+  const zodError = isRecord(data?.zodError) ? data.zodError : undefined;
+  const fieldErrors = isRecord(zodError?.fieldErrors) ? zodError.fieldErrors : undefined;
+  const fields = fieldErrors ? Object.entries(fieldErrors).flatMap(([field, errors]) => Array.isArray(errors) ? errors.filter((entry) => typeof entry === "string").map((entry) => `${field}: ${entry}`) : []) : [];
+  const formErrors = Array.isArray(zodError?.formErrors) ? zodError.formErrors.filter((entry) => typeof entry === "string") : [];
+  const validationIssues = [...fields, ...formErrors];
+  if (validationIssues.length > 0)
+    return validationIssues.join("; ");
+  let parsed = message;
+  for (let depth = 0;depth < 3 && typeof parsed === "string"; depth++) {
+    try {
+      parsed = JSON.parse(parsed);
+    } catch {
+      return message;
+    }
+  }
+  if (!Array.isArray(parsed) || parsed.length === 0 || !parsed.every(isRecord))
+    return message;
+  const issues = parsed.map((issue) => {
+    if (!Array.isArray(issue.path) || typeof issue.message !== "string" || typeof issue.code !== "string")
+      return;
+    const path = issue.path.filter((part) => typeof part === "string" || typeof part === "number").join(".") || "payload";
+    if (issue.code === "invalid_type" && typeof issue.expected === "string" && issue.message.toLowerCase().includes("required")) {
+      return `${path} must be a ${issue.expected}${path === "cost" ? ', e.g. "19"' : ""}`;
+    }
+    if (issue.code === "invalid_format" && issue.format === "regex" && path === "name" && String(issue.pattern ?? issue.message).includes("A-Za-z0-9,.?@&!#'~* _;+-")) {
+      return `${path} contains characters that are not allowed. Allowed: letters, numbers, spaces and , . ? @ & ! # ' ~ * _ ; + -`;
+    }
+    return `${path}: ${issue.message}`;
+  });
+  return issues.every((issue) => issue !== undefined) ? issues.join("; ") : message;
 };
-var BudgetStatus2 = {
-  DRAFT: "DRAFT",
-  PENDING_APPROVAL: "PENDING_APPROVAL",
-  APPROVED: "APPROVED",
-  REJECTED: "REJECTED",
-  ESTIMATE_CREATED: "ESTIMATE_CREATED",
-  ESTIMATE_SENT: "ESTIMATE_SENT",
-  ESTIMATE_ACCEPTED: "ESTIMATE_ACCEPTED",
-  ESTIMATE_REJECTED: "ESTIMATE_REJECTED",
-  ESTIMATE_CLOSED: "ESTIMATE_CLOSED"
-};
-var ApprovalStatus2 = {
-  PENDING_APPROVAL: "PENDING_APPROVAL",
-  APPROVED: "APPROVED",
-  REJECTED: "REJECTED",
-  SUPERSEDED: "SUPERSEDED"
-};
-var ApprovalType2 = {
-  BUDGET: "BUDGET",
-  SUPPLIER: "SUPPLIER",
-  BILL: "BILL",
-  CUSTOMER_INVOICE: "CUSTOMER_INVOICE",
-  QUOTATION: "QUOTATION"
-};
-var ErrorSeverity = {
-  LOW: "LOW",
-  MEDIUM: "MEDIUM",
-  HIGH: "HIGH",
-  CRITICAL: "CRITICAL"
-};
-var ErrorStatus = {
-  UNRESOLVED: "UNRESOLVED",
-  INVESTIGATING: "INVESTIGATING",
-  RESOLVED: "RESOLVED",
-  IGNORED: "IGNORED"
-};
-var CustomerInvoiceBatchStatus = {
-  CREATING: "CREATING",
-  PENDING_APPROVAL: "PENDING_APPROVAL",
-  APPROVED: "APPROVED",
-  REJECTED_VOIDED: "REJECTED_VOIDED",
-  EXPIRED_VOIDED: "EXPIRED_VOIDED",
-  PARTIAL_QBO_FAILURE: "PARTIAL_QBO_FAILURE"
-};
-var CustomerInvoiceStatus = {
-  CREATED_IN_QBO: "CREATED_IN_QBO",
-  APPROVED: "APPROVED",
-  SENT: "SENT",
-  PAID: "PAID",
-  VOIDED: "VOIDED",
-  QBO_SYNC_ERROR: "QBO_SYNC_ERROR"
-};
-var BillStatus2 = {
-  DRAFT: "DRAFT",
-  PENDING_APPROVAL: "PENDING_APPROVAL",
-  CHECKED: "CHECKED",
-  APPROVED: "APPROVED",
-  PAID: "PAID",
-  REJECTED: "REJECTED"
-};
-
-// ../utils/src/filter-enums.ts
-var ExtendedApprovalStatus = {
-  ...ApprovalStatus2,
-  ALL: "ALL"
-};
-var ExtendedApprovalType = {
-  ...ApprovalType2,
-  ALL: "ALL"
-};
-var ExtendedProjectStatus = {
-  ...ProjectStatus2,
-  ALL: "ALL"
-};
-var ExtendedBudgetStatus = {
-  ...BudgetStatus2,
-  ALL: "ALL"
-};
-var ExtendedBillStatus = {
-  ...BillStatus2,
-  ALL: "ALL"
-};
-var ExtendedEstimationMode = {
-  ...EstimationMode,
-  ALL: "ALL"
-};
-var BudgetRole = {
-  ALL: "ALL",
-  BD: "BD",
-  CREATOR: "CREATOR",
-  INSIDE_SALES: "INSIDE_SALES"
-};
-var Deals = {
-  ALL: "ALL",
-  SUCCESSFUL: "SUCCESSFUL",
-  LOST: "LOST"
-};
-var TimeFrame = {
-  ALL: "ALL",
-  LAST_YEAR: "LAST_YEAR",
-  LAST_6_MONTHS: "LAST_6_MONTHS",
-  LAST_3_MONTHS: "LAST_3_MONTHS",
-  CUSTOM: "CUSTOM"
-};
-var ExtendedErrorSeverity = {
-  ALL: "ALL",
-  ...ErrorSeverity
-};
-var ExtendedErrorStatus = {
-  ALL: "ALL",
-  ...ErrorStatus
-};
-
-// src/runtime/error.ts
-var invocationErrorCodes = new Set([
-  "USAGE",
-  "VALIDATION",
-  "CONFIRMATION_REQUIRED"
-]);
-var trpcCodeMap = {
-  BAD_REQUEST: "VALIDATION",
-  CONFLICT: "CONFLICT",
-  FORBIDDEN: "AUTHORIZATION",
-  INTERNAL_SERVER_ERROR: "API",
-  METHOD_NOT_SUPPORTED: "API",
-  NOT_FOUND: "NOT_FOUND",
-  PARSE_ERROR: "VALIDATION",
-  PAYLOAD_TOO_LARGE: "VALIDATION",
-  PRECONDITION_FAILED: "CONFLICT",
-  TIMEOUT: "NETWORK",
-  TOO_MANY_REQUESTS: "API",
-  UNAUTHORIZED: "AUTHENTICATION",
-  UNPROCESSABLE_CONTENT: "VALIDATION"
-};
-var cliErrorCodes = new Set([
-  "USAGE",
-  "VALIDATION",
-  "CONFIRMATION_REQUIRED",
-  "AUTHENTICATION",
-  "AUTHORIZATION",
-  "NOT_FOUND",
-  "CONFLICT",
-  "API",
-  "NETWORK",
-  "ABORTED",
-  "INTERRUPTED",
-  "INTERNAL"
-]);
-
-class CliRuntimeError extends Error {
-  code;
-  details;
-  requestId;
-  constructor(code, message, options = {}) {
-    super(message);
-    this.name = "CliRuntimeError";
-    this.code = code;
-    this.details = options.details;
-    this.requestId = options.requestId;
-  }
-}
-var isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
-var asNonEmptyString = (value) => typeof value === "string" && value.trim() !== "" ? value : undefined;
-var formatValidationMessage = (message, data) => {
-  const zodError = isRecord(data?.zodError) ? data.zodError : undefined;
-  const fieldErrors = isRecord(zodError?.fieldErrors) ? zodError.fieldErrors : undefined;
-  const fields = fieldErrors ? Object.entries(fieldErrors).flatMap(([field, errors]) => Array.isArray(errors) ? errors.filter((entry) => typeof entry === "string").map((entry) => `${field}: ${entry}`) : []) : [];
-  const formErrors = Array.isArray(zodError?.formErrors) ? zodError.formErrors.filter((entry) => typeof entry === "string") : [];
-  const validationIssues = [...fields, ...formErrors];
-  if (validationIssues.length > 0)
-    return validationIssues.join("; ");
-  let parsed = message;
-  for (let depth = 0;depth < 3 && typeof parsed === "string"; depth++) {
-    try {
-      parsed = JSON.parse(parsed);
-    } catch {
-      return message;
-    }
-  }
-  if (!Array.isArray(parsed) || parsed.length === 0 || !parsed.every(isRecord))
-    return message;
-  const issues = parsed.map((issue) => {
-    if (!Array.isArray(issue.path) || typeof issue.message !== "string" || typeof issue.code !== "string")
-      return;
-    const path = issue.path.filter((part) => typeof part === "string" || typeof part === "number").join(".") || "payload";
-    if (issue.code === "invalid_type" && typeof issue.expected === "string" && issue.message.toLowerCase().includes("required")) {
-      return `${path} must be a ${issue.expected}${path === "cost" ? ', e.g. "19"' : ""}`;
-    }
-    if (issue.code === "invalid_format" && issue.format === "regex" && path === "name" && String(issue.pattern ?? issue.message).includes("A-Za-z0-9,.?@&!#'~* _;+-")) {
-      return `${path} contains characters that are not allowed. Allowed: letters, numbers, spaces and , . ? @ & ! # ' ~ * _ ; + -`;
-    }
-    return `${path}: ${issue.message}`;
-  });
-  return issues.every((issue) => issue !== undefined) ? issues.join("; ") : message;
-};
-var asDetails = (value) => {
-  if (!isRecord(value))
-    return;
-  const details = {};
-  for (const [key, nestedValue] of Object.entries(value)) {
-    if (isJsonValue(nestedValue))
-      details[key] = nestedValue;
-  }
-  return Object.keys(details).length > 0 ? details : undefined;
+var asDetails = (value) => {
+  if (!isRecord(value))
+    return;
+  const details = {};
+  for (const [key, nestedValue] of Object.entries(value)) {
+    if (isJsonValue(nestedValue))
+      details[key] = nestedValue;
+  }
+  return Object.keys(details).length > 0 ? details : undefined;
 };
 var isJsonValue = (value) => {
   if (value === null || typeof value === "string" || typeof value === "boolean" || typeof value === "number") {
@@ -7277,9 +7312,9 @@ var customerInvoiceLifecycleStatuses = [
 ];
 
 // src/parse-cli-enums.ts
-var BUDGET_STATUS_VALUES = new Set(Object.values(BudgetStatus));
-var BILL_STATUS_VALUES = new Set(Object.values(BillStatus));
-var PROJECT_STATUS_VALUES = new Set(Object.values(ProjectStatus));
+var BUDGET_STATUS_VALUES = new Set(Object.values(BudgetStatus2));
+var BILL_STATUS_VALUES = new Set(Object.values(BillStatus2));
+var PROJECT_STATUS_VALUES = new Set(Object.values(ProjectStatus2));
 var SUPPLIER_QUOTATION_STATUS_VALUES = new Set(Object.values(SupplierQuotationStatus));
 var CUSTOMER_INVOICE_LIFECYCLE_STATUS_VALUES = new Set(customerInvoiceLifecycleStatuses);
 var USER_ROLE_VALUES = new Set(Object.values(UserRole));
@@ -7326,7 +7361,7 @@ function parseBillStatusForUpdate(raw) {
   if (!BILL_STATUS_VALUES.has(raw)) {
     throw new Error(`Invalid bill status "${raw}". Use one of: ${[...BILL_STATUS_VALUES].join(", ")}.`);
   }
-  if (raw === BillStatus.PENDING_APPROVAL) {
+  if (raw === BillStatus2.PENDING_APPROVAL) {
     throw new Error("Cannot set PENDING_APPROVAL via update-bill-status. Use create-bill-approval <billId> instead.");
   }
   return raw;
@@ -7373,6 +7408,16 @@ var PROJECT_HUB_SORT_FIELDS = new Set([
   "companyName",
   "status"
 ]);
+function parseOptionalIsoDateFlag(raw, flagName, { endOfDay = false } = {}) {
+  if (raw === undefined || raw === "")
+    return;
+  const value = /^\d{4}-\d{2}-\d{2}$/.test(raw) ? `${raw}T${endOfDay ? "23:59:59.999" : "00:00:00.000"}Z` : /T\d{2}:\d{2}(:\d{2}(\.\d+)?)?$/.test(raw) ? `${raw}Z` : raw;
+  const parsed = new Date(value);
+  if (Number.isNaN(parsed.getTime())) {
+    throw new Error(`${flagName} must be an ISO date (YYYY-MM-DD) or ISO datetime.`);
+  }
+  return parsed;
+}
 function parseOptionalProjectHubSortBy(raw) {
   if (raw === undefined || raw === "")
     return;
@@ -7565,10 +7610,10 @@ function parseApprovalTypeFlag(raw) {
   }
   return u;
 }
-var budgetStatusesForHelp = Object.values(BudgetStatus);
-var billStatusesForHelp = Object.values(BillStatus);
-var billStatusesForUpdateHelp = Object.values(BillStatus).filter((s) => s !== BillStatus.PENDING_APPROVAL);
-var projectStatusesForHelp = Object.values(ProjectStatus);
+var budgetStatusesForHelp = Object.values(BudgetStatus2);
+var billStatusesForHelp = Object.values(BillStatus2);
+var billStatusesForUpdateHelp = Object.values(BillStatus2).filter((s) => s !== BillStatus2.PENDING_APPROVAL);
+var projectStatusesForHelp = Object.values(ProjectStatus2);
 var userRolesForHelp = Object.values(UserRole);
 
 // ../utils/src/rich-text.ts
@@ -8494,11 +8539,11 @@ var confirmCurrentCommand = async (input) => {
 };
 // src/commands/index.ts
 import { contentType } from "mime-types";
-var BUDGET = ApprovalType.BUDGET;
-var BILL = ApprovalType.BILL;
-var SUPPLIER = ApprovalType.SUPPLIER;
-var QUOTATION = ApprovalType.QUOTATION;
-var CUSTOMER_INVOICE = ApprovalType.CUSTOMER_INVOICE;
+var BUDGET = ApprovalType2.BUDGET;
+var BILL = ApprovalType2.BILL;
+var SUPPLIER = ApprovalType2.SUPPLIER;
+var QUOTATION = ApprovalType2.QUOTATION;
+var CUSTOMER_INVOICE = ApprovalType2.CUSTOMER_INVOICE;
 var ASANA_WON_LOST_SECTION_GIDS = new Set([
   "1211678338364908",
   "1211678338364907"
@@ -8555,7 +8600,7 @@ var createApprovalEmailDeliveryFailure = (error) => ({
   error
 });
 function isPendingRequest(n) {
-  return n.notificationType === "request" && n.status === ApprovalStatus.PENDING_APPROVAL;
+  return n.notificationType === "request" && n.status === ApprovalStatus2.PENDING_APPROVAL;
 }
 var out = (data) => {
   emitCommandResult(data);
@@ -8762,11 +8807,11 @@ var quotationAttachmentContentTypeForFileName = (fileName) => {
   throw new Error(`Unsupported quotation attachment type: ${fileName}. Use PDF, JPEG, or PNG.`);
 };
 var LOCKED_BUDGET_STATUSES_REQUIRING_CONFIRMATION = new Set([
-  BudgetStatus.ESTIMATE_CREATED,
-  BudgetStatus.ESTIMATE_SENT,
-  BudgetStatus.ESTIMATE_ACCEPTED,
-  BudgetStatus.ESTIMATE_REJECTED,
-  BudgetStatus.ESTIMATE_CLOSED
+  BudgetStatus2.ESTIMATE_CREATED,
+  BudgetStatus2.ESTIMATE_SENT,
+  BudgetStatus2.ESTIMATE_ACCEPTED,
+  BudgetStatus2.ESTIMATE_REJECTED,
+  BudgetStatus2.ESTIMATE_CLOSED
 ]);
 var lockedBudgetStatusLabels = {
   ESTIMATE_CREATED: "Estimate Created",
@@ -8888,36 +8933,20 @@ var updateProjectWithEstimateInvalidationConfirmation = async (input) => {
     });
   }
 };
-async function listBudgets(opts) {
-  const input = {
-    projectId: opts.projectId,
-    name: opts.name,
-    statuses: opts.statuses,
-    createdBy: opts.createdBy,
-    dateFrom: opts.dateFrom,
-    dateTo: opts.dateTo,
-    active: opts.active,
-    sortBy: opts.sortBy,
-    sortDir: opts.sortDir,
-    page: opts.page ?? 1,
-    perPage: opts.perPage ?? 20,
-    includeDetails: opts.includeDetails ?? true
-  };
-  const result = await api2.budget.getAllBudgets.query(input);
-  out(result);
-}
+var listBudgets = async (input) => {
+  out(await api2.budget.getAllBudgets.query(input));
+};
+var countBudgets = async (input) => {
+  out(await api2.budget.getCounts.query(input));
+};
 async function getBudget(id, opts) {
-  const [budget, items] = await Promise.all([
-    api2.budget.getBudget.query({
-      id,
-      includeInactive: opts?.includeInactive ?? false
-    }),
-    api2.budget.getBudgetItems.query({
-      budgetId: id,
-      includeInactive: opts?.includeInactive ?? false
-    })
+  const includeInactive = opts?.includeInactive ?? false;
+  const [budget, items, totals] = await Promise.all([
+    api2.budget.getBudget.query({ id, includeInactive }),
+    api2.budget.getBudgetItems.query({ budgetId: id, includeInactive }),
+    api2.budget.getBudgetItemTotals.query({ budgetId: id, includeInactive })
   ]);
-  out({ budget, items });
+  out({ budget, items: { ...items, totals } });
 }
 async function updateBudgetStatus(budgetId, status, opts) {
   await assertSensitiveWorkflowConfirmed({
@@ -8944,7 +8973,7 @@ async function updateBudgetStatus(budgetId, status, opts) {
   });
   out({
     ...result,
-    invoiceSetup: result.newStatus === BudgetStatus.ESTIMATE_ACCEPTED && result.hasQuickbooksEstimate ? invoiceSplitSetupNextAction(budgetId) : null
+    invoiceSetup: result.newStatus === BudgetStatus2.ESTIMATE_ACCEPTED && result.hasQuickbooksEstimate ? invoiceSplitSetupNextAction(budgetId) : null
   });
 }
 var assertBudgetActionReadiness = async ({
@@ -9011,22 +9040,22 @@ var runBudgetPreflight = async (budgetId, preflight) => {
     await updateProjectWithEstimateInvalidationConfirmation(payload);
   }
 };
-async function listBills(opts) {
-  const input = {
-    projectId: opts.projectId,
-    budgetId: opts.budgetId,
-    statuses: billStatusesForApi(opts.statuses),
-    search: opts.search?.trim() || undefined,
-    isClaimable: opts.isClaimable,
-    createdByIds: opts.createdByIds && opts.createdByIds.length > 0 ? opts.createdByIds : undefined,
-    sortBy: opts.sortBy,
-    sortDir: opts.sortDir,
-    page: opts.page ?? 1,
-    pageSize: opts.pageSize ?? 20
-  };
-  const result = await api2.bill.getAll.query(input);
-  out(result);
-}
+var listBills = async (input) => {
+  out(await api2.bill.getAll.query({
+    ...input,
+    statuses: billStatusesForApi(input.statuses),
+    search: input.search?.trim() || undefined,
+    createdByIds: input.createdByIds?.length ? input.createdByIds : undefined
+  }));
+};
+var countBills = async (input) => {
+  out(await api2.bill.getCounts.query({
+    ...input,
+    statuses: billStatusesForApi(input.statuses),
+    search: input.search?.trim() || undefined,
+    createdByIds: input.createdByIds?.length ? input.createdByIds : undefined
+  }));
+};
 async function approveBill(billId, overBudgetOverrideReason) {
   await assertSensitiveWorkflowConfirmed({
     action: "Approve bill",
@@ -9041,7 +9070,7 @@ async function approveBill(billId, overBudgetOverrideReason) {
   }
   const result = await api2.bill.updateApproval.mutate({
     billApprovalId: approval.id,
-    status: ApprovalStatus.APPROVED,
+    status: ApprovalStatus2.APPROVED,
     overBudgetOverrideReason
   });
   if (result.processing) {
@@ -9098,20 +9127,12 @@ async function listApprovals(opts) {
   });
   out({ items });
 }
-async function listSuppliers(opts) {
-  const result = await api2.supplier.getSuppliers.query({
-    page: opts.page ?? 1,
-    perPage: opts.perPage ?? 10,
-    sort: opts.sort ?? [{ id: "createdAt", desc: true }],
-    name: opts.name,
-    createdBy: opts.createdBy,
-    gstRegistered: opts.gstRegistered ?? null,
-    status: opts.status,
-    supplierTags: opts.supplierTags,
-    active: opts.active ?? true
-  });
-  out(result);
-}
+var listSuppliers = async (opts) => {
+  out(await api2.supplier.getSuppliers.query(opts));
+};
+var countSuppliers = async (opts) => {
+  out(await api2.supplier.getSummary.query(opts));
+};
 async function createBillApproval(billId) {
   await assertSensitiveWorkflowConfirmed({
     action: "Create bill approval request",
@@ -9137,10 +9158,10 @@ async function createBillApproval(billId) {
   });
 }
 var validateBillStatusUpdateOptions = (opts) => {
-  if (opts.status === BillStatus.PAID && !opts.paymentReference?.trim()) {
+  if (opts.status === BillStatus2.PAID && !opts.paymentReference?.trim()) {
     throw new Error("update-bill-status requires --paymentReference when status is PAID.");
   }
-  if (opts.status !== BillStatus.PAID && opts.paymentProofPath !== undefined) {
+  if (opts.status !== BillStatus2.PAID && opts.paymentProofPath !== undefined) {
     throw new Error("--paymentProof can only be used when status is PAID.");
   }
   if (opts.paymentProofPath !== undefined && !opts.paymentProofPath.trim()) {
@@ -9148,13 +9169,10 @@ var validateBillStatusUpdateOptions = (opts) => {
   }
 };
 var deleteStagedPaymentProof = async (projectId, key) => {
-  const cleanup = await api2.attachment.deleteStagedBillAttachments.mutate({
+  await api2.attachment.deleteStagedBillAttachments.mutate({
     projectId,
     keys: [key]
   });
-  if (cleanup.failedKeys.includes(key)) {
-    throw new Error(`Failed to delete staged payment proof ${key}.`);
-  }
 };
 var rethrowAfterStagedPaymentProofCleanup = async (error, cleanup) => {
   if (cleanup) {
@@ -9288,10 +9306,9 @@ async function patchBillInvoiceNumber(id, invoiceNumber) {
   });
   out(result);
 }
-async function getBillAttachments(id) {
-  const result = await api2.bill.getAttachments.query({ id });
-  out(result);
-}
+var getBillAttachments = async (input) => {
+  out(await api2.bill.getAttachments.query(input));
+};
 async function stageBillAttachmentsFromPaths(projectId, filePaths) {
   const attachments = [];
   for (const filePath of filePaths) {
@@ -9499,7 +9516,7 @@ async function uploadBudgetWinProofFromPath(budgetId, filePath, opts) {
   });
   const result = await api2.budget.updateBudgetStatus.mutate({
     id: budgetId,
-    status: BudgetStatus.ESTIMATE_ACCEPTED,
+    status: BudgetStatus2.ESTIMATE_ACCEPTED,
     ...opts?.projectManagerId !== undefined && {
       projectManagerId: opts.projectManagerId
     },
@@ -9523,11 +9540,12 @@ async function getBillDetails(id) {
   out(result);
 }
 async function getBudgetItemsOnly(budgetId, opts) {
-  const items = await api2.budget.getBudgetItems.query({
-    budgetId,
-    includeInactive: opts?.includeInactive ?? false
-  });
-  out(items);
+  const includeInactive = opts?.includeInactive ?? false;
+  const [items, totals] = await Promise.all([
+    api2.budget.getBudgetItems.query({ budgetId, includeInactive }),
+    api2.budget.getBudgetItemTotals.query({ budgetId, includeInactive })
+  ]);
+  out({ ...items, totals });
 }
 async function addBudgetItems(opts) {
   await confirmLockedBudgetChangeByBudgetId(opts.budgetId, "Add budget items");
@@ -9564,10 +9582,9 @@ var approveUnavailableItemException = async (input) => {
   const result = await api2.budgetItem.approveUnavailableItemException.mutate(input);
   out(result);
 };
-async function getBudgetCategories() {
-  const categories = await api2.budget.getBudgetCategories.query();
-  out(categories);
-}
+var getBudgetCategories = async (input) => {
+  out(await api2.budget.searchBudgetCategories.query(input));
+};
 var getBudgetVersions = async (budgetId, options = {}) => {
   if (options.all && options.cursor !== undefined) {
     throw new CliRuntimeError("USAGE", "--all cannot be combined with --cursor.");
@@ -9581,15 +9598,15 @@ var getBudgetVersions = async (budgetId, options = {}) => {
       limit: options.limit,
       cursor
     });
-    versions.push(...page.versions);
-    cursor = page.nextCursor;
-    if (!options.all || cursor === undefined)
+    versions.push(...page.items);
+    cursor = page.pageInfo.nextCursor;
+    if (!options.all || cursor === null)
       break;
     if (seenCursors.has(cursor)) {
       throw new Error("Budget history pagination did not advance; export aborted.");
     }
     seenCursors.add(cursor);
-  } while (cursor !== undefined);
+  } while (cursor !== null);
   out({ versions, nextCursor: cursor ?? null });
 };
 async function createBudgetApproval(budgetId, preflight) {
@@ -9840,10 +9857,12 @@ async function createBillFromPayload(raw, draftOnlyFlag, quotationExempt = false
   }) : await api2.bill.create.mutate(input);
   out(result);
 }
-async function listQuotations(opts) {
-  const result = await api2.quotation.list.query(opts);
-  out(result);
-}
+var listQuotations = async (input) => {
+  out(await api2.quotation.listPage.query(input));
+};
+var countQuotations = async (input) => {
+  out(await api2.quotation.getCounts.query(input));
+};
 async function getQuotationDetails(id) {
   const result = await api2.quotation.getById.query({ id });
   out(result);
@@ -9888,8 +9907,10 @@ var checkCustomerInvoiceReadiness = async (budgetId) => {
   out(result);
 };
 var listCustomerInvoices = async (input) => {
-  const result = await api2.customerInvoice.list.query(input);
-  out(result);
+  out(await api2.customerInvoice.list.query(input));
+};
+var countCustomerInvoices = async (input) => {
+  out(await api2.customerInvoice.getCounts.query(input));
 };
 var listEligibleCustomerInvoiceBudgets = async (projectId) => {
   const result = await api2.customerInvoice.getEligibleBudgets.query({
@@ -9945,7 +9966,7 @@ var createCustomerInvoice = async (raw) => {
   await assertSensitiveWorkflowConfirmed({
     action: "Create customer invoice",
     entity: `budget ${input.budgetId}`,
-    details: `creates ${input.splits.length} invoice(s) in QuickBooks from the budget's remaining uninvoiced balance: ${input.splits.map((split) => `${split.label} (${split.percentage}% of the estimate), due ${new Date(split.dueDate).toISOString().slice(0, 10)}`).join("; ")}. Admin creation is auto-approved; other creators request approval. No customer email is sent.`
+    details: `queues ${input.splits.length} invoice(s) for creation in QuickBooks from the budget's remaining uninvoiced balance: ${input.splits.map((split) => `${split.label} (${split.percentage}% of the estimate), due ${new Date(split.dueDate).toISOString().slice(0, 10)}`).join("; ")}. Admin creation is auto-approved; other creators request approval. No customer email is sent.`
   });
   const result = await api2.customerInvoice.createInvoiceBatch.mutate(input);
   out(result);
@@ -9965,7 +9986,7 @@ var deleteCustomerInvoice = async (batchId) => {
   await assertSensitiveWorkflowConfirmed({
     action: "Delete customer invoice",
     entity: `invoice batch ${batchId}`,
-    details: "deletes its invoices from QuickBooks and removes the local batch; paid invoices are blocked until their QBO payments are reversed; removing approved coverage may reopen the estimate"
+    details: "queues deletion of its invoices in QuickBooks; the local batch is removed once QuickBooks confirms; paid invoices are blocked until their QBO payments are reversed; removing approved coverage may reopen the estimate"
   });
   const result = await api2.customerInvoice.deleteInvoiceBatch.mutate({
     batchId
@@ -9976,7 +9997,7 @@ var voidCustomerInvoice = async (batchId) => {
   await assertSensitiveWorkflowConfirmed({
     action: "Void customer invoice",
     entity: `invoice batch ${batchId}`,
-    details: "voids its invoices in QuickBooks and updates Budget Builder; paid invoices are blocked until their QBO payments are reversed; removing approved coverage may reopen the estimate"
+    details: "queues a void of its invoices in QuickBooks; Budget Builder updates once QuickBooks confirms; paid invoices are blocked until their QBO payments are reversed; removing approved coverage may reopen the estimate"
   });
   const result = await api2.customerInvoice.voidInvoiceBatch.mutate({ batchId });
   out(result);
@@ -9996,7 +10017,7 @@ var rejectCustomerInvoice = async (batchId, rejectionReason) => {
   await assertSensitiveWorkflowConfirmed({
     action: "Reject customer invoice",
     entity: `invoice batch ${batchId}`,
-    details: `records the rejection reason, voids it in QuickBooks, notifies its creator, and reopens a prematurely closed estimate when applicable`
+    details: `queues a void of its invoices in QuickBooks; once QuickBooks confirms, records the rejection reason, notifies its creator, and reopens a prematurely closed estimate when applicable`
   });
   const result = await api2.customerInvoice.rejectInvoiceBatch.mutate({
     batchId,
@@ -10080,7 +10101,7 @@ async function createSupplierFromPayload(raw) {
     throw new CliRuntimeError(normalized.code, `Supplier creation outcome is uncertain for ${JSON.stringify(input.name)}. Run list-suppliers and inspect matching supplier details before retrying; names may not be unique, so do not retry create-supplier until you can verify that no supplier was created. Original error: ${normalized.message}`);
   }
   const supplier = created.result;
-  if (supplier.status !== ApprovalStatus.PENDING_APPROVAL) {
+  if (supplier.status !== ApprovalStatus2.PENDING_APPROVAL) {
     out(created);
     return;
   }
@@ -10147,6 +10168,10 @@ async function updateProjectFromPayload(raw) {
   const result = await updateProjectWithEstimateInvalidationConfirmation(input);
   out(result);
 }
+var getCompanyQuickBooksSyncStatus = async (companyId) => {
+  const result = await api2.company.getQuickBooksSyncStatus.query({ companyId });
+  out(result);
+};
 async function updateCompanyFromPayload(raw) {
   const input = parseCompanyUpdatePayload(raw);
   const result = await api2.company.updateCompany.mutate(input);
@@ -10398,16 +10423,14 @@ async function rejectQuotation(quotationId, reason) {
   });
   out(result);
 }
-async function listCompanies(opts) {
-  const result = await api2.company.getCompanies.query({
-    name: opts.name,
-    createdBy: opts.createdBy,
-    active: opts.active,
-    page: opts.page ?? 1,
-    perPage: opts.perPage ?? 20
-  });
+var listCompanies = async (input) => {
+  const result = await api2.company.getCompanies.query(input);
   out(result);
-}
+};
+var countCompanies = async (input) => {
+  const result = await api2.company.getCompanyCounts.query(input);
+  out(result);
+};
 async function getCompany(id) {
   const company = await api2.company.getCompanyById.query({ id });
   out(company);
@@ -10416,31 +10439,26 @@ async function createCompany(opts) {
   const result = await api2.company.createCompany.mutate(opts);
   out(result);
 }
-var searchExistingCompanies = async (query, page = 1) => {
-  out(await api2.company.searchExistingCompanies.query({ query, page }));
+var searchExistingCompanies = async (input) => {
+  out(await api2.company.searchExistingCompanies.query(input));
 };
 var reuseExistingCompany = async (input) => {
   out(await api2.company.useExistingCompany.mutate(input));
 };
-async function listProjects(opts) {
-  const result = await api2.project.getAllProjects.query({
-    companyId: opts.companyId,
-    name: opts.name,
-    status: opts.status,
-    active: opts.active,
-    page: opts.page ?? 1,
-    perPage: opts.perPage ?? 20
-  });
+var listProjects = async (input) => {
+  const result = await api2.project.getAllProjects.query(input);
   out(result);
-}
-var listProjectHubs = async (opts) => {
-  const result = await api2.project.getAllProjectHubs.query({
-    ...opts,
-    page: opts.page ?? 1,
-    perPage: opts.perPage ?? 20
-  });
+};
+var countProjects = async (input) => {
+  const result = await api2.project.getProjectCounts.query(input);
   out(result);
 };
+var listProjectHubs = async (input) => {
+  out(await api2.project.getAllProjectHubs.query(input));
+};
+var countProjectHubs = async (input) => {
+  out(await api2.project.getProjectHubCounts.query(input));
+};
 async function getProject(id) {
   const [project, budgetsOverview, billsOverview] = await Promise.all([
     api2.project.getProjectDetailsById.query({ id }),
@@ -10536,7 +10554,7 @@ var reconcileProject = async (projectId) => {
   out(result);
 };
 var completeProject = async (projectId) => {
-  await updateProjectStatus(projectId, ProjectStatus.COMPLETED);
+  await updateProjectStatus(projectId, ProjectStatus2.COMPLETED);
 };
 var importQuickBooksProjectId = async (projectId, projectUrl) => {
   const result = await api2.project.importQboProjectId.mutate({
@@ -10545,14 +10563,71 @@ var importQuickBooksProjectId = async (projectId, projectUrl) => {
   });
   out(result);
 };
-var listIntegrationOperations = async (input) => {
-  const result = await api2.integration.listOperations.query(input);
-  out(result);
+var listWebhookEventTypes = async () => {
+  out(await api2.webhook.listEventTypes.query());
 };
-var retryIntegrationOperation = async (operationId, confirmExternalStateReconciled, outboundEmailResolution, providerMessageId) => {
-  await assertSensitiveWorkflowConfirmed({
-    action: outboundEmailResolution === "ACCEPTED" ? "Reconcile integration operation as completed" : "Retry integration operation",
-    entity: `operation ${operationId}`,
+var listWebhookEndpoints = async () => {
+  out(await api2.webhook.listEndpoints.query());
+};
+var getWebhookEndpoint = async (id) => {
+  out(await api2.webhook.getEndpoint.query({ id }));
+};
+var createWebhookEndpoint = async (input) => {
+  const result = await api2.webhook.createEndpoint.mutate(input);
+  out({
+    ...result,
+    note: "Store the signing secret now; Budget Builder never shows it again."
+  });
+};
+var updateWebhookEndpoint = async (input) => {
+  out(await api2.webhook.updateEndpoint.mutate(input));
+};
+var deleteWebhookEndpoint = async (id) => {
+  await assertSensitiveWorkflowConfirmed({
+    action: "Delete webhook endpoint and its delivery history",
+    entity: `webhook endpoint ${id}`
+  });
+  out(await api2.webhook.deleteEndpoint.mutate({ id }));
+};
+var rotateWebhookSecret = async (input) => {
+  await assertSensitiveWorkflowConfirmed({
+    action: "Rotate webhook signing secret",
+    entity: `webhook endpoint ${input.id}`,
+    details: `previous secrets keep signing for ${input.previousSecretTtlHours ?? 24}h`
+  });
+  const result = await api2.webhook.rotateSecret.mutate(input);
+  out({
+    ...result,
+    note: "Store the new signing secret now; Budget Builder never shows it again."
+  });
+};
+var sendWebhookTestEvent = async (id) => {
+  out(await api2.webhook.sendTestEvent.mutate({ id }));
+};
+var listWebhookDeliveries = async (input) => {
+  out(await api2.webhook.listDeliveries.query(input));
+};
+var getWebhookDelivery = async (deliveryId) => {
+  out(await api2.webhook.getDelivery.query({ deliveryId }));
+};
+var replayWebhookDelivery = async (deliveryId) => {
+  out(await api2.webhook.replayDelivery.mutate({ deliveryId }));
+};
+var listIntegrationOperations = async (input) => {
+  const result = await api2.integration.listOperations.query(input);
+  out(result);
+};
+var getIntegrationOperation = async (operationId) => {
+  const result = await api2.integration.getOperation.query({ operationId });
+  out(result);
+};
+var countIntegrationOperations = async (input) => {
+  out(await api2.integration.getCounts.query(input));
+};
+var retryIntegrationOperation = async (operationId, confirmExternalStateReconciled, outboundEmailResolution, providerMessageId) => {
+  await assertSensitiveWorkflowConfirmed({
+    action: outboundEmailResolution === "ACCEPTED" ? "Reconcile integration operation as completed" : "Retry integration operation (QuickBooks jobs with a saved attempt check QuickBooks first and never resend an applied change)",
+    entity: `operation ${operationId}`,
     details: outboundEmailResolution === "ACCEPTED" ? `mark provider-accepted email sent with message ID ${providerMessageId ?? "<missing>"}` : outboundEmailResolution === "NOT_ACCEPTED_RETRY" ? "rotate the Resend idempotency key and retry provider delivery" : confirmExternalStateReconciled ? "after confirming the external state has been reconciled" : undefined
   });
   const result = await api2.integration.retryOperation.mutate({
@@ -10563,10 +10638,25 @@ var retryIntegrationOperation = async (operationId, confirmExternalStateReconcil
   });
   out(result);
 };
+var reconcileResourceOperation = async (operationId) => {
+  await assertSensitiveWorkflowConfirmed({
+    action: "Verify QuickBooks resource outcome",
+    entity: `operation ${operationId}`,
+    details: "verify the saved receipt or read QuickBooks when the attempt is uncertain, then queue local update/archive/reactivation finalization without repeating the provider mutation"
+  });
+  const result = await api2.integration.reconcileResourceOperation.mutate({
+    operationId
+  });
+  out(result);
+};
 var listInboundSources = async (input) => {
   const result = await api2.inbound.listSources.query(input);
   out(result);
 };
+var countInboundSources = async (input) => {
+  const result = await api2.inbound.countSources.query(input);
+  out(result);
+};
 var createInboundSource = async (input) => {
   const result = await api2.inbound.createSource.mutate(input);
   out(result);
@@ -10583,6 +10673,9 @@ var listInboundSubmissions = async (input) => {
   const result = await api2.inbound.listSubmissions.query(input);
   out(result);
 };
+var countInboundSubmissions = async (input) => {
+  out(await api2.inbound.countSubmissions.query(input));
+};
 var getInboundSubmission = async (submissionId) => {
   const result = await api2.inbound.getSubmission.query({ submissionId });
   out(result);
@@ -10610,39 +10703,32 @@ async function listContacts(companyId) {
   });
   out(contacts);
 }
-async function listItems(opts) {
-  const filters = {
-    includeQuickBooksDeactivationPending: opts.includeQuickBooksDeactivationPending,
-    name: opts.name
-  };
-  const perPage = opts.perPage ?? 20;
-  const [items, { total, counts }] = await Promise.all([
-    api2.item.getItems.query({ ...filters, page: opts.page ?? 1, perPage }),
-    api2.item.getItemCounts.query(filters)
-  ]);
-  out({ items, pageCount: Math.ceil(total / perPage), counts });
-}
+var listItems = async (input) => {
+  out(await api2.item.getItems.query(input));
+};
+var countItems = async (input) => {
+  out(await api2.item.getItemCounts.query(input));
+};
 async function getItem(id) {
   const item = await api2.item.getItem.query({ id });
   out(item);
 }
-async function listItemCategories(opts) {
-  const result = await api2.itemCategory.getItemCategories.query({
-    page: opts.page ?? 1,
-    perPage: opts.perPage ?? 50
-  });
+var getItemQuickBooksSyncStatus = async (itemId) => {
+  const result = await api2.item.getQuickBooksSyncStatus.query({ id: itemId });
   out(result);
-}
-async function getSupplierAnalytics(opts) {
-  const result = await api2.dashboard.getSupplierTableData.query({
-    page: opts.page ?? 1,
-    perPage: opts.perPage ?? 20,
-    sort: [],
-    name: opts.name,
-    timeFrame: opts.timeFrame ?? "ALL"
-  });
-  out(result);
-}
+};
+var listItemCategories = async (input) => {
+  out(await api2.itemCategory.getItemCategories.query(input));
+};
+var countItemCategories = async (input) => {
+  out(await api2.itemCategory.getCounts.query(input));
+};
+var getSupplierAnalytics = async (input) => {
+  out(await api2.dashboard.getSupplierTableData.query(input));
+};
+var countSupplierAnalytics = async (input) => {
+  out(await api2.dashboard.getSupplierTableCounts.query(input));
+};
 async function createUser(input) {
   const user = await api2.user.create.mutate(input);
   out(user);
@@ -10659,10 +10745,12 @@ async function revokeApiKeyForUser(input) {
   const result = await api2.mcpApiKey.revoke.mutate(input);
   out(result);
 }
-async function listUsers() {
-  const users = await api2.user.getAllUsers.query();
-  out(users);
-}
+var listUsers = async (input) => {
+  out(await api2.user.searchUsers.query(input));
+};
+var countUsers = async (input) => {
+  out(await api2.user.getCounts.query(input));
+};
 async function whoAmI() {
   const user = await api2.user.getCurrentUser.query();
   out(user);
@@ -10726,33 +10814,34 @@ async function getFinancialOverview(input) {
   });
   out(result);
 }
-async function getRecentErrors(opts) {
-  const result = await api2.errorLog.getRecentErrors.query({
-    page: opts.page ?? 1,
-    perPage: opts.perPage ?? 10,
-    severity: opts.severity,
-    status: opts.status
-  });
-  out(result);
-}
+var getRecentErrors = async (input) => {
+  out(await api2.errorLog.getRecentErrors.query(input));
+};
+var countErrors = async (input) => {
+  out(await api2.errorLog.countErrors.query(input));
+};
 async function getErrorMetrics() {
   const result = await api2.errorLog.getErrorMetrics.query({});
   out(result);
 }
 async function getApprovedBudgets(opts) {
-  const perPage = Math.min(opts.limit ?? 50, 100);
-  const { budgets, totalCount } = await api2.budget.getAllBudgets.query({
+  const filters = {
     projectId: opts.projectId,
     statuses: [
       ExtendedBudgetStatus.APPROVED,
       ExtendedBudgetStatus.ESTIMATE_ACCEPTED,
       ExtendedBudgetStatus.ESTIMATE_CLOSED
-    ],
-    page: 1,
-    perPage,
-    includeDetails: false
-  });
-  const items = (budgets ?? []).map((b) => {
+    ]
+  };
+  const [{ items: budgets }, { totalCount }] = await Promise.all([
+    api2.budget.getAllBudgets.query({
+      ...filters,
+      limit: Math.min(opts.limit ?? 50, 100),
+      includeDetails: false
+    }),
+    api2.budget.getCounts.query(filters)
+  ]);
+  const items = budgets.map((b) => {
     const calc = b;
     const revenue = calc.totalSellingAfterDiscount ?? 0;
     const cost = calc.totalCostWithoutGst ?? 0;
@@ -10840,7 +10929,7 @@ function parseArgs(argv) {
         }
       }
     } else if (arg === "-q") {
-      flags.q = true;
+      flags.quiet = true;
     } else {
       positional.push(arg);
     }
@@ -11192,6 +11281,7 @@ var financialWriteTargets = new Set([
 ]);
 var deleteTargets = new Set([
   "cleanup-staged-bill-attachments",
+  "delete-webhook-endpoint",
   "cleanup-staged-quotation-attachments",
   "discard-customer-invoice",
   "complete-project",
@@ -11200,7 +11290,14 @@ var deleteTargets = new Set([
   "restore-budget-version",
   "update-project-status"
 ]);
+var explicitEffects = {
+  "rotate-webhook-secret": ["state-change"],
+  "replay-webhook-delivery": ["state-change", "external-write"]
+};
 var effectsFor = (legacyTarget) => {
+  const explicit = explicitEffects[legacyTarget];
+  if (explicit)
+    return explicit;
   const effects = new Set;
   if (mutationPrefixes.some((prefix) => legacyTarget.startsWith(prefix))) {
     effects.add("state-change");
@@ -11218,16 +11315,56 @@ var effectsFor = (legacyTarget) => {
 };
 var titleCase = (value) => value.split("-").map((word) => `${word.slice(0, 1).toUpperCase()}${word.slice(1)}`).join(" ");
 var summaryFor = (legacyTarget) => {
+  if (legacyTarget === "update-budget-status")
+    return "Update budget status. APPROVED requires a current Lead/Admin role; budget management permission alone is insufficient. Ordinary users must request approval. Status changes invalidate old pending requests.";
+  if (legacyTarget === "approve-budget" || legacyTarget === "reject-budget")
+    return "Decide your assigned pending budget approval as a current Lead/Admin. Material edits supersede old requests; inspect the latest content and use a fresh request after edits.";
+  if (legacyTarget === "create-budget-approval")
+    return "Request budget approval for the current content, superseding older pending requests. Existing Lead/Admin autoapproval remains available.";
+  if (legacyTarget === "update-budget-item-supplier")
+    return "Change a budget item's eligible supplier/GST snapshot as a material financial edit. Supersede pending approvals and apply the standard budget-to-DRAFT reset policy; inspect and request approval again. An unchanged supplier is a no-op.";
+  if (legacyTarget === "submit-quotation")
+    return "Submit a quotation for signing and approval. Claim the captured revision and exact allocation selection; concurrent edits, budget-item deletion or restore cascades conflict instead of attaching old signed PDFs. Refresh and resubmit the current content.";
+  if (legacyTarget === "approve-quotation")
+    return "Approve your assigned pending quotation as a current Admin. Claim the captured revision and exact allocation selection after signing; concurrent changes conflict and roll back the decision, signed attachment and email/outbox. Refresh and review the current content before retrying.";
   if (legacyTarget === "approve-supplier")
     return "Approve a pending supplier request and send a requester reply email, or directly re-approve a rejected supplier as Admin/Lead without a pending request or email. QuickBooks is synchronized; archived suppliers remain archived. Argument: <supplierId>.";
+  if (legacyTarget === "get-bill-attachments")
+    return "List bill attachments with cursor pagination. <billId> [--limit 1-50] [--cursor <token>] Newest first. Returns { items, pageInfo }; follow nextCursor.";
+  if (legacyTarget === "get-budget-categories")
+    return "List budget categories with cursor pagination. [--q] [--limit 1-100] [--cursor <token>] Active categories, name A\u2013Z. Returns { items, pageInfo }; follow nextCursor with the same --q.";
+  if (legacyTarget === "get-supplier-analytics")
+    return "List supplier analytics rows with cursor pagination. [--name] [--status CSV] [--gstRegistered true|false] [--createdBy <text>] [--timeFrame ALL|LAST_YEAR|LAST_6_MONTHS|LAST_3_MONTHS|CUSTOM] [--startDate <ISO> --endDate <ISO>] [--sortBy name|gstRegistered|status|phone|email|updatedAt|createdAt] [--sortDir asc|desc] [--limit 1-100] [--cursor <token>] [--direction forward|backward] Admin. Returns { items, pageInfo }; follow nextCursor/previousCursor with the same filters and sort. --page/--perPage are rejected.";
+  if (legacyTarget === "list-api-keys")
+    return "List API keys with cursor pagination. [--userId <userId>] [--limit 1-100] [--cursor <token>] (newest first, { items, pageInfo }; defaults to the caller; admin required for another user)";
+  if (legacyTarget === "list-claims")
+    return "List reimbursable claims with cursor pagination. Same flags as list-bills (--limit 1-100, --cursor, --direction forward|backward); ignores --isClaimable. Returns { items, pageInfo }.";
+  if (legacyTarget === "list-bills")
+    return "List bills with cursor pagination. [--projectId] [--budgetId] [--status CSV] [--search <text>] [--isClaimable true|false] [--createdByIds <csv>] [--sortBy createdAt|amount|status] [--sortDir asc|desc] [--limit 1-100] [--cursor <token>] [--direction forward|backward] Returns { items, pageInfo }; pass nextCursor with --direction forward or previousCursor with --direction backward, keeping the same filters and sort. --page/--pageSize/--perPage are rejected.";
+  if (legacyTarget === "list-customer-invoices")
+    return "List customer invoice batches with cursor pagination. [budgetId] [--projectId <id>] [--companyIds CSV] [--projectIds CSV] [--budgetIds CSV] [--createdByIds CSV] [--status CSV] [--search] [--sortBy createdAt|status|totalInvoiceAmount|approvalExpiresAt] [--sortDir asc|desc] [--limit 1-100] [--cursor <token>] [--direction forward|backward] Returns { items, pageInfo }; follow nextCursor/previousCursor with the same filters and sort. --page/--perPage are rejected. No scope flag lists invoices globally. --projectId uses the project scope. A positional budgetId is a backward-compatible shortcut for --budgetIds.";
+  if (legacyTarget === "list-quotations")
+    return "List quotations with cursor pagination. [--projectId] [--budgetId] [--supplierId] [--status CSV] [--createdBy CSV] [--search] [--limit 1-100] [--cursor <token>] [--direction forward|backward] Newest first; returns { items, pageInfo }. Follow nextCursor/previousCursor with the same filters. --page/--pageSize/--perPage are rejected; --requesterIds remains an alias for --createdBy.";
+  if (legacyTarget === "list-users")
+    return "List users with cursor pagination. [--q] [--limit 1-100] [--cursor <token>] Name A\u2013Z. Returns { items, pageInfo }; follow nextCursor with the same --q. --page/--perPage are rejected.";
+  if (legacyTarget === "list-companies")
+    return "List companies with cursor pagination. Returns { items, pageInfo }; default sort is createdAt descending with limit 20. Pass nextCursor forward or previousCursor backward unchanged. Legacy page/perPage flags are rejected.";
+  if (legacyTarget === "count-companies")
+    return "Count companies independently from list pagination. Returns { totalCount, counts: { active: { true, false } } }; accepts filters only and rejects pagination/sorting flags.";
+  if (legacyTarget === "list-projects")
+    return "List projects with cursor pagination. Returns { items, pageInfo }; default sort is createdAt descending with limit 20. Supports legacy --status plus optional --statuses, WON-date filters (--wonFrom, --wonTo, --wonWithinDays) and --sortBy wonAt; pass nextCursor forward or previousCursor backward unchanged. Legacy page/perPage flags are rejected.";
+  if (legacyTarget === "count-projects")
+    return "Count projects independently from list pagination. Returns { totalCount, counts: { status, active: { true, false } } }; accepts project filters only and rejects pagination/sorting flags.";
   if (legacyTarget === "search-existing-companies")
-    return "Search BB and QuickBooks companies without writes. --query <name> [--page <number>].";
+    return "Search BB and QuickBooks companies without writes. --query <name> [--limit 1-50] [--cursor <token>]. Returns { items, totalCount, pageInfo }; follow pageInfo.nextCursor with the same --query. Legacy --page is rejected.";
   if (legacyTarget === "use-existing-company")
     return "Reuse a company in BB and QuickBooks, creating only its missing counterpart. Supply --companyId <bbId> and/or --quickbooksId <qboId>; both explicitly connect records with different names. --website <url> fills a missing QBO import website only. --confirmDistinct true confirms no similar record represents this entity.";
   if (legacyTarget === "create-company")
     return "Create or reuse a company in BB and QuickBooks. --name <name> --website <url>. Similar names require --confirmDistinct true; inactive companies are never reactivated.";
   if (legacyTarget === "create-project")
     return "Create a project linked to an existing Asana Deals lead task. Supply --asanaTaskId in non-interactive use; interactive use searches for and selects a lead task (optionally --asanaSearch). The Slack channel is resolved from the selected Asana task unless all three Slack channel flags are supplied. For a new direct client, create the lead task using the website form first.";
+  if (legacyTarget === "create-supplier")
+    return "Create a supplier using --payload JSON; pending-approval suppliers also request approval and send emails. Reusing an archived name requires Admin; normal users and Leads must ask an Admin to reactivate it before editing. Recreation preserves the existing approval status and creator.";
   if (legacyTarget === "preview-qbo-customer-invoice") {
     return "Preview an available QuickBooks invoice selected for a BB budget using read-only QBO access. Arguments: <budgetId> <qboInvoiceId>.";
   }
@@ -11243,8 +11380,22 @@ var summaryFor = (legacyTarget) => {
   if (legacyTarget === "whoami")
     return "Show the active API-key identity.";
   if (legacyTarget === "list-budgets") {
-    return "List budgets. Omit --active for active budgets only; use --active false or --active all for Admin-only historical reads.";
-  }
+    return "List one cursor page of budgets ({ items, pageInfo }; --limit/--cursor/--direction). Omit --active for active budgets only; use --active false or --active all for Admin-only historical reads.";
+  }
+  if (legacyTarget === "list-items")
+    return "List one cursor page of catalogue items ({ items, pageInfo }; --limit/--cursor/--direction, optional --sortBy/--sortDir). --page/--perPage are rejected.";
+  if (legacyTarget === "list-item-categories")
+    return "List one cursor page of active item categories ({ items, pageInfo }; --limit/--cursor/--direction, optional --name/--sortBy/--sortDir). --page/--perPage are rejected.";
+  if (legacyTarget === "count-item-categories")
+    return "Count active item categories matching --name: { totalCount }.";
+  if (legacyTarget === "list-integration-operations")
+    return "List one cursor page of integration operations, newest first ({ items, pageInfo }; --limit/--cursor/--direction). --page/--perPage are rejected. Admin only.";
+  if (legacyTarget === "count-integration-operations")
+    return "Count integration operations matching filters: { totalCount, filterOptions }. Admin only.";
+  if (legacyTarget === "count-items")
+    return "Count catalogue items matching filters: total plus category and supplier facets (each ignores its own filter).";
+  if (legacyTarget === "count-budgets")
+    return "Count budgets matching filters: totalCount plus status and active facets. Omit --active for active budgets only.";
   if (legacyTarget === "get-budget") {
     return "Get a budget by ID. Omit --includeInactive for active budgets only; --includeInactive is an Admin-only historical read.";
   }
@@ -11270,6 +11421,8 @@ var summaryFor = (legacyTarget) => {
   if (legacyTarget === "create-quotation") {
     return 'Create a quotation with an approved supplier using --payload JSON. Include projectId, budgetId, supplierId, budgetItemIds, amountWithoutGst, gstAmount, and one uploaded attachment in attachments. Multiple budget items require lineAmounts: [{"budgetItemId":"<first-id>","amount":750},{"budgetItemId":"<second-id>","amount":450}], covering every selected budget-item ID exactly once and summing to amountWithoutGst. Amounts exclude GST; use gstAmount: 0 for no GST. Example: amountWithoutGst: 1200 with line amounts 750 and 450.';
   }
+  if (legacyTarget === "cleanup-staged-quotation-attachments")
+    return "Queue independent cleanup operations for unattached staged quotation uploads; returns operation IDs and queued/skipped counts, not deletion confirmation. Arguments: <projectId> --keys <csv>.";
   if (legacyTarget === "update-quotation") {
     return 'Update a DRAFT or REJECTED quotation using --payload JSON with id and the complete creation payload. Multiple budget items require lineAmounts: [{"budgetItemId":"<first-id>","amount":750},{"budgetItemId":"<second-id>","amount":450}], covering every budgetItemIds entry exactly once and summing to amountWithoutGst. Amounts exclude GST; use gstAmount: 0 for no GST.';
   }
@@ -11279,6 +11432,30 @@ var summaryFor = (legacyTarget) => {
   if (legacyTarget === "send-customer-invoice-to-contact-person") {
     return "Send a customer invoice and update the project billing email.";
   }
+  if (legacyTarget === "update-company")
+    return "Save company fields in BB and queue independent QuickBooks name/website synchronization; returns operation ID, not provider completion.";
+  if (legacyTarget === "get-company-quickbooks-sync-status")
+    return "Read saved company synchronization status without provider calls or polling; use companyId.";
+  if (legacyTarget === "get-item-quickbooks-sync-status")
+    return "Read saved item QuickBooks synchronization status without provider calls or polling; use itemId.";
+  if (legacyTarget === "create-webhook-endpoint")
+    return "Admin-only: subscribe an HTTPS endpoint to BB events. --name --url --events <type|prefix.*|*,...>. Prints the whsec_ signing secret once; deliveries use Standard Webhooks headers.";
+  if (legacyTarget === "rotate-webhook-secret")
+    return "Admin-only: issue a new signing secret; older secrets keep signing for --previousSecretTtlHours (default 24). Prints the new secret once. Argument: <endpointId>.";
+  if (legacyTarget === "send-webhook-test-event")
+    return "Admin-only: send a signed webhook.test event to one endpoint. Argument: <endpointId>.";
+  if (legacyTarget === "replay-webhook-delivery")
+    return "Admin-only: resend a finished webhook delivery with the same eventId on a fresh attempt chain. Argument: <deliveryId>.";
+  if (legacyTarget === "get-webhook-delivery")
+    return "Admin-only: one webhook delivery with payload and attempts (status codes, errors, durations). Argument: <deliveryId>.";
+  if (legacyTarget === "list-webhook-event-types")
+    return "List the outbound webhook event catalogue with group and live/planned status.";
+  if (legacyTarget === "reconcile-resource-operation")
+    return "Admin-only check of a saved QuickBooks invoice/company/item job outcome; reads the provider only when uncertain. Applied changes are finished locally without repeating the provider mutation; provably unapplied ones are queued again. Argument: <operationId>.";
+  if (legacyTarget === "get-integration-operation")
+    return "Admin-only read of one integration job: who queued it, the records it is for with app links, saved QuickBooks progress, admin actions and Retry state. No provider calls. Argument: <operationId>.";
+  if (legacyTarget === "retry-integration-operation")
+    return "Admin-only retry of a failed integration job. QuickBooks jobs with a saved attempt check QuickBooks first: applied changes finish without resending, provably unapplied ones are sent again, unprovable ones stay stopped with the reason. Argument: <operationId>.";
   if (legacyTarget.startsWith("list-")) {
     return `List ${legacyTarget.slice("list-".length).replaceAll("-", " ")}.`;
   }
@@ -11329,6 +11506,24 @@ var registry2 = [
   authCommand("logout", "Revoke the interactive CLI session and remove its local credential."),
   legacyCommand("whoami", ["auth", "whoami"]),
   legacyCommand("list-budgets", ["budget", "list"], [], [
+    {
+      name: "--active <true|false|all>",
+      description: "Omit for active budgets only; false or all requires Admin access."
+    },
+    {
+      name: "--limit <1-100>",
+      description: "Rows per page. Output is { items, pageInfo }."
+    },
+    {
+      name: "--cursor <token>",
+      description: "pageInfo.nextCursor (or previousCursor with --direction backward) from the last page, unchanged; keep the same filters and sort."
+    },
+    {
+      name: "--direction <forward|backward>",
+      description: "forward (default) or backward; backward needs --cursor."
+    }
+  ]),
+  legacyCommand("count-budgets", ["budget", "count"], [], [
     {
       name: "--active <true|false|all>",
       description: "Omit for active budgets only; false or all requires Admin access."
@@ -11354,7 +11549,20 @@ var registry2 = [
       description: "Include inactive historical budgets; Admin only."
     }
   ]),
-  legacyCommand("get-budget-categories", ["budget", "category", "list"]),
+  legacyCommand("get-budget-categories", ["budget", "category", "list"], [], [
+    {
+      name: "--q <text>",
+      description: "Search active category names (name A\u2013Z). A bare --q is rejected; use -q/--quiet to hide logs."
+    },
+    {
+      name: "--limit <1-100>",
+      description: "Rows per page. Output is { items, pageInfo }."
+    },
+    {
+      name: "--cursor <token>",
+      description: "pageInfo.nextCursor from the last page, unchanged; pages forward only."
+    }
+  ]),
   legacyCommand("get-budget-versions", ["budget", "version", "list"], [], [
     {
       name: "--limit <1-50>",
@@ -11414,8 +11622,36 @@ var registry2 = [
     "placeholder-bill",
     "create"
   ]),
-  legacyCommand("list-bills", ["bill", "list"]),
-  legacyCommand("list-claims", ["claim", "list"]),
+  legacyCommand("list-bills", ["bill", "list"], [], [
+    {
+      name: "--limit <1-100>",
+      description: "Rows per page. Output is { items, pageInfo }."
+    },
+    {
+      name: "--cursor <token>",
+      description: "pageInfo.nextCursor (or previousCursor with --direction backward) from the last page, unchanged; keep the same filters and sort."
+    },
+    {
+      name: "--direction <forward|backward>",
+      description: "forward (default) or backward; backward needs --cursor."
+    }
+  ]),
+  legacyCommand("list-claims", ["claim", "list"], [], [
+    {
+      name: "--limit <1-100>",
+      description: "Rows per page. Output is { items, pageInfo }."
+    },
+    {
+      name: "--cursor <token>",
+      description: "pageInfo.nextCursor (or previousCursor with --direction backward) from the last page, unchanged; keep the same filters and sort."
+    },
+    {
+      name: "--direction <forward|backward>",
+      description: "forward (default) or backward; backward needs --cursor."
+    }
+  ]),
+  legacyCommand("count-bills", ["bill", "count"]),
+  legacyCommand("count-claims", ["claim", "count"]),
   legacyCommand("create-bill-approval", ["bill", "approval", "create"]),
   legacyCommand("create-bill", ["bill", "create"], [], [
     {
@@ -11471,7 +11707,16 @@ var registry2 = [
     "invoice-number",
     "patch"
   ]),
-  legacyCommand("get-bill-attachments", ["bill", "attachment", "list"]),
+  legacyCommand("get-bill-attachments", ["bill", "attachment", "list"], [], [
+    {
+      name: "--limit <1-50>",
+      description: "Rows per page. Output is { items, pageInfo }."
+    },
+    {
+      name: "--cursor <token>",
+      description: "pageInfo.nextCursor from the last page, unchanged; pages forward only."
+    }
+  ]),
   legacyCommand("stage-bill-attachment", ["bill", "attachment", "stage"]),
   legacyCommand("cleanup-staged-bill-attachments", [
     "bill",
@@ -11487,7 +11732,21 @@ var registry2 = [
   ]),
   legacyCommand("attach-bill-documents", ["bill", "document", "attach"]),
   legacyCommand("get-bill-details", ["bill", "get"]),
-  legacyCommand("list-quotations", ["quotation", "list"]),
+  legacyCommand("list-quotations", ["quotation", "list"], [], [
+    {
+      name: "--limit <1-100>",
+      description: "Rows per page. Output is { items, pageInfo }."
+    },
+    {
+      name: "--cursor <token>",
+      description: "pageInfo.nextCursor (or previousCursor with --direction backward) from the last page, unchanged; keep the same filters and sort."
+    },
+    {
+      name: "--direction <forward|backward>",
+      description: "forward (default) or backward; backward needs --cursor."
+    }
+  ]),
+  legacyCommand("count-quotations", ["quotation", "count"]),
   legacyCommand("get-quotation", ["quotation", "get"]),
   legacyCommand("upload-quotation-attachment", [
     "quotation",
@@ -11539,7 +11798,21 @@ var registry2 = [
     "existing",
     "list"
   ]),
-  legacyCommand("list-customer-invoices", ["customer-invoice", "list"]),
+  legacyCommand("list-customer-invoices", ["customer-invoice", "list"], [], [
+    {
+      name: "--limit <1-100>",
+      description: "Rows per page. Output is { items, pageInfo }."
+    },
+    {
+      name: "--cursor <token>",
+      description: "pageInfo.nextCursor (or previousCursor with --direction backward) from the last page, unchanged; keep the same filters and sort."
+    },
+    {
+      name: "--direction <forward|backward>",
+      description: "forward (default) or backward; backward needs --cursor."
+    }
+  ]),
+  legacyCommand("count-customer-invoices", ["customer-invoice", "count"]),
   legacyCommand("get-customer-invoice", ["customer-invoice", "get"]),
   legacyCommand("get-customer-invoice-email-context", [
     "customer-invoice",
@@ -11578,7 +11851,62 @@ var registry2 = [
   legacyCommand("approve-supplier", ["supplier", "approve"]),
   legacyCommand("reject-supplier", ["supplier", "reject"]),
   legacyCommand("get-supplier-details", ["supplier", "detail", "get"]),
-  legacyCommand("list-companies", ["company", "list"]),
+  legacyCommand("list-companies", ["company", "list"], [], [
+    {
+      name: "--name <text>",
+      description: "Filter by company name substring."
+    },
+    {
+      name: "--createdBy <userId>",
+      description: "Filter by one creator user ID."
+    },
+    {
+      name: "--createdByIds <csv>",
+      description: "Filter by a comma-separated creator user ID list."
+    },
+    {
+      name: "--active <true|false>",
+      description: "Filter by active status; omit to include both states."
+    },
+    {
+      name: "--sortBy <name|createdAt>",
+      description: "Sort field (default createdAt)."
+    },
+    {
+      name: "--sortDir <asc|desc>",
+      description: "Sort direction (default desc)."
+    },
+    {
+      name: "--limit <1-100>",
+      description: "Bounded page size (default 20)."
+    },
+    {
+      name: "--cursor <token>",
+      description: "Opaque pageInfo cursor; pass nextCursor forward or previousCursor backward unchanged."
+    },
+    {
+      name: "--direction <forward|backward>",
+      description: "Use forward by default; backward requires --cursor."
+    }
+  ]),
+  legacyCommand("count-companies", ["company", "count"], [], [
+    {
+      name: "--name <text>",
+      description: "Filter by company name substring."
+    },
+    {
+      name: "--createdBy <userId>",
+      description: "Filter by one creator user ID."
+    },
+    {
+      name: "--createdByIds <csv>",
+      description: "Filter by a comma-separated creator user ID list."
+    },
+    {
+      name: "--active <true|false>",
+      description: "Filter by active status; facets omit this self-filter."
+    }
+  ]),
   legacyCommand("get-company", ["company", "get"]),
   legacyCommand("search-existing-companies", ["company", "search"], [], [
     {
@@ -11586,8 +11914,12 @@ var registry2 = [
       description: "Company name to search in BB and QuickBooks."
     },
     {
-      name: "--page",
-      description: "Results page (eight companies per page)."
+      name: "--limit",
+      description: "Matches per page, 1\u201350 (default 8)."
+    },
+    {
+      name: "--cursor",
+      description: "pageInfo.nextCursor from the previous page, unchanged."
     }
   ]),
   legacyCommand("use-existing-company", ["company", "use"], [], [
@@ -11615,8 +11947,94 @@ var registry2 = [
     }
   ]),
   legacyCommand("update-company", ["company", "update"]),
+  legacyCommand("get-company-quickbooks-sync-status", [
+    "company",
+    "sync",
+    "status"
+  ]),
   legacyCommand("delete-company", ["company", "delete"]),
-  legacyCommand("list-projects", ["project", "list"]),
+  legacyCommand("list-projects", ["project", "list"], [], [
+    { name: "--companyId <id>", description: "Filter by company ID." },
+    {
+      name: "--name <text>",
+      description: "Filter by project name substring."
+    },
+    {
+      name: "--status <status|ALL>",
+      description: "Legacy single-status filter; use --statuses for multiple statuses."
+    },
+    {
+      name: "--statuses <csv>",
+      description: "Filter by a comma-separated project status list."
+    },
+    {
+      name: "--active <true|false>",
+      description: "Filter by active status; omit to include both states."
+    },
+    {
+      name: "--wonFrom <iso>",
+      description: "Only projects marked WON on or after this ISO date or datetime (UTC)."
+    },
+    {
+      name: "--wonTo <iso>",
+      description: "Only projects marked WON on or before this ISO date (inclusive) or datetime (UTC)."
+    },
+    {
+      name: "--wonWithinDays <1-3650>",
+      description: "Only projects marked WON in the last N days."
+    },
+    {
+      name: "--limit <1-100>",
+      description: "Bounded page size (default 20)."
+    },
+    {
+      name: "--cursor <token>",
+      description: "Opaque pageInfo cursor; pass nextCursor forward or previousCursor backward unchanged."
+    },
+    {
+      name: "--direction <forward|backward>",
+      description: "Use forward by default; backward requires --cursor."
+    },
+    {
+      name: "--sortBy <name|createdAt|status|companyName|wonAt>",
+      description: "Sort field (default createdAt); wonAt puts unwon projects last."
+    },
+    {
+      name: "--sortDir <asc|desc>",
+      description: "Sort direction (default desc)."
+    }
+  ]),
+  legacyCommand("count-projects", ["project", "count"], [], [
+    { name: "--companyId <id>", description: "Filter by company ID." },
+    {
+      name: "--name <text>",
+      description: "Filter by project name substring."
+    },
+    {
+      name: "--status <status|ALL>",
+      description: "Legacy single-status filter."
+    },
+    {
+      name: "--statuses <csv>",
+      description: "Filter by a comma-separated project status list."
+    },
+    {
+      name: "--active <true|false>",
+      description: "Filter by active status; facets exclude this self-filter."
+    },
+    {
+      name: "--wonFrom <iso>",
+      description: "Only projects marked WON on or after this ISO date or datetime (UTC)."
+    },
+    {
+      name: "--wonTo <iso>",
+      description: "Only projects marked WON on or before this ISO date (inclusive) or datetime (UTC)."
+    },
+    {
+      name: "--wonWithinDays <1-3650>",
+      description: "Only projects marked WON in the last N days."
+    }
+  ]),
   legacyCommand("list-project-hubs", ["project", "hub", "list"], [], [
     {
       name: "--q",
@@ -11626,14 +12044,31 @@ var registry2 = [
       name: "--status",
       description: "Filter by comma-separated project statuses."
     },
-    { name: "--page", description: "Select a results page." },
-    { name: "--perPage", description: "Set the results page size." },
+    { name: "--limit", description: "Page size, 1-100 (default 20)." },
+    {
+      name: "--cursor",
+      description: "Opaque nextCursor/previousCursor from the last page."
+    },
+    {
+      name: "--direction",
+      description: "forward (default) or backward; backward needs --cursor."
+    },
     {
       name: "--sortBy",
       description: "Sort by startDate, name, companyName, or status."
     },
     { name: "--sortDir", description: "Sort in asc or desc order." }
   ]),
+  legacyCommand("count-project-hubs", ["project", "hub", "count"], [], [
+    {
+      name: "--q",
+      description: "Search project and company names."
+    },
+    {
+      name: "--status",
+      description: "Filter by comma-separated project statuses."
+    }
+  ]),
   legacyCommand("get-project", ["project", "get"]),
   legacyCommand("get-project-hub-status", ["project", "hub", "status"]),
   legacyCommand("setup-project-hub", ["project", "hub", "setup"]),
@@ -11657,7 +12092,67 @@ var registry2 = [
   legacyCommand("list-contacts", ["contact", "list"]),
   legacyCommand("create-contact-person", ["contact", "create"]),
   legacyCommand("update-contact-person", ["contact", "update"]),
-  legacyCommand("list-suppliers", ["supplier", "list"]),
+  legacyCommand("list-suppliers", ["supplier", "list"], [], [
+    { name: "--name <text>", description: "Filter supplier name or email." },
+    { name: "--createdBy <csv>", description: "Filter by creator IDs." },
+    {
+      name: "--gstRegistered <true|false>",
+      description: "Filter GST registration."
+    },
+    {
+      name: "--status <csv>",
+      description: "Filter approval statuses; ALL means no status filter."
+    },
+    {
+      name: "--supplierTags <csv>",
+      description: "Filter by supplier tag IDs."
+    },
+    {
+      name: "--active <true|false>",
+      description: "Active by default; false selects archived."
+    },
+    {
+      name: "--limit <1-100>",
+      description: "Bounded page size (default 10). Retired page/perPage flags are rejected."
+    },
+    {
+      name: "--cursor <token>",
+      description: "Opaque nextCursor or previousCursor from items/pageInfo."
+    },
+    {
+      name: "--direction <forward|backward>",
+      description: "Forward by default; backward requires a cursor."
+    },
+    {
+      name: "--sortBy <field>",
+      description: "name, email, phone, gstRegistered, status, active, createdAt or updatedAt."
+    },
+    {
+      name: "--sortDir <asc|desc>",
+      description: "Descending createdAt by default."
+    },
+    {
+      name: "--sort <json>",
+      description: "Ordered {id,desc} array for multi-column sorting; cannot combine with sortBy/sortDir."
+    }
+  ]),
+  legacyCommand("count-suppliers", ["supplier", "count"], [], [
+    { name: "--name <text>", description: "Filter supplier name or email." },
+    { name: "--createdBy <csv>", description: "Filter by creator IDs." },
+    {
+      name: "--gstRegistered <true|false>",
+      description: "Filter GST registration."
+    },
+    { name: "--status <csv>", description: "Filter approval statuses." },
+    {
+      name: "--supplierTags <csv>",
+      description: "Filter by supplier tag IDs."
+    },
+    {
+      name: "--active <true|false>",
+      description: "Active by default; false selects archived. No pagination/sort flags."
+    }
+  ]),
   legacyCommand("create-supplier", ["supplier", "create"]),
   legacyCommand("update-supplier", ["supplier", "update"]),
   legacyCommand("delete-suppliers", ["supplier", "delete"]),
@@ -11674,21 +12169,87 @@ var registry2 = [
   ]),
   legacyCommand("create-supplier-role", ["supplier", "role", "create"]),
   legacyCommand("create-supplier-tag", ["supplier", "tag", "create"]),
-  legacyCommand("get-supplier-analytics", ["supplier", "analytics", "get"]),
-  legacyCommand("list-items", ["item", "list"]),
+  legacyCommand("get-supplier-analytics", ["supplier", "analytics", "get"], [], [
+    {
+      name: "--limit <1-100>",
+      description: "Rows per page. Output is { items, pageInfo }."
+    },
+    {
+      name: "--cursor <token>",
+      description: "pageInfo.nextCursor (or previousCursor with --direction backward) from the last page, unchanged; keep the same filters and sort."
+    },
+    {
+      name: "--direction <forward|backward>",
+      description: "forward (default) or backward; backward needs --cursor."
+    }
+  ]),
+  legacyCommand("count-supplier-analytics", ["supplier", "analytics", "count"]),
+  legacyCommand("list-items", ["item", "list"], [], [
+    {
+      name: "--limit <1-100>",
+      description: "Rows per page. Output is { items, pageInfo }."
+    },
+    {
+      name: "--cursor <token>",
+      description: "pageInfo.nextCursor (or previousCursor with --direction backward) from the last page, unchanged; keep the same filters and sort."
+    },
+    {
+      name: "--direction <forward|backward>",
+      description: "forward (default) or backward; backward needs --cursor."
+    }
+  ]),
+  legacyCommand("count-items", ["item", "count"]),
   legacyCommand("get-item", ["item", "get"]),
+  legacyCommand("get-item-quickbooks-sync-status", ["item", "sync", "status"]),
   legacyCommand("create-item", ["item", "create"]),
   legacyCommand("update-item", ["item", "update"]),
   legacyCommand("archive-items", ["item", "archive"]),
   legacyCommand("delete-item", ["item", "delete"]),
-  legacyCommand("list-item-categories", ["item", "category", "list"]),
+  legacyCommand("list-item-categories", ["item", "category", "list"], [], [
+    {
+      name: "--limit <1-100>",
+      description: "Rows per page. Output is { items, pageInfo }."
+    },
+    {
+      name: "--cursor <token>",
+      description: "pageInfo.nextCursor (or previousCursor with --direction backward) from the last page, unchanged; keep the same filters and sort."
+    },
+    {
+      name: "--direction <forward|backward>",
+      description: "forward (default) or backward; backward needs --cursor."
+    }
+  ]),
+  legacyCommand("count-item-categories", ["item", "category", "count"]),
   legacyCommand("create-item-category", ["item", "category", "create"]),
   legacyCommand("update-item-category", ["item", "category", "update"]),
   legacyCommand("delete-item-categories", ["item", "category", "delete"]),
-  legacyCommand("list-users", ["user", "list"]),
+  legacyCommand("list-users", ["user", "list"], [], [
+    {
+      name: "--q <text>",
+      description: "Search user names and emails (name A\u2013Z). A bare --q is rejected; use -q/--quiet to hide logs."
+    },
+    {
+      name: "--limit <1-100>",
+      description: "Rows per page. Output is { items, pageInfo }."
+    },
+    {
+      name: "--cursor <token>",
+      description: "pageInfo.nextCursor from the last page, unchanged; pages forward only."
+    }
+  ]),
+  legacyCommand("count-users", ["user", "count"]),
   legacyCommand("create-user", ["user", "create"]),
   legacyCommand("create-api-key", ["user", "api-key", "create"]),
-  legacyCommand("list-api-keys", ["user", "api-key", "list"]),
+  legacyCommand("list-api-keys", ["user", "api-key", "list"], [], [
+    {
+      name: "--limit <1-100>",
+      description: "Rows per page. Output is { items, pageInfo }."
+    },
+    {
+      name: "--cursor <token>",
+      description: "pageInfo.nextCursor from the last page, unchanged; pages forward only."
+    }
+  ]),
   legacyCommand("revoke-api-key", ["user", "api-key", "revoke"]),
   legacyCommand("get-user-performance", ["user", "performance", "get"]),
   legacyCommand("get-dashboard", ["dashboard", "get"]),
@@ -11704,23 +12265,143 @@ var registry2 = [
     "financial-overview",
     "get"
   ]),
-  legacyCommand("get-recent-errors", ["error", "recent", "list"]),
+  legacyCommand("get-recent-errors", ["error", "recent", "list"], [], [
+    {
+      name: "--cursor <token>",
+      description: "Pass a returned pageInfo boundary unchanged, with the same filters."
+    },
+    {
+      name: "--direction <direction>",
+      description: "forward (default) uses nextCursor; backward uses previousCursor."
+    },
+    {
+      name: "--limit <number>",
+      description: "1\u2013100 rows (default 10). Returns items and pageInfo, without a total."
+    },
+    { name: "--severity <severity>", description: "Error severity or ALL." },
+    { name: "--status <status>", description: "Error status or ALL." },
+    {
+      name: "--timeFrame <period>",
+      description: "all_time (default), last_30_days, last_3_months, last_6_months or last_1_year."
+    }
+  ]),
+  legacyCommand("count-errors", ["error", "recent", "count"], [], [
+    { name: "--severity <severity>", description: "Error severity or ALL." },
+    { name: "--status <status>", description: "Error status or ALL." },
+    {
+      name: "--timeFrame <period>",
+      description: "Same filters as error recent list; returns independent totalCount."
+    }
+  ]),
   legacyCommand("get-error-metrics", ["error", "metrics", "get"]),
-  legacyCommand("list-integration-operations", [
+  legacyCommand("list-integration-operations", ["integration", "operation", "list"], [], [
+    {
+      name: "--limit <1-100>",
+      description: "Rows per page. Output is { items, pageInfo }."
+    },
+    {
+      name: "--cursor <token>",
+      description: "pageInfo.nextCursor (or previousCursor with --direction backward) from the last page, unchanged; keep the same filters and sort."
+    },
+    {
+      name: "--direction <forward|backward>",
+      description: "forward (default) or backward; backward needs --cursor."
+    }
+  ]),
+  legacyCommand("count-integration-operations", [
     "integration",
     "operation",
-    "list"
+    "count"
+  ]),
+  legacyCommand("get-integration-operation", [
+    "integration",
+    "operation",
+    "get"
   ]),
   legacyCommand("retry-integration-operation", [
     "integration",
     "operation",
     "retry"
   ]),
-  legacyCommand("list-inbound-sources", ["inbound", "source", "list"]),
+  legacyCommand("reconcile-resource-operation", [
+    "integration",
+    "operation",
+    "reconcile-resource"
+  ]),
+  legacyCommand("list-webhook-event-types", ["webhook", "event-type", "list"]),
+  legacyCommand("list-webhook-endpoints", ["webhook", "endpoint", "list"]),
+  legacyCommand("get-webhook-endpoint", ["webhook", "endpoint", "get"]),
+  legacyCommand("create-webhook-endpoint", ["webhook", "endpoint", "create"]),
+  legacyCommand("update-webhook-endpoint", ["webhook", "endpoint", "update"]),
+  legacyCommand("delete-webhook-endpoint", ["webhook", "endpoint", "delete"]),
+  legacyCommand("rotate-webhook-secret", ["webhook", "secret", "rotate"]),
+  legacyCommand("send-webhook-test-event", ["webhook", "endpoint", "test"]),
+  legacyCommand("list-webhook-deliveries", ["webhook", "delivery", "list"]),
+  legacyCommand("get-webhook-delivery", ["webhook", "delivery", "get"]),
+  legacyCommand("replay-webhook-delivery", ["webhook", "delivery", "replay"]),
+  legacyCommand("list-inbound-sources", ["inbound", "source", "list"], [], [
+    {
+      name: "--limit <n>",
+      description: "Rows per cursor page (1..100; default 25)."
+    },
+    {
+      name: "--cursor <token>",
+      description: "Opaque source continuation token returned by pageInfo."
+    },
+    {
+      name: "--direction <value>",
+      description: "forward or backward (default forward; backward requires cursor)."
+    },
+    {
+      name: "--search <text>",
+      description: "Search source name or Typeform form ID."
+    },
+    {
+      name: "--processingEnabled <boolean>",
+      description: "Filter processing enabled state."
+    },
+    {
+      name: "--processingMode <mode>",
+      description: "ACTIVE, COLLECT_ONLY or SHADOW."
+    }
+  ]),
+  legacyCommand("count-inbound-sources", ["inbound", "source", "count"], [], [
+    {
+      name: "--search <text>",
+      description: "Search source name or Typeform form ID."
+    },
+    {
+      name: "--processingEnabled <boolean>",
+      description: "Filter processing enabled state."
+    },
+    {
+      name: "--processingMode <mode>",
+      description: "ACTIVE, COLLECT_ONLY or SHADOW."
+    }
+  ]),
   legacyCommand("create-inbound-source", ["inbound", "source", "create"]),
   legacyCommand("get-inbound-source", ["inbound", "source", "get"]),
   legacyCommand("update-inbound-source", ["inbound", "source", "update"]),
-  legacyCommand("list-inbound-submissions", ["inbound", "submission", "list"]),
+  legacyCommand("list-inbound-submissions", ["inbound", "submission", "list"], [], [
+    {
+      name: "--limit <number>",
+      description: "Page size from 1 to 100 (default 25). Returns submissions, hasMore and nextCursor; no total."
+    },
+    {
+      name: "--cursor <token>",
+      description: "Pass the previous response's nextCursor unchanged. Omit for newest submissions. Replaces --page/--perPage."
+    },
+    {
+      name: "--sourceId <id>",
+      description: "Filter submissions to this source; keep the same filter while following cursors."
+    }
+  ]),
+  legacyCommand("count-inbound-submissions", ["inbound", "submission", "count"], [], [
+    {
+      name: "--sourceId <id>",
+      description: "Optional source filter. Returns an independently calculated exact totalCount, not a list snapshot."
+    }
+  ]),
   legacyCommand("get-inbound-submission", ["inbound", "submission", "get"]),
   legacyCommand("save-inbound-mapping", ["inbound", "mapping", "save"]),
   legacyCommand("save-inbound-automation-config", [
@@ -11862,48 +12543,323 @@ var completionWords = () => {
   words.add("completion");
   return [...words].sort();
 };
-var createCompletionScript = (shell) => {
-  const words = completionWords().join(" ");
-  switch (shell) {
-    case "bash":
-      return `# bash completion for bb
-_bb() {
-  COMPREPLY=( $(compgen -W '${words}' -- "${"$"}{COMP_WORDS[COMP_CWORD]}") )
-}
-complete -F _bb bb
-`;
-    case "zsh":
-      return `#compdef bb
-_bb() {
-  local -a commands
-  commands=(${words})
-  _describe 'bb command' commands
-}
-compdef _bb bb
-`;
-    case "fish":
-      return completionWords().map((word) => `complete -c bb -f -a '${word}'`).join(`
-`).concat(`
-`);
-    case "powershell":
-      return `Register-ArgumentCompleter -Native -CommandName bb -ScriptBlock {
-  param($wordToComplete)
-  '${words}'.Split(' ') | Where-Object { $_ -like "$wordToComplete*" }
-}
-`;
+var createCompletionScript = (shell) => {
+  const words = completionWords().join(" ");
+  switch (shell) {
+    case "bash":
+      return `# bash completion for bb
+_bb() {
+  COMPREPLY=( $(compgen -W '${words}' -- "${"$"}{COMP_WORDS[COMP_CWORD]}") )
+}
+complete -F _bb bb
+`;
+    case "zsh":
+      return `#compdef bb
+_bb() {
+  local -a commands
+  commands=(${words})
+  _describe 'bb command' commands
+}
+compdef _bb bb
+`;
+    case "fish":
+      return completionWords().map((word) => `complete -c bb -f -a '${word}'`).join(`
+`).concat(`
+`);
+    case "powershell":
+      return `Register-ArgumentCompleter -Native -CommandName bb -ScriptBlock {
+  param($wordToComplete)
+  '${words}'.Split(' ') | Where-Object { $_ -like "$wordToComplete*" }
+}
+`;
+  }
+};
+
+// src/cli.ts
+var SUPPLIER_ANALYTICS_SORT_IDS = [
+  "name",
+  "gstRegistered",
+  "status",
+  "phone",
+  "email",
+  "updatedAt",
+  "createdAt"
+];
+function parsePositiveIntFlag(value, flagName) {
+  if (value === undefined)
+    return;
+  const parsed = Number.parseInt(String(value), 10);
+  if (!Number.isFinite(parsed) || parsed <= 0) {
+    throw new Error(`${flagName} must be a positive integer.`);
+  }
+  return parsed;
+}
+var COMPANY_SORT_FIELDS = ["name", "createdAt"];
+var COMPANY_SORT_DIRECTIONS = ["asc", "desc"];
+var COMPANY_PAGE_FLAGS = [
+  "page",
+  "perPage",
+  "pageSize",
+  "page-size",
+  "per-page",
+  "page_size",
+  "per_page"
+];
+var rejectBareFlag = (flags, key) => {
+  if (flags[key] === true) {
+    throw new Error(`--${key} requires a value.`);
+  }
+};
+var rejectCompanyPageFlags = (flags, command) => {
+  for (const key of COMPANY_PAGE_FLAGS) {
+    if (flags[key] !== undefined) {
+      throw new Error(`--${key} is not supported by company ${command}; use --limit and --cursor for list or company count for totals.`);
+    }
+  }
+};
+var parseCompanyLimit = (value) => {
+  if (value === undefined)
+    return 20;
+  const parsed = Number(String(value));
+  if (!Number.isInteger(parsed) || parsed < 1 || parsed > 100) {
+    throw new Error("--limit must be an integer from 1 to 100.");
+  }
+  return parsed;
+};
+var parseCompanySortBy = (value) => {
+  if (value === undefined)
+    return "createdAt";
+  if (!COMPANY_SORT_FIELDS.includes(value)) {
+    throw new Error(`Invalid --sortBy "${value}". Use one of: ${COMPANY_SORT_FIELDS.join(", ")}.`);
+  }
+  return value;
+};
+var parseCompanySortDir = (value) => {
+  if (value === undefined)
+    return "desc";
+  if (!COMPANY_SORT_DIRECTIONS.includes(value)) {
+    throw new Error(`Invalid --sortDir "${value}". Use one of: ${COMPANY_SORT_DIRECTIONS.join(", ")}.`);
+  }
+  return value;
+};
+var parseCompanyDirection = (value) => {
+  if (value === undefined)
+    return "forward";
+  if (value !== "forward" && value !== "backward") {
+    throw new Error('--direction must be "forward" or "backward".');
+  }
+  return value;
+};
+var parseCompanyListFlags = (flags) => {
+  rejectCompanyPageFlags(flags, "list");
+  for (const key of [
+    "name",
+    "createdBy",
+    "createdByIds",
+    "active",
+    "limit",
+    "cursor",
+    "direction",
+    "sortBy",
+    "sortDir"
+  ]) {
+    rejectBareFlag(flags, key);
+  }
+  const cursor = getFlag(flags, "cursor");
+  const direction = parseCompanyDirection(getFlag(flags, "direction"));
+  if (direction === "backward" && cursor === undefined) {
+    throw new Error("--direction backward requires --cursor <token>.");
+  }
+  if (cursor === "")
+    throw new Error("--cursor requires a non-empty token.");
+  return {
+    name: getFlag(flags, "name"),
+    createdBy: getFlag(flags, "createdBy"),
+    createdByIds: parseCommaSeparatedIds(getFlag(flags, "createdByIds")),
+    active: parseOptionalBoolFlag(flags, "active"),
+    limit: parseCompanyLimit(getFlag(flags, "limit")),
+    cursor,
+    direction,
+    sortBy: parseCompanySortBy(getFlag(flags, "sortBy")),
+    sortDir: parseCompanySortDir(getFlag(flags, "sortDir"))
+  };
+};
+var parseCompanyCountFlags = (flags) => {
+  rejectCompanyPageFlags(flags, "count");
+  for (const key of [
+    "name",
+    "createdBy",
+    "createdByIds",
+    "active",
+    "limit",
+    "cursor",
+    "direction",
+    "sortBy",
+    "sortDir"
+  ]) {
+    rejectBareFlag(flags, key);
+  }
+  if (flags.limit !== undefined || flags.cursor !== undefined || flags.direction !== undefined) {
+    throw new Error("company count does not accept list pagination flags.");
+  }
+  if (flags.sortBy !== undefined || flags.sortDir !== undefined) {
+    throw new Error("company count does not accept list sorting flags.");
+  }
+  return {
+    name: getFlag(flags, "name"),
+    createdBy: getFlag(flags, "createdBy"),
+    createdByIds: parseCommaSeparatedIds(getFlag(flags, "createdByIds")),
+    active: parseOptionalBoolFlag(flags, "active")
+  };
+};
+var PROJECT_SORT_FIELDS = [
+  "name",
+  "createdAt",
+  "status",
+  "companyName",
+  "wonAt"
+];
+var PROJECT_SORT_DIRECTIONS = ["asc", "desc"];
+var PROJECT_PAGE_FLAGS = [
+  "page",
+  "perPage",
+  "pageSize",
+  "page-size",
+  "per-page",
+  "page_size",
+  "per_page"
+];
+var rejectProjectPageFlags = (flags, command) => {
+  for (const key of PROJECT_PAGE_FLAGS) {
+    if (flags[key] !== undefined) {
+      throw new Error(`--${key} is not supported by project ${command}; use --limit and --cursor for list or project count for totals.`);
+    }
+  }
+};
+var parseProjectLimit = (value) => {
+  if (value === undefined)
+    return 20;
+  const parsed = Number(String(value));
+  if (!Number.isInteger(parsed) || parsed < 1 || parsed > 100) {
+    throw new Error("--limit must be an integer from 1 to 100.");
+  }
+  return parsed;
+};
+var parseProjectSortBy = (value) => {
+  if (value === undefined)
+    return "createdAt";
+  if (!PROJECT_SORT_FIELDS.includes(value)) {
+    throw new Error(`Invalid --sortBy "${value}". Use one of: ${PROJECT_SORT_FIELDS.join(", ")}.`);
+  }
+  return value;
+};
+var parseProjectSortDir = (value) => {
+  if (value === undefined)
+    return "desc";
+  if (!PROJECT_SORT_DIRECTIONS.includes(value)) {
+    throw new Error(`Invalid --sortDir "${value}". Use one of: ${PROJECT_SORT_DIRECTIONS.join(", ")}.`);
   }
+  return value;
 };
-
-// src/cli.ts
-function parsePositiveIntFlag(value, flagName) {
+var parseProjectWonWithinDays = (value) => {
   if (value === undefined)
     return;
-  const parsed = Number.parseInt(String(value), 10);
-  if (!Number.isFinite(parsed) || parsed <= 0) {
-    throw new Error(`${flagName} must be a positive integer.`);
+  const parsed = Number(value);
+  if (!Number.isInteger(parsed) || parsed < 1 || parsed > 3650) {
+    throw new Error("--wonWithinDays must be an integer from 1 to 3650.");
   }
   return parsed;
-}
+};
+var parseProjectDirection = (value) => {
+  if (value === undefined)
+    return "forward";
+  if (value !== "forward" && value !== "backward") {
+    throw new Error('--direction must be "forward" or "backward".');
+  }
+  return value;
+};
+var parseProjectListFlags = (flags) => {
+  rejectProjectPageFlags(flags, "list");
+  for (const key of [
+    "companyId",
+    "name",
+    "status",
+    "statuses",
+    "active",
+    "wonFrom",
+    "wonTo",
+    "wonWithinDays",
+    "limit",
+    "cursor",
+    "direction",
+    "sortBy",
+    "sortDir"
+  ]) {
+    rejectBareFlag(flags, key);
+  }
+  const cursor = getFlag(flags, "cursor");
+  const direction = parseProjectDirection(getFlag(flags, "direction"));
+  if (direction === "backward" && cursor === undefined) {
+    throw new Error("--direction backward requires --cursor <token>.");
+  }
+  if (cursor === "")
+    throw new Error("--cursor requires a non-empty token.");
+  return {
+    companyId: getFlag(flags, "companyId"),
+    name: getFlag(flags, "name"),
+    status: parseOptionalExtendedProjectStatus(getFlag(flags, "status")),
+    statuses: parseCommaSeparatedProjectStatuses(getFlag(flags, "statuses")),
+    active: parseOptionalBoolFlag(flags, "active"),
+    wonFrom: parseOptionalIsoDateFlag(getFlag(flags, "wonFrom"), "--wonFrom"),
+    wonTo: parseOptionalIsoDateFlag(getFlag(flags, "wonTo"), "--wonTo", {
+      endOfDay: true
+    }),
+    wonWithinDays: parseProjectWonWithinDays(getFlag(flags, "wonWithinDays")),
+    limit: parseProjectLimit(getFlag(flags, "limit")),
+    cursor,
+    direction,
+    sortBy: parseProjectSortBy(getFlag(flags, "sortBy")),
+    sortDir: parseProjectSortDir(getFlag(flags, "sortDir"))
+  };
+};
+var parseProjectCountFlags = (flags) => {
+  rejectProjectPageFlags(flags, "count");
+  for (const key of [
+    "companyId",
+    "name",
+    "status",
+    "statuses",
+    "active",
+    "wonFrom",
+    "wonTo",
+    "wonWithinDays",
+    "limit",
+    "cursor",
+    "direction",
+    "sortBy",
+    "sortDir"
+  ]) {
+    rejectBareFlag(flags, key);
+  }
+  if (flags.limit !== undefined || flags.cursor !== undefined || flags.direction !== undefined) {
+    throw new Error("project count does not accept list pagination flags.");
+  }
+  if (flags.sortBy !== undefined || flags.sortDir !== undefined) {
+    throw new Error("project count does not accept list sorting flags.");
+  }
+  return {
+    companyId: getFlag(flags, "companyId"),
+    name: getFlag(flags, "name"),
+    status: parseOptionalExtendedProjectStatus(getFlag(flags, "status")),
+    statuses: parseCommaSeparatedProjectStatuses(getFlag(flags, "statuses")),
+    active: parseOptionalBoolFlag(flags, "active"),
+    wonFrom: parseOptionalIsoDateFlag(getFlag(flags, "wonFrom"), "--wonFrom"),
+    wonTo: parseOptionalIsoDateFlag(getFlag(flags, "wonTo"), "--wonTo", {
+      endOfDay: true
+    }),
+    wonWithinDays: parseProjectWonWithinDays(getFlag(flags, "wonWithinDays"))
+  };
+};
 function parseOptionalBoolFlag(flags, key) {
   const v = flags[key];
   if (v === undefined || v === true)
@@ -11954,28 +12910,72 @@ function parseCommercialRejectionProjectStatus(flags) {
     throw new Error("--projectStatusOnCommercialRejection requires PITCH or LOST.");
   }
   const status = String(raw).toUpperCase();
-  if (status === ProjectStatus.PITCH || status === ProjectStatus.LOST) {
+  if (status === ProjectStatus2.PITCH || status === ProjectStatus2.LOST) {
     return status;
   }
   throw new Error("--projectStatusOnCommercialRejection must be PITCH or LOST.");
 }
-function parseListBillsFlags(flags) {
+var rejectRetiredPageFlags = (flags) => {
+  for (const key of PROJECT_PAGE_FLAGS) {
+    if (flags[key] !== undefined)
+      throw new Error(`--${key} is retired; use --limit/--cursor, or the matching count command for totals.`);
+  }
+};
+var parseBillFilterFlags = (flags) => {
   const statusRaw = getFlag(flags, "status");
   const createdByIdsRaw = getFlag(flags, "createdByIds");
   const searchRaw = getFlag(flags, "search");
-  const sortByRaw = getFlag(flags, "sortBy");
-  const sortDirRaw = getFlag(flags, "sortDir");
   return {
     projectId: getFlag(flags, "projectId"),
     budgetId: getFlag(flags, "budgetId"),
     statuses: parseCommaSeparatedBillStatuses(statusRaw !== undefined ? String(statusRaw) : undefined),
     search: searchRaw !== undefined ? String(searchRaw) : undefined,
     isClaimable: parseOptionalBoolFlag(flags, "isClaimable"),
-    createdByIds: parseCommaSeparatedIds(createdByIdsRaw !== undefined ? String(createdByIdsRaw) : undefined),
+    createdByIds: parseCommaSeparatedIds(createdByIdsRaw !== undefined ? String(createdByIdsRaw) : undefined)
+  };
+};
+var parseQuotationFilterFlags = (flags) => {
+  const createdByRaw = getFlag(flags, "createdBy") ?? getFlag(flags, "requesterIds");
+  const searchRaw = getFlag(flags, "search");
+  return {
+    projectId: getFlag(flags, "projectId"),
+    budgetId: getFlag(flags, "budgetId"),
+    supplierId: getFlag(flags, "supplierId"),
+    status: parseCommaSeparatedQuotationStatuses(getFlag(flags, "status")),
+    createdBy: parseCommaSeparatedIds(createdByRaw),
+    search: searchRaw !== undefined ? String(searchRaw).trim() || undefined : undefined
+  };
+};
+function parseListBillsFlags(flags) {
+  rejectRetiredPageFlags(flags);
+  for (const key of ["limit", "cursor", "direction", "sortBy", "sortDir"])
+    rejectBareFlag(flags, key);
+  const sortByRaw = getFlag(flags, "sortBy");
+  const sortDirRaw = getFlag(flags, "sortDir");
+  const cursor = getFlag(flags, "cursor");
+  if (cursor === "" || (cursor?.length ?? 0) > 8192)
+    throw new Error("--cursor must be a non-empty opaque token of at most 8192 characters.");
+  const direction = parseProjectDirection(getFlag(flags, "direction"));
+  if (direction === "backward" && !cursor)
+    throw new Error("--direction backward requires --cursor <token>.");
+  return {
+    ...parseBillFilterFlags(flags),
     sortBy: parseOptionalBillListSortBy(sortByRaw !== undefined ? String(sortByRaw) : undefined),
     sortDir: parseOptionalBillListSortDir(sortDirRaw !== undefined ? String(sortDirRaw) : undefined),
-    page: parsePositiveIntFlag(getFlag(flags, "page"), "--page"),
-    pageSize: parsePositiveIntFlag(getFlag(flags, "pageSize"), "--pageSize")
+    limit: parseProjectLimit(getFlag(flags, "limit")),
+    cursor,
+    direction
+  };
+}
+function parseCountBillsFlags(flags) {
+  rejectRetiredPageFlags(flags);
+  for (const key of ["limit", "cursor", "direction", "sortBy", "sortDir"]) {
+    if (flags[key] !== undefined)
+      throw new Error(`bill count does not accept --${key}; totals use filters only.`);
+  }
+  return {
+    ...parseBillFilterFlags(flags),
+    includeMetrics: parseOptionalBoolFlag(flags, "includeMetrics") ?? false
   };
 }
 var SUPPLIER_SORT_FIELDS = [
@@ -11996,25 +12996,89 @@ function parseOptionalSupplierSortBy(raw) {
   }
   return raw;
 }
-function parseListSuppliersFlags(flags) {
-  const createdByRaw = getFlag(flags, "createdBy");
-  const statusRaw = getFlag(flags, "status");
-  const supplierTagsRaw = getFlag(flags, "supplierTags");
-  const sortBy = parseOptionalSupplierSortBy(getFlag(flags, "sortBy"));
-  const sortDirRaw = getFlag(flags, "sortDir");
-  const sortDir = parseOptionalBillListSortDir(sortDirRaw !== undefined ? String(sortDirRaw) : undefined);
+var parseSupplierFilters = (flags) => {
+  for (const key of [
+    "name",
+    "createdBy",
+    "gstRegistered",
+    "status",
+    "supplierTags",
+    "active"
+  ])
+    rejectBareFlag(flags, key);
   return {
     name: getFlag(flags, "name"),
-    page: parsePositiveIntFlag(getFlag(flags, "page"), "--page"),
-    perPage: parsePositiveIntFlag(getFlag(flags, "perPage"), "--perPage"),
-    sort: sortBy !== undefined || sortDir !== undefined ? [{ id: sortBy ?? "createdAt", desc: (sortDir ?? "desc") === "desc" }] : undefined,
-    createdBy: parseCommaSeparatedIds(createdByRaw !== undefined ? String(createdByRaw) : undefined),
-    gstRegistered: parseOptionalBoolFlag(flags, "gstRegistered"),
-    status: parseCommaSeparatedSupplierStatuses(statusRaw !== undefined ? String(statusRaw) : undefined),
-    supplierTags: parseCommaSeparatedIds(supplierTagsRaw !== undefined ? String(supplierTagsRaw) : undefined),
-    active: parseOptionalBoolFlag(flags, "active")
+    createdBy: parseCommaSeparatedIds(getFlag(flags, "createdBy")),
+    gstRegistered: parseOptionalBoolFlag(flags, "gstRegistered") ?? null,
+    status: parseCommaSeparatedSupplierStatuses(getFlag(flags, "status")),
+    supplierTags: parseCommaSeparatedIds(getFlag(flags, "supplierTags")),
+    active: parseOptionalBoolFlag(flags, "active") ?? true
   };
-}
+};
+var rejectSupplierPageFlags = (flags) => {
+  for (const key of PROJECT_PAGE_FLAGS) {
+    if (flags[key] !== undefined)
+      throw new Error(`--${key} is retired for suppliers; use --limit/--cursor or supplier count for totals.`);
+  }
+};
+var parseListSuppliersFlags = (flags) => {
+  rejectSupplierPageFlags(flags);
+  for (const key of [
+    "limit",
+    "cursor",
+    "direction",
+    "sort",
+    "sortBy",
+    "sortDir"
+  ])
+    rejectBareFlag(flags, key);
+  const limit = getFlag(flags, "limit") === undefined ? 10 : parseProjectLimit(getFlag(flags, "limit"));
+  const cursor = getFlag(flags, "cursor");
+  if (cursor === "" || (cursor?.length ?? 0) > 8192)
+    throw new Error("--cursor must be a non-empty opaque token of at most 8192 characters.");
+  const direction = parseProjectDirection(getFlag(flags, "direction"));
+  if (direction === "backward" && !cursor)
+    throw new Error("--direction backward requires --cursor <token>.");
+  const sortRaw = getFlag(flags, "sort");
+  let sort;
+  if (sortRaw !== undefined) {
+    if (flags.sortBy !== undefined || flags.sortDir !== undefined)
+      throw new Error("Use --sort or --sortBy/--sortDir, not both.");
+    const parsed = parseJsonFlag(sortRaw, "--sort");
+    if (!Array.isArray(parsed) || parsed.length > 8)
+      throw new Error("--sort must be a JSON array of at most eight {id, desc} entries.");
+    sort = parsed.map((item) => {
+      if (typeof item !== "object" || item === null || !("id" in item) || !("desc" in item) || typeof item.id !== "string" || typeof item.desc !== "boolean" || Object.keys(item).some((key) => key !== "id" && key !== "desc"))
+        throw new Error("Invalid --sort entry; use {id, desc}.");
+      const id = parseOptionalSupplierSortBy(item.id);
+      if (!id)
+        throw new Error("Invalid --sort field.");
+      return { id, desc: item.desc };
+    });
+  } else {
+    const sortBy = parseOptionalSupplierSortBy(getFlag(flags, "sortBy"));
+    const sortDir = parseOptionalBillListSortDir(getFlag(flags, "sortDir"));
+    sort = [
+      { id: sortBy ?? "createdAt", desc: (sortDir ?? "desc") === "desc" }
+    ];
+  }
+  return { ...parseSupplierFilters(flags), limit, cursor, direction, sort };
+};
+var parseCountSuppliersFlags = (flags) => {
+  rejectSupplierPageFlags(flags);
+  for (const key of [
+    "limit",
+    "cursor",
+    "direction",
+    "sort",
+    "sortBy",
+    "sortDir"
+  ]) {
+    if (flags[key] !== undefined)
+      throw new Error(`supplier count does not accept --${key}; totals use filters only.`);
+  }
+  return parseSupplierFilters(flags);
+};
 function parseDashboardQueryFlags(flags) {
   const roleRaw = getFlag(flags, "role");
   const timeFrameRaw = getFlag(flags, "timeFrame");
@@ -12049,7 +13113,8 @@ pending-approver assignment. On FORBIDDEN, stop and report the identity, role,
 command, and target; do not switch keys or try a lower-level procedure.
 
 Sensitive workflow changes: approval decisions/requests, entity status updates,
-estimate emails, customer invoices, integration retries, mark-budget-won,
+estimate emails, customer invoices, integration retries and QuickBooks outcome
+verification, mark-budget-won,
 submit-quotation, and supplier approval request side effects require an
 interactive CONFIRM prompt and abort in non-interactive shells.
 AI agents must inspect the entity first, summarize the exact entity, target
@@ -12060,15 +13125,20 @@ Budget mutations return a conflict while an estimate email is queued,
 processing, or awaiting provider reconciliation.
 
 Budgets
-  list-budgets              [--projectId] [--name] [--status CSV] [--createdBy] [--dateFrom] [--dateTo] [--sortBy] [--sortDir] [--page] [--perPage] [--summary]
+  list-budgets              [--projectId] [--name] [--status CSV] [--createdBy] [--dateFrom] [--dateTo] [--sortBy lastActivityAt|createdAt|status|budget|date|createdBy] [--sortDir] [--limit 1-100] [--cursor <token>] [--direction forward|backward] [--summary]
+    Returns { items, pageInfo }; follow nextCursor/previousCursor with the same filters and sort. --page/--perPage are rejected.
+  count-budgets             [same filter flags as list-budgets]   totalCount plus status and active facets (each ignores its own filter)
   get-budget <id>            Budget + line items
   get-budget-items <id>      Line items only
   get-budget-details <id>    Full detail (margins, suppliers, etc.)
-  get-budget-categories
-  get-budget-versions <budgetId> [--limit <1-50>] [--cursor <versionId> | --all]
+  get-budget-categories      [--q] [--limit 1-100] [--cursor <token>]
+    Active categories, name A\u2013Z. Returns { items, pageInfo }; follow nextCursor with the same --q.
+  get-budget-versions <budgetId> [--limit <1-50>] [--cursor <token> | --all]
   rename-budget-version <versionId> --name <text>
   restore-budget-version <versionId>   Replace current budget data and return it to DRAFT.
   update-budget-status <id> <status> [--projectManagerId <id>] [--markProjectWon true|false] [--projectStatusOnCommercialRejection PITCH|LOST]
+    APPROVED requires a current Lead/Admin role, regardless of budget management permissions. Ordinary users must request approval.
+    Material edits and generic status changes invalidate older pending budget requests; decide only a fresh request for the content reviewed.
     Budget-changing commands require interactive "yes" confirmation when the current budget is ESTIMATE_CREATED, ESTIMATE_SENT, ESTIMATE_ACCEPTED, ESTIMATE_REJECTED, or ESTIMATE_CLOSED.
     ESTIMATE_ACCEPTED requires win proof, auto-marks PITCH or LOST projects WON, requires --projectManagerId when the project has no PM, and auto-creates the Asana project/section when enabled.
     ESTIMATE_REJECTED requires --projectStatusOnCommercialRejection when rejecting the only accepted/closed budget on a commercial project.
@@ -12078,7 +13148,7 @@ Budgets
   update-budget              --payload '<json>'  (budget.updateBudget; must include id)
   delete-budget <budgetId>
   create-budget-approval <budgetId>   (also queues approval request emails)
-  create-estimate <budgetId>          (creates QuickBooks estimate; supports preflight updates)
+  create-estimate <budgetId>          (queues QuickBooks estimate creation; budget is read-only until it settles; supports preflight updates)
   send-estimate-to-contact-person --payload '<json>'   Send using the web contact-person workflow; payload includes recipient fields plus HTML content/signature.
   add-budget-items           --budgetId --items '[{"itemId":"\u2026","quantity":1,"markup":30},\u2026]'
   update-budget-item         --id <budgetItemId> [--description plain-text] [--note plain-text] [--quantity] [--markup] [--cost] [--unitPrice] [--isFreeOfCharge true|false] [--gstInclusive true|false] [--gstOutOfScope true|false]
@@ -12086,7 +13156,7 @@ Budgets
   replace-budget-item        --budgetItemId <id> --replacementItemId <activeCatalogueItemId>
   approve-unavailable-item-exception --budgetItemId <id> --reason <text>   Lead/Admin only; reason must be 5-1000 characters.
   reorder-budget-items       <budgetId> --itemIds <csv>
-  update-budget-item-supplier --budgetItemId --supplierId
+  update-budget-item-supplier --budgetItemId --supplierId   Material supplier/GST edit: supersedes pending approvals and applies the standard budget reset policy; unchanged supplier is a no-op.
   create-budget-category     --name <text>
   update-budget-category     --id --name
   delete-budget-category <id>
@@ -12100,8 +13170,11 @@ Budgets
   upload-budget-attachment <budgetId> <filePath>   Presigned S3 upload + confirm
 
 Bills
-  list-bills                 [--projectId] [--budgetId] [--status CSV] [--search <text>] [--isClaimable true|false] [--createdByIds <csv>] [--sortBy createdAt|amount|status] [--sortDir asc|desc] [--page] [--pageSize]
+  list-bills                 [--projectId] [--budgetId] [--status CSV] [--search <text>] [--isClaimable true|false] [--createdByIds <csv>] [--sortBy createdAt|amount|status] [--sortDir asc|desc] [--limit 1-100] [--cursor <token>] [--direction forward|backward]
+    Returns { items, pageInfo }; pass nextCursor with --direction forward or previousCursor with --direction backward, keeping the same filters and sort. --page/--pageSize/--perPage are rejected.
   list-claims                same flags as list-bills; only reimbursable claims (ignores --isClaimable)
+  count-bills                [--projectId] [--budgetId] [--status CSV] [--search <text>] [--isClaimable true|false] [--createdByIds <csv>] [--includeMetrics true|false]   totalCount, status facets (ignore --status) and optional amount metrics; no pagination/sort flags
+  count-claims               same flags as count-bills; only reimbursable claims
                             Both lists return summaries; use get-bill-details <billId> for full detail.
     isClaimable differentiates the shared bill/claim records: false = bill, true = claim.
   Create supplier bills from approved quotations from the same supplier and project. Use quotationAllocations plus lineAmounts when quotations split one bill line. Eligible exemptions require explicit --quotation-exempt intent; claims do not consume or link quotations.
@@ -12112,7 +13185,7 @@ Bills
   validate-bill-selection    --payload '<json>' [--quotationIds <csv> | --quotationId <id>]  Validate an approved supplier and approved quotation coverage for each supplier-bill line. --quotationId is legacy single-quotation syntax.
   link-bill-quotations       <billId> (--payload '<json>' | --quotationIds <csv>)  Admin-only source-link repair; payload.quotationAllocations supports same-line splits.
   stage-bill-attachment <projectId> <filePath...> [--file <path>] [--files <csv>]   Upload files before create-bill; returns attachment JSON for attachments/paymentProofAttachments
-  cleanup-staged-bill-attachments <projectId> --keys <csv>   Delete unattached staged bill/claim uploads.
+  cleanup-staged-bill-attachments <projectId> --keys <csv>   Queue cleanup of unattached staged uploads; returns operation IDs.
   update-bill                --payload '<json>'  (bill.update; must include id)
   update-bill-payment-evidence --payload '<json>'  Replace paymentReference/paymentProofAttachments for an already-paid bill.
   delete-bill <billId>
@@ -12123,23 +13196,25 @@ Bills
   patch-bill-payment <billId> [--paymentTrackingUrl] [--paymentReference] [--quickbooksBillId] [--paymentDate <ISO>]
     Clear a field: --clearPaymentTrackingUrl true | --clearPaymentReference true | --clearQuickbooksBillId true | --clearPaymentDate true
   patch-bill-invoice-number <billId> <invoiceNumber>
-  get-bill-attachments <billId>
+  get-bill-attachments <billId> [--limit 1-50] [--cursor <token>]
+    Newest first. Returns { items, pageInfo }; follow nextCursor.
   upload-bill-attachment <billId> <filePath...> [--file <path>] [--files <csv>]   Attach invoice/supporting files as BILL attachments to any bill status, including PAID bills
   attach-bill-payment-receipt <billId> <filePath...> [--file <path>] [--files <csv>]   Attach Wise/payment-proof PDFs as BILL_PAYMENT_PROOF attachments
   attach-bill-documents <billId> [--invoice <path>] [--invoices <csv>] [--paymentProof|--payment-proof|--proof <path>] [--paymentProofs|--payment-proofs|--proofs <csv>]   Attach invoice and/or payment proof files with separate BB attachment types
   get-bill-details <billId>
 
 Quotations
-  list-quotations            [--projectId] [--budgetId] [--supplierId] [--status CSV] [--createdBy CSV] [--search] [--page] [--perPage]
-    Legacy aliases --requesterIds and --pageSize remain supported.
+  list-quotations            [--projectId] [--budgetId] [--supplierId] [--status CSV] [--createdBy CSV] [--search] [--limit 1-100] [--cursor <token>] [--direction forward|backward]
+    Newest first; returns { items, pageInfo }. Follow nextCursor/previousCursor with the same filters. --page/--pageSize/--perPage are rejected; --requesterIds remains an alias for --createdBy.
+  count-quotations           [--projectId] [--budgetId] [--supplierId] [--status CSV] [--createdBy CSV] [--search] [--includeMetrics true|false]   totalCount, status facets (ignore --status) and optional amount metrics
   get-quotation <quotationId>
   upload-quotation-attachment <projectId> <filePath>   Upload one PDF, JPEG, or PNG up to 20MB; returns attachment JSON for a quotation payload.
-  cleanup-staged-quotation-attachments <projectId> --keys <csv>   Delete unattached staged quotation uploads.
+  cleanup-staged-quotation-attachments <projectId> --keys <csv>   Queue cleanup of unattached quotation uploads; returns operation IDs.
   create-quotation           --payload '<json>'  (quotation.createDraft; requires amountWithoutGst, gstAmount, and lineAmounts [{budgetItemId, amount}] for multiple budgetItemIds; amounts before GST must sum to amountWithoutGst)
   update-quotation           --payload '<json>'  Update a DRAFT or REJECTED quotation; same allocation payload plus id; use lineAmounts [{budgetItemId, amount}] for every selected item.
   delete-quotation <quotationId>
   submit-quotation <quotationId> [--overBudgetOverrideReason <text>]
-  approve-quotation <quotationId> [--overBudgetOverrideReason <text>]
+  approve-quotation <quotationId> [--overBudgetOverrideReason <text>] (assigned pending request/current Admin; concurrent revision or allocation changes conflict)
   reject-quotation <quotationId> --reason <text>
   download-quotation-pdf <quotationId> [original|staff|final]
 
@@ -12148,8 +13223,10 @@ Customer invoices
   list-eligible-customer-invoice-budgets <projectId>   Accepted budgets that are ready and still have invoice coverage remaining, including estimate total, invoiced/remaining percentages, and available amount.
   preview-customer-invoice-amount <budgetId> <percentage-of-estimate>   Preview amount before GST, GST, and total for a percentage of the original estimate. The percentage cannot exceed the budget's remaining coverage.
   list-available-qbo-customer-invoices <budgetId>      List unlinked QuickBooks invoices available for this accepted or closed estimate before previewing and importing one.
-  list-customer-invoices [budgetId] [--projectId <id>] [--companyIds CSV] [--projectIds CSV] [--budgetIds CSV] [--createdByIds CSV] [--status CSV] [--search] [--sortBy createdAt|status|totalInvoiceAmount|approvalExpiresAt] [--sortDir asc|desc] [--page] [--perPage]
+  list-customer-invoices [budgetId] [--projectId <id>] [--companyIds CSV] [--projectIds CSV] [--budgetIds CSV] [--createdByIds CSV] [--status CSV] [--search] [--sortBy createdAt|status|totalInvoiceAmount|approvalExpiresAt] [--sortDir asc|desc] [--limit 1-100] [--cursor <token>] [--direction forward|backward]
+    Returns { items, pageInfo }; follow nextCursor/previousCursor with the same filters and sort. --page/--perPage are rejected.
     No scope flag lists invoices globally. --projectId uses the project scope. A positional budgetId is a backward-compatible shortcut for --budgetIds.
+  count-customer-invoices [budgetId] [same filter flags as list-customer-invoices]   totalCount, lifecycle status facets (ignore --status) and amount metrics; no paging or sort flags
   get-customer-invoice <batchId>
   get-customer-invoice-email-context <batchId>        Contact, required CC, budget, and project context for composing an invoice email.
   preview-qbo-customer-invoice <budgetId> <qboInvoiceId>   Preview an invoice selected from list-available-qbo-customer-invoices; works on accepted/closed estimates.
@@ -12174,20 +13251,28 @@ Approvals
   reject-supplier <supplierId> --reason <text> (also sends requester reply email)
 
 Companies & projects
-  list-companies             [--name] [--createdBy] [--active true|false] [--page] [--perPage]
-    Omit --active to include both active and inactive companies.
+  list-companies             [--name] [--createdBy] [--createdByIds CSV] [--active true|false] [--sortBy name|createdAt] [--sortDir asc|desc] [--limit 1-100] [--cursor] [--direction forward|backward]
+    Returns { items, pageInfo }; pass nextCursor with direction forward or previousCursor with direction backward. Omit --cursor to restart.
+  count-companies            [--name] [--createdBy] [--createdByIds CSV] [--active true|false]
+    Returns independent { totalCount, counts: { active: { true, false } } }; no pagination or sorting flags.
   get-company <id>
-  search-existing-companies  --query <name> [--page] (BB + QuickBooks, read-only)
+  search-existing-companies  --query <name> [--limit 1-50] [--cursor <token>] (BB + QuickBooks, read-only; follow pageInfo.nextCursor)
   use-existing-company      --companyId <bbId> and/or --quickbooksId <qboId> [--website <url>] [--confirmDistinct true]
     Supply both IDs to explicitly connect existing records with different names.
     Reuses both records, creating only the missing counterpart. Website is needed only for a QBO import without one.
   create-company             --name --website <url> [--confirmDistinct true]
     Exact existing companies are reused. Similar names require explicit separate-entity confirmation.
-  update-company             --payload '<json>'  (company.updateCompany; must include id, name, website)
+  update-company             --payload '<json>'  (saves BB fields; returns queued QBO operation ID, not completion)
+  get-company-quickbooks-sync-status <companyId>  (saved status only; no provider call or polling)
   delete-company <id>
-  list-projects              [--companyId] [--name] [--status] [--active true|false] [--page] [--perPage]
-    Omit --active to include both active and inactive projects.
-  list-project-hubs          [--q] [--status CSV] [--page] [--perPage] [--sortBy startDate|name|companyName|status] [--sortDir asc|desc]
+  list-projects              [--companyId] [--name] [--status|--statuses CSV] [--active true|false] [--wonFrom ISO] [--wonTo ISO] [--wonWithinDays N] [--limit 1-100] [--cursor] [--direction forward|backward] [--sortBy name|createdAt|status|companyName|wonAt] [--sortDir asc|desc]
+    Returns { items, pageInfo }; pass nextCursor with direction forward or previousCursor with direction backward. Legacy --page/--perPage are rejected.
+    --sortBy wonAt orders by when the project was marked WON (unwon projects last). Each project includes wonAt, wonById, wonBy and wonAtEstimated (true for backfilled dates).
+  count-projects             [--companyId] [--name] [--status|--statuses CSV] [--active true|false] [--wonFrom ISO] [--wonTo ISO] [--wonWithinDays N]
+    Returns independent { totalCount, counts: { status, active: { true, false } } }; no pagination or sorting flags.
+  list-project-hubs          [--q] [--status CSV] [--sortBy startDate|name|companyName|status] [--sortDir asc|desc] [--limit 1-100] [--cursor <token>] [--direction forward|backward]
+    Returns { items, pageInfo }; follow nextCursor/previousCursor with the same filters and sort. --page/--perPage are rejected.
+  count-project-hubs         [--q] [--status CSV]   totalCount plus status facet
     List active projects that have a Project Hub integration.
   get-project <id>
     Budget overview totalRevenue includes Estimate Accepted and Estimate Closed budgets only.
@@ -12209,9 +13294,10 @@ Contacts
   update-contact-person      --payload '<json>'  (contactPerson.updateContactPerson; must include id)
 
 Suppliers & items
-  list-suppliers             [--name] [--page] [--perPage] [--sortBy createdAt|updatedAt|name|email|phone|gstRegistered|status|active] [--sortDir asc|desc] [--createdBy <csv>] [--gstRegistered true|false] [--status CSV] [--supplierTags <csv>] [--active true|false]
-    Defaults: --active true, --perPage 10, --sortBy createdAt, --sortDir desc (same as the web list); pass --active false for archived suppliers.
-  create-supplier            --payload '<json>'  (supplier.createSupplier; auto-requests approval + emails when status is PENDING_APPROVAL)
+  list-suppliers             [--name] [--limit 1-100] [--cursor <token>] [--direction forward|backward] [--sortBy createdAt|updatedAt|name|email|phone|gstRegistered|status|active] [--sortDir asc|desc | --sort JSON] [--createdBy <csv>] [--gstRegistered true|false] [--status CSV] [--supplierTags <csv>] [--active true|false]
+  count-suppliers            [--name] [--createdBy <csv>] [--gstRegistered true|false] [--status CSV] [--supplierTags <csv>] [--active true|false] (independent totals/facets; no pagination/sort flags)
+    Defaults: --active true, --limit 10, --sortBy createdAt, --sortDir desc (same as the web list); pass --active false for archived suppliers.
+  create-supplier            --payload '<json>'  (supplier.createSupplier; archived-name recreation is Admin-only; auto-requests approval + emails when status is PENDING_APPROVAL)
   update-supplier            --payload '<json>'  (authenticated; normal-user edits require server-enforced approval)
   delete-suppliers           --ids <csv>  (supplier.deleteSuppliers; admin; archives/deactivates supplier items)
   reactivate-suppliers       --ids <csv>  (supplier.reactivateSuppliers; admin; reactivates supplier items)
@@ -12224,20 +13310,29 @@ Suppliers & items
   archive-items              --ids <csv>  (item.archiveItems; Budget Builder only; max 100; users can archive their own items, leads/admins any item; open estimates retain snapshot lines and require resolution before send/acceptance)
   delete-item <id>           (item.deleteItem; admin; archives in Budget Builder and makes the item inactive in QuickBooks; blocked while used by an open estimate)
   get-supplier-details <supplierId>
-  get-supplier-analytics     [--name] [--page] [--perPage] [--timeFrame ALL|LAST_YEAR|\u2026]  (admin)
-  list-items                 [--name] [--page] [--perPage] [--includeQuickBooksDeactivationPending true]
+  get-supplier-analytics     [--name] [--status CSV] [--gstRegistered true|false] [--createdBy <text>] [--timeFrame ALL|LAST_YEAR|LAST_6_MONTHS|LAST_3_MONTHS|CUSTOM] [--startDate <ISO> --endDate <ISO>] [--sortBy name|gstRegistered|status|phone|email|updatedAt|createdAt] [--sortDir asc|desc] [--limit 1-100] [--cursor <token>] [--direction forward|backward]
+    Admin. Returns { items, pageInfo }; follow nextCursor/previousCursor with the same filters and sort. --page/--perPage are rejected.
+  count-supplier-analytics   [--name] [--status] [--gstRegistered] [--createdBy] [--timeFrame] [--startDate --endDate]   Admin. totalCount for the same filters
+  list-items                 [--name] [--includeQuickBooksDeactivationPending true] [--sortBy createdAt|updatedAt|name|cost|itemCategory|supplier] [--sortDir asc|desc] [--limit 1-100] [--cursor <token>] [--direction forward|backward]
+    Returns { items, pageInfo }; follow nextCursor/previousCursor with the same filters and sort. --page/--perPage are rejected.
+  count-items                [same filter flags as list-items]   total plus category and supplier facets
   get-item <id>
-  list-item-categories       [--page] [--perPage]
+  get-item-quickbooks-sync-status <itemId>  (saved status only; no provider call or polling)
+  list-item-categories       [--name] [--sortBy createdAt|name|itemCount|createdBy] [--sortDir asc|desc] [--limit 1-100] [--cursor <token>] [--direction forward|backward]
+    Active categories only; returns { items, pageInfo }. Follow nextCursor/previousCursor with the same filters and sort. --page/--perPage are rejected.
+  count-item-categories      [--name]   totalCount of active categories
   create-item-category       --name  (admin)
   update-item-category       --id --name  (authenticated; applies immediately)
   delete-item-categories     --ids <csv>  (itemCategory.deleteItemCategories; admin; empty categories only)
 
 Dashboard & users
   whoami                    Show the user identity and role for the active API key.
-  list-users
+  list-users                 [--q] [--limit 1-100] [--cursor <token>]
+    Name A\u2013Z. Returns { items, pageInfo }; follow nextCursor with the same --q. --page/--perPage are rejected.
+  count-users                [--q]   totalCount for the same search
   create-user                --email <email> [--name <name>] [--role ${userRolesForHelp.join("|")}]  (admin; API-only service identity with no Google sign-in)
   create-api-key             --name <label> [--userId <userId>]  (defaults to the caller; admin required for another user; raw key is shown once)
-  list-api-keys              [--userId <userId>]  (defaults to the caller; admin required for another user)
+  list-api-keys              [--userId <userId>] [--limit 1-100] [--cursor <token>]  (newest first, { items, pageInfo }; defaults to the caller; admin required for another user)
   revoke-api-key <apiKeyId>  [--userId <userId>]  (defaults to the caller; admin required for another user)
   get-user-performance       [--userId]  (admin)
   get-dashboard              [--userId] [--role BD|CREATOR|INSIDE_SALES|ALL] [--deals ALL|SUCCESSFUL|LOST] [--timeFrame] [--startDate] [--endDate]  (admin)
@@ -12247,12 +13342,30 @@ Dashboard & users
   get-financial-overview     [same optional flags as dashboard; role uses BudgetRole enum]  (admin)
 
 Errors
-  get-recent-errors          [--page] [--perPage] [--severity] [--status]  (admin)
+  get-recent-errors          [--cursor] [--direction forward|backward] [--limit] [--severity] [--status] [--timeFrame]  (admin)
+  count-errors              [--severity] [--status] [--timeFrame]  (admin)
   get-error-metrics          (admin)
 
 Automation (admin)
-  list-integration-operations [--search] [--destination <provider,...>] [--status <PENDING|PROCESSING|FAILED|COMPLETED,...>] [--page] [--perPage]
-  retry-integration-operation <operationId> [--confirmExternalStateReconciled true|false] [--outboundEmailResolution ACCEPTED|NOT_ACCEPTED_RETRY] [--providerMessageId <id>]
+  list-integration-operations [--search] [--destination <provider,...>] [--status <PENDING|PROCESSING|FAILED|COMPLETED,...>] [--limit 1-100] [--cursor <token>] [--direction forward|backward]
+    Newest first; returns { items, pageInfo }. Follow nextCursor/previousCursor with the same filters. --page/--perPage are rejected.
+  count-integration-operations [same filter flags]   totalCount plus provider filter options
+  get-integration-operation <operationId>  (one job: who queued it, what it is for, saved progress, Retry state)
+  retry-integration-operation <operationId> [--confirmExternalStateReconciled true|false] [--outboundEmailResolution ACCEPTED|NOT_ACCEPTED_RETRY] [--providerMessageId <id>]  (QuickBooks jobs with a saved attempt check QuickBooks first: applied changes finish without resending, unapplied ones are sent again)
+  reconcile-resource-operation <operationId>  (admin: check a QuickBooks invoice/company/item job outcome without retrying; same check Retry runs first)
+
+Webhooks (admin)
+  list-webhook-event-types   (event catalogue: type, group, live|planned)
+  list-webhook-endpoints
+  get-webhook-endpoint <endpointId>
+  create-webhook-endpoint --name <name> --url <https-url> --events <type|prefix.*|*,...> [--enabled true|false]  (prints the signing secret once)
+  update-webhook-endpoint <endpointId> [--name] [--url] [--events <...>] [--enabled true|false]
+  delete-webhook-endpoint <endpointId>
+  rotate-webhook-secret <endpointId> [--previousSecretTtlHours <0-168>]  (prints the new secret once)
+  send-webhook-test-event <endpointId>
+  list-webhook-deliveries [--endpointId] [--status PENDING|SUCCEEDED|FAILED] [--eventType] [--cursor] [--limit]
+  get-webhook-delivery <deliveryId>  (attempts with response codes)
+  replay-webhook-delivery <deliveryId>  (same eventId, new attempt chain)
 
 Historical / benchmarks
   get-approved-budgets       [--projectId] [--limit] [--minRevenue] [--maxRevenue]
@@ -12594,6 +13707,8 @@ Waiting for approval\u2026
     });
   }
   try {
+    if (flags.q === true)
+      throw new CliRuntimeError("USAGE", "--q needs a search value (--q <text> or --q=<text>). Use -q or --quiet to hide logs.");
     if (runtime.env.BB_API_KEY?.trim()) {
       configureAccessToken(undefined);
     } else {
@@ -12625,21 +13740,49 @@ Waiting for approval\u2026
         await whoAmI();
         break;
       }
-      case "list-budgets": {
+      case "list-budgets":
+      case "count-budgets": {
         const statusStr = getFlag(flags, "status");
         const statuses = parseCommaSeparatedBudgetStatuses(statusStr !== undefined ? String(statusStr) : undefined);
-        await listBudgets({
+        const filters = {
           projectId: getFlag(flags, "projectId"),
           name: getFlag(flags, "name"),
           statuses,
           createdBy: getFlag(flags, "createdBy"),
           dateFrom: getFlag(flags, "dateFrom"),
           dateTo: getFlag(flags, "dateTo"),
-          active: parseBudgetActiveFlag(flags),
+          active: parseBudgetActiveFlag(flags)
+        };
+        rejectRetiredPageFlags(flags);
+        if (cmd === "count-budgets") {
+          for (const key of [
+            "limit",
+            "cursor",
+            "direction",
+            "sortBy",
+            "sortDir"
+          ]) {
+            if (flags[key] !== undefined)
+              throw new Error(`count-budgets does not accept --${key}; totals use filters only.`);
+          }
+          await countBudgets(filters);
+          break;
+        }
+        for (const key of ["limit", "cursor", "direction", "sortBy", "sortDir"])
+          rejectBareFlag(flags, key);
+        const cursor = getFlag(flags, "cursor");
+        if (cursor === "" || (cursor?.length ?? 0) > 8192)
+          throw new Error("--cursor must be a non-empty opaque token of at most 8192 characters.");
+        const direction = parseProjectDirection(getFlag(flags, "direction"));
+        if (direction === "backward" && !cursor)
+          throw new Error("--direction backward requires --cursor <token>.");
+        await listBudgets({
+          ...filters,
+          limit: parseProjectLimit(getFlag(flags, "limit")),
+          cursor,
+          direction,
           sortBy: getFlag(flags, "sortBy"),
           sortDir: getFlag(flags, "sortDir"),
-          page: parsePositiveIntFlag(getFlag(flags, "page"), "--page"),
-          perPage: parsePositiveIntFlag(getFlag(flags, "perPage"), "--perPage"),
           includeDetails: flags.summary === true ? false : parseOptionalBoolFlag(flags, "includeDetails") ?? true
         });
         break;
@@ -12692,7 +13835,19 @@ Waiting for approval\u2026
         break;
       }
       case "get-budget-categories": {
-        await getBudgetCategories();
+        rejectRetiredPageFlags(flags);
+        for (const key of ["limit", "cursor"])
+          rejectBareFlag(flags, key);
+        if (flags.direction !== undefined)
+          throw new Error("get-budget-categories pages forward only; follow pageInfo.nextCursor with --cursor.");
+        const cursor = getFlag(flags, "cursor");
+        if (cursor === "" || (cursor?.length ?? 0) > 8192)
+          throw new Error("--cursor must be a non-empty opaque token of at most 8192 characters.");
+        await getBudgetCategories({
+          q: getFlag(flags, "q"),
+          limit: parseProjectLimit(getFlag(flags, "limit")),
+          cursor
+        });
         break;
       }
       case "get-budget-versions": {
@@ -12704,7 +13859,7 @@ Waiting for approval\u2026
           throw new CliRuntimeError("USAGE", "--limit must be an integer from 1 to 50.");
         }
         if (flags.cursor === true || flags.cursor === "") {
-          throw new CliRuntimeError("USAGE", "--cursor requires a non-empty version ID.");
+          throw new CliRuntimeError("USAGE", "--cursor requires the nextCursor token from the previous page.");
         }
         await getBudgetVersions(id, {
           limit,
@@ -12985,6 +14140,14 @@ Waiting for approval\u2026
         });
         break;
       }
+      case "count-bills": {
+        await countBills(parseCountBillsFlags(flags));
+        break;
+      }
+      case "count-claims": {
+        await countBills({ ...parseCountBillsFlags(flags), isClaimable: true });
+        break;
+      }
       case "create-bill-approval": {
         const id = positional[0];
         if (!id)
@@ -13185,7 +14348,19 @@ Waiting for approval\u2026
         const id = positional[0];
         if (!id)
           throw new Error("get-bill-attachments requires <billId>");
-        await getBillAttachments(id);
+        rejectRetiredPageFlags(flags);
+        for (const key of ["limit", "cursor"])
+          rejectBareFlag(flags, key);
+        if (flags.direction !== undefined)
+          throw new Error("get-bill-attachments pages forward only; follow pageInfo.nextCursor with --cursor.");
+        const cursor = getFlag(flags, "cursor");
+        if (cursor === "" || (cursor?.length ?? 0) > 8192)
+          throw new Error("--cursor must be a non-empty opaque token of at most 8192 characters.");
+        const limitFlag = getFlag(flags, "limit");
+        const limit = limitFlag === undefined ? undefined : Number(limitFlag);
+        if (limit !== undefined && (!Number.isInteger(limit) || limit < 1 || limit > 50))
+          throw new Error("--limit must be an integer from 1 to 50.");
+        await getBillAttachments({ id, limit, cursor });
         break;
       }
       case "stage-bill-attachment": {
@@ -13278,18 +14453,32 @@ Waiting for approval\u2026
         break;
       }
       case "list-quotations": {
-        const statusRaw = getFlag(flags, "status");
-        const createdByRaw = getFlag(flags, "createdBy") ?? getFlag(flags, "requesterIds");
-        const perPageRaw = getFlag(flags, "perPage") ?? getFlag(flags, "pageSize");
+        rejectRetiredPageFlags(flags);
+        for (const key of ["limit", "cursor", "direction"])
+          rejectBareFlag(flags, key);
+        const cursor = getFlag(flags, "cursor");
+        if (cursor === "" || (cursor?.length ?? 0) > 8192)
+          throw new Error("--cursor must be a non-empty opaque token of at most 8192 characters.");
+        const direction = parseProjectDirection(getFlag(flags, "direction"));
+        if (direction === "backward" && !cursor)
+          throw new Error("--direction backward requires --cursor <token>.");
         await listQuotations({
-          projectId: getFlag(flags, "projectId"),
-          budgetId: getFlag(flags, "budgetId"),
-          supplierId: getFlag(flags, "supplierId"),
-          status: parseCommaSeparatedQuotationStatuses(statusRaw),
-          createdBy: parseCommaSeparatedIds(createdByRaw),
-          search: getFlag(flags, "search"),
-          page: getFlag(flags, "page") !== undefined ? Number(getFlag(flags, "page")) : undefined,
-          perPage: perPageRaw !== undefined ? Number(perPageRaw) : undefined
+          ...parseQuotationFilterFlags(flags),
+          limit: parseProjectLimit(getFlag(flags, "limit")),
+          cursor,
+          direction
+        });
+        break;
+      }
+      case "count-quotations": {
+        rejectRetiredPageFlags(flags);
+        for (const key of ["limit", "cursor", "direction"]) {
+          if (flags[key] !== undefined)
+            throw new Error(`count-quotations does not accept --${key}; totals use filters only.`);
+        }
+        await countQuotations({
+          ...parseQuotationFilterFlags(flags),
+          includeMetrics: parseOptionalBoolFlag(flags, "includeMetrics") ?? false
         });
         break;
       }
@@ -13411,7 +14600,8 @@ Waiting for approval\u2026
         await listAvailableQboCustomerInvoices(budgetId);
         break;
       }
-      case "list-customer-invoices": {
+      case "list-customer-invoices":
+      case "count-customer-invoices": {
         const positionalBudgetId = positional[0];
         const projectId = getFlag(flags, "projectId");
         const projectIds = parseCommaSeparatedIds(getFlag(flags, "projectIds"));
@@ -13423,17 +14613,44 @@ Waiting for approval\u2026
           ...parseCommaSeparatedIds(getFlag(flags, "budgetIds")) ?? []
         ];
         const statusRaw = getFlag(flags, "status");
-        const sortDir = parseOptionalBillListSortDir(getFlag(flags, "sortDir"));
-        await listCustomerInvoices({
+        const filters = {
           scope: projectId ? { type: "project", projectId } : { type: "global" },
-          page: parsePositiveIntFlag(getFlag(flags, "page"), "--page") ?? 1,
-          perPage: parsePositiveIntFlag(getFlag(flags, "perPage"), "--perPage") ?? 20,
           q: getFlag(flags, "search") ?? "",
           statuses: parseCommaSeparatedCustomerInvoiceStatuses(statusRaw !== undefined ? String(statusRaw) : undefined),
           companyIds: parseCommaSeparatedIds(getFlag(flags, "companyIds")),
           projectIds,
           budgetIds: budgetIds.length > 0 ? [...new Set(budgetIds)] : undefined,
-          createdByIds: parseCommaSeparatedIds(getFlag(flags, "createdByIds")),
+          createdByIds: parseCommaSeparatedIds(getFlag(flags, "createdByIds"))
+        };
+        rejectRetiredPageFlags(flags);
+        if (cmd === "count-customer-invoices") {
+          for (const key of [
+            "limit",
+            "cursor",
+            "direction",
+            "sortBy",
+            "sortDir"
+          ]) {
+            if (flags[key] !== undefined)
+              throw new Error(`count-customer-invoices does not accept --${key}; totals use filters only.`);
+          }
+          await countCustomerInvoices(filters);
+          break;
+        }
+        for (const key of ["limit", "cursor", "direction", "sortBy", "sortDir"])
+          rejectBareFlag(flags, key);
+        const cursor = getFlag(flags, "cursor");
+        if (cursor === "" || (cursor?.length ?? 0) > 8192)
+          throw new Error("--cursor must be a non-empty opaque token of at most 8192 characters.");
+        const direction = parseProjectDirection(getFlag(flags, "direction"));
+        if (direction === "backward" && !cursor)
+          throw new Error("--direction backward requires --cursor <token>.");
+        const sortDir = parseOptionalBillListSortDir(getFlag(flags, "sortDir"));
+        await listCustomerInvoices({
+          ...filters,
+          limit: parseProjectLimit(getFlag(flags, "limit")),
+          cursor,
+          direction,
           sortBy: parseCustomerInvoiceSortBy(getFlag(flags, "sortBy")),
           sortDir: sortDir ?? "desc"
         });
@@ -13612,13 +14829,11 @@ Waiting for approval\u2026
         break;
       }
       case "list-companies": {
-        await listCompanies({
-          name: getFlag(flags, "name"),
-          createdBy: getFlag(flags, "createdBy"),
-          active: parseOptionalBoolFlag(flags, "active"),
-          page: parsePositiveIntFlag(getFlag(flags, "page"), "--page"),
-          perPage: parsePositiveIntFlag(getFlag(flags, "perPage"), "--perPage")
-        });
+        await listCompanies(parseCompanyListFlags(flags));
+        break;
+      }
+      case "count-companies": {
+        await countCompanies(parseCompanyCountFlags(flags));
         break;
       }
       case "get-company": {
@@ -13645,7 +14860,17 @@ Waiting for approval\u2026
         const query = getFlag(flags, "query");
         if (!query)
           throw new Error("search-existing-companies requires --query <name>");
-        await searchExistingCompanies(query, parsePositiveIntFlag(getFlag(flags, "page"), "--page"));
+        rejectRetiredPageFlags(flags);
+        for (const key of ["limit", "cursor"])
+          rejectBareFlag(flags, key);
+        const cursor = getFlag(flags, "cursor");
+        if (cursor === "" || (cursor?.length ?? 0) > 8192)
+          throw new Error("--cursor must be a non-empty opaque token of at most 8192 characters.");
+        const limitFlag = getFlag(flags, "limit");
+        const limit = limitFlag === undefined ? undefined : Number(limitFlag);
+        if (limit !== undefined && (!Number.isInteger(limit) || limit < 1 || limit > 50))
+          throw new Error("--limit must be an integer from 1 to 50.");
+        await searchExistingCompanies({ query, limit, cursor });
         break;
       }
       case "use-existing-company": {
@@ -13678,6 +14903,13 @@ Waiting for approval\u2026
         await updateCompanyFromPayload(raw);
         break;
       }
+      case "get-company-quickbooks-sync-status": {
+        const id = positional[0];
+        if (!id)
+          throw new Error("get-company-quickbooks-sync-status requires <companyId>");
+        await getCompanyQuickBooksSyncStatus(id);
+        break;
+      }
       case "delete-company": {
         const id = positional[0];
         if (!id)
@@ -13686,23 +14918,46 @@ Waiting for approval\u2026
         break;
       }
       case "list-projects": {
-        const statusRaw = getFlag(flags, "status");
-        await listProjects({
-          companyId: getFlag(flags, "companyId"),
-          name: getFlag(flags, "name"),
-          status: parseOptionalExtendedProjectStatus(statusRaw !== undefined ? String(statusRaw) : undefined),
-          active: parseOptionalBoolFlag(flags, "active"),
-          page: parsePositiveIntFlag(getFlag(flags, "page"), "--page"),
-          perPage: parsePositiveIntFlag(getFlag(flags, "perPage"), "--perPage")
-        });
+        await listProjects(parseProjectListFlags(flags));
         break;
       }
-      case "list-project-hubs": {
-        await listProjectHubs({
+      case "count-projects": {
+        await countProjects(parseProjectCountFlags(flags));
+        break;
+      }
+      case "list-project-hubs":
+      case "count-project-hubs": {
+        rejectRetiredPageFlags(flags);
+        const filters = {
           q: getFlag(flags, "q"),
-          statuses: parseCommaSeparatedProjectStatuses(getFlag(flags, "status")),
-          page: parsePositiveIntFlag(getFlag(flags, "page"), "--page"),
-          perPage: parsePositiveIntFlag(getFlag(flags, "perPage"), "--perPage"),
+          statuses: parseCommaSeparatedProjectStatuses(getFlag(flags, "status"))
+        };
+        if (cmd === "count-project-hubs") {
+          for (const key of [
+            "limit",
+            "cursor",
+            "direction",
+            "sortBy",
+            "sortDir"
+          ])
+            if (flags[key] !== undefined)
+              throw new Error(`count-project-hubs does not accept --${key}; totals use filters only.`);
+          await countProjectHubs(filters);
+          break;
+        }
+        for (const key of ["limit", "cursor", "direction", "sortBy", "sortDir"])
+          rejectBareFlag(flags, key);
+        const cursor = getFlag(flags, "cursor");
+        if (cursor === "" || (cursor?.length ?? 0) > 8192)
+          throw new Error("--cursor must be a non-empty opaque token of at most 8192 characters.");
+        const direction = parseProjectDirection(getFlag(flags, "direction"));
+        if (direction === "backward" && !cursor)
+          throw new Error("--direction backward requires --cursor <token>.");
+        await listProjectHubs({
+          ...filters,
+          limit: parseProjectLimit(getFlag(flags, "limit")),
+          cursor,
+          direction,
           sortBy: parseOptionalProjectHubSortBy(getFlag(flags, "sortBy")),
           sortDir: parseOptionalBillListSortDir(getFlag(flags, "sortDir"))
         });
@@ -13871,6 +15126,10 @@ Waiting for approval\u2026
         await updateContactPersonFromPayload(raw);
         break;
       }
+      case "count-suppliers": {
+        await countSuppliers(parseCountSuppliersFlags(flags));
+        break;
+      }
       case "list-suppliers": {
         await listSuppliers(parseListSuppliersFlags(flags));
         break;
@@ -13945,22 +15204,117 @@ Waiting for approval\u2026
         await createSupplierTagOption(String(name));
         break;
       }
-      case "get-supplier-analytics": {
+      case "get-supplier-analytics":
+      case "count-supplier-analytics": {
+        rejectRetiredPageFlags(flags);
         const tfRaw = getFlag(flags, "timeFrame");
-        await getSupplierAnalytics({
+        for (const key of [
+          "name",
+          "status",
+          "gstRegistered",
+          "createdBy",
+          "startDate",
+          "endDate",
+          "timeFrame"
+        ])
+          rejectBareFlag(flags, key);
+        const timeFrame = parseOptionalSupplierAnalyticsTimeFrame(tfRaw !== undefined ? String(tfRaw) : undefined);
+        const startDate = getFlag(flags, "startDate");
+        const endDate = getFlag(flags, "endDate");
+        if ((startDate || endDate) && timeFrame !== "CUSTOM")
+          throw new Error("--startDate/--endDate need --timeFrame CUSTOM; other time frames ignore them.");
+        const statusRaw = getFlag(flags, "status");
+        const status = statusRaw?.split(",").map((value) => value.trim()).filter(Boolean);
+        const badStatus = status?.find((value) => !Object.values(ApprovalStatus2).some((s) => s === value));
+        if (badStatus)
+          throw new Error(`Invalid --status ${badStatus}. Use a comma list of: ${Object.values(ApprovalStatus2).join(", ")}.`);
+        const gstRaw = getFlag(flags, "gstRegistered");
+        if (gstRaw !== undefined && gstRaw !== "true" && gstRaw !== "false")
+          throw new Error("--gstRegistered must be true or false.");
+        const filters = {
           name: getFlag(flags, "name"),
-          page: parsePositiveIntFlag(getFlag(flags, "page"), "--page"),
-          perPage: parsePositiveIntFlag(getFlag(flags, "perPage"), "--perPage"),
-          timeFrame: parseOptionalSupplierAnalyticsTimeFrame(tfRaw !== undefined ? String(tfRaw) : undefined)
+          timeFrame,
+          status: status?.length ? status : undefined,
+          gstRegistered: gstRaw === undefined ? undefined : gstRaw === "true",
+          createdBy: getFlag(flags, "createdBy"),
+          startDate,
+          endDate
+        };
+        if (cmd === "count-supplier-analytics") {
+          for (const key of [
+            "limit",
+            "cursor",
+            "direction",
+            "sortBy",
+            "sortDir"
+          ])
+            if (flags[key] !== undefined)
+              throw new Error(`count-supplier-analytics does not accept --${key}; totals use filters only.`);
+          await countSupplierAnalytics(filters);
+          break;
+        }
+        for (const key of ["limit", "cursor", "direction", "sortBy", "sortDir"])
+          rejectBareFlag(flags, key);
+        const cursor = getFlag(flags, "cursor");
+        if (cursor === "" || (cursor?.length ?? 0) > 8192)
+          throw new Error("--cursor must be a non-empty opaque token of at most 8192 characters.");
+        const direction = parseProjectDirection(getFlag(flags, "direction"));
+        if (direction === "backward" && !cursor)
+          throw new Error("--direction backward requires --cursor <token>.");
+        const sortBy = getFlag(flags, "sortBy");
+        if (sortBy !== undefined && !SUPPLIER_ANALYTICS_SORT_IDS.some((id) => id === sortBy))
+          throw new Error(`--sortBy must be one of: ${SUPPLIER_ANALYTICS_SORT_IDS.join(", ")}.`);
+        await getSupplierAnalytics({
+          ...filters,
+          limit: parseProjectLimit(getFlag(flags, "limit")),
+          cursor,
+          direction,
+          sortBy: SUPPLIER_ANALYTICS_SORT_IDS.find((id) => id === sortBy),
+          sortDir: parseOptionalBillListSortDir(getFlag(flags, "sortDir"))
         });
         break;
       }
-      case "list-items": {
-        await listItems({
+      case "list-items":
+      case "count-items": {
+        rejectRetiredPageFlags(flags);
+        const filters = {
           includeQuickBooksDeactivationPending: flags.includeQuickBooksDeactivationPending === true ? true : parseOptionalBoolFlag(flags, "includeQuickBooksDeactivationPending"),
-          name: getFlag(flags, "name"),
-          page: parsePositiveIntFlag(getFlag(flags, "page"), "--page"),
-          perPage: parsePositiveIntFlag(getFlag(flags, "perPage"), "--perPage")
+          name: getFlag(flags, "name")
+        };
+        if (cmd === "count-items") {
+          for (const key of [
+            "limit",
+            "cursor",
+            "direction",
+            "sortBy",
+            "sortDir"
+          ])
+            if (flags[key] !== undefined)
+              throw new Error(`count-items does not accept --${key}; totals use filters only.`);
+          await countItems(filters);
+          break;
+        }
+        for (const key of ["limit", "cursor", "direction", "sortBy", "sortDir"])
+          rejectBareFlag(flags, key);
+        const cursor = getFlag(flags, "cursor");
+        if (cursor === "" || (cursor?.length ?? 0) > 8192)
+          throw new Error("--cursor must be a non-empty opaque token of at most 8192 characters.");
+        const direction = parseProjectDirection(getFlag(flags, "direction"));
+        if (direction === "backward" && !cursor)
+          throw new Error("--direction backward requires --cursor <token>.");
+        const sortBy = getFlag(flags, "sortBy");
+        const sortId = INVENTORY_SORT_IDS.find((id) => id === sortBy);
+        if (sortBy !== undefined && !sortId)
+          throw new Error(`Invalid --sortBy "${sortBy}". Use one of: ${INVENTORY_SORT_IDS.join(", ")}.`);
+        const sortDir = getFlag(flags, "sortDir");
+        if (sortDir !== undefined && sortDir !== "asc" && sortDir !== "desc")
+          throw new Error('--sortDir must be "asc" or "desc".');
+        await listItems({
+          ...filters,
+          limit: parseProjectLimit(getFlag(flags, "limit")),
+          cursor,
+          direction,
+          sort: sortId ? [{ id: sortId, desc: sortDir !== "asc" }] : undefined
         });
         break;
       }
@@ -13971,6 +15325,14 @@ Waiting for approval\u2026
         await getItem(id);
         break;
       }
+      case "get-item-quickbooks-sync-status": {
+        const id = positional[0];
+        if (!id) {
+          throw new Error("get-item-quickbooks-sync-status requires <itemId>");
+        }
+        await getItemQuickBooksSyncStatus(id);
+        break;
+      }
       case "create-item": {
         const payloadRaw = getFlag(flags, "payload");
         if (!payloadRaw) {
@@ -14008,10 +15370,45 @@ Waiting for approval\u2026
         await archiveItemsByIds(ids);
         break;
       }
-      case "list-item-categories": {
+      case "list-item-categories":
+      case "count-item-categories": {
+        rejectRetiredPageFlags(flags);
+        const filters = { name: getFlag(flags, "name") };
+        if (cmd === "count-item-categories") {
+          for (const key of [
+            "limit",
+            "cursor",
+            "direction",
+            "sortBy",
+            "sortDir"
+          ])
+            if (flags[key] !== undefined)
+              throw new Error(`count-item-categories does not accept --${key}; totals use filters only.`);
+          await countItemCategories(filters);
+          break;
+        }
+        for (const key of ["limit", "cursor", "direction", "sortBy", "sortDir"])
+          rejectBareFlag(flags, key);
+        const cursor = getFlag(flags, "cursor");
+        if (cursor === "" || (cursor?.length ?? 0) > 8192)
+          throw new Error("--cursor must be a non-empty opaque token of at most 8192 characters.");
+        const direction = parseProjectDirection(getFlag(flags, "direction"));
+        if (direction === "backward" && !cursor)
+          throw new Error("--direction backward requires --cursor <token>.");
+        const sortByRaw = getFlag(flags, "sortBy");
+        const sortBy = ITEM_CATEGORY_SORT_IDS.find((id) => id === sortByRaw);
+        if (sortByRaw !== undefined && !sortBy)
+          throw new Error(`Invalid --sortBy "${sortByRaw}". Use one of: ${ITEM_CATEGORY_SORT_IDS.join(", ")}.`);
+        const sortDir = getFlag(flags, "sortDir");
+        if (sortDir !== undefined && sortDir !== "asc" && sortDir !== "desc")
+          throw new Error('--sortDir must be "asc" or "desc".');
         await listItemCategories({
-          page: parsePositiveIntFlag(getFlag(flags, "page"), "--page"),
-          perPage: parsePositiveIntFlag(getFlag(flags, "perPage"), "--perPage")
+          ...filters,
+          limit: parseProjectLimit(getFlag(flags, "limit")),
+          cursor,
+          direction,
+          sortBy,
+          sortDir
         });
         break;
       }
@@ -14043,8 +15440,29 @@ Waiting for approval\u2026
         await deleteItemCategoriesByIds(ids);
         break;
       }
-      case "list-users": {
-        await listUsers();
+      case "list-users":
+      case "count-users": {
+        rejectRetiredPageFlags(flags);
+        const q = getFlag(flags, "q");
+        if (cmd === "count-users") {
+          for (const key of ["limit", "cursor"])
+            if (flags[key] !== undefined)
+              throw new Error(`count-users does not accept --${key}; totals use --q only.`);
+          await countUsers({ q });
+          break;
+        }
+        for (const key of ["limit", "cursor"])
+          rejectBareFlag(flags, key);
+        if (flags.direction !== undefined)
+          throw new Error("list-users pages forward only; follow pageInfo.nextCursor with --cursor.");
+        const cursor = getFlag(flags, "cursor");
+        if (cursor === "" || (cursor?.length ?? 0) > 8192)
+          throw new Error("--cursor must be a non-empty opaque token of at most 8192 characters.");
+        await listUsers({
+          q,
+          limit: parseProjectLimit(getFlag(flags, "limit")),
+          cursor
+        });
         break;
       }
       case "create-user": {
@@ -14069,7 +15487,23 @@ Waiting for approval\u2026
         break;
       }
       case "list-api-keys": {
-        await listApiKeysForUser({ userId: getFlag(flags, "userId") });
+        rejectRetiredPageFlags(flags);
+        for (const key of ["limit", "cursor"])
+          rejectBareFlag(flags, key);
+        if (flags.direction !== undefined)
+          throw new Error("list-api-keys pages forward only; follow pageInfo.nextCursor with --cursor.");
+        const cursor = getFlag(flags, "cursor");
+        if (cursor === "" || (cursor?.length ?? 0) > 8192)
+          throw new Error("--cursor must be a non-empty opaque token of at most 8192 characters.");
+        const limitFlag = getFlag(flags, "limit");
+        const limit = limitFlag === undefined ? undefined : Number(limitFlag);
+        if (limit !== undefined && (!Number.isInteger(limit) || limit < 1 || limit > 100))
+          throw new Error("--limit must be an integer from 1 to 100.");
+        await listApiKeysForUser({
+          userId: getFlag(flags, "userId"),
+          limit,
+          cursor
+        });
         break;
       }
       case "revoke-api-key": {
@@ -14114,29 +15548,81 @@ Waiting for approval\u2026
         });
         break;
       }
-      case "get-recent-errors": {
-        await getRecentErrors({
-          page: parsePositiveIntFlag(getFlag(flags, "page"), "--page"),
-          perPage: parsePositiveIntFlag(getFlag(flags, "perPage"), "--perPage"),
+      case "get-recent-errors":
+      case "count-errors": {
+        if (getFlag(flags, "page") !== undefined || getFlag(flags, "perPage") !== undefined) {
+          throw new Error("Error logs now use --cursor and --limit; --page/--perPage are no longer supported.");
+        }
+        const rawTimeFrame = getFlag(flags, "timeFrame");
+        const timeFrame = Object.values(ChartTimeFrame).find((value) => value === rawTimeFrame);
+        if (rawTimeFrame !== undefined && timeFrame === undefined) {
+          throw new Error(`Invalid --timeFrame. Use ${Object.values(ChartTimeFrame).join(", ")}.`);
+        }
+        const filters = {
           severity: parseOptionalErrorSeverity(getFlag(flags, "severity")),
-          status: parseOptionalErrorStatus(getFlag(flags, "status"))
-        });
+          status: parseOptionalErrorStatus(getFlag(flags, "status")),
+          timeFrame
+        };
+        if (cmd === "count-errors") {
+          await countErrors(filters);
+        } else {
+          const direction = getFlag(flags, "direction");
+          if (direction !== undefined && direction !== "forward" && direction !== "backward") {
+            throw new Error("--direction must be forward or backward.");
+          }
+          await getRecentErrors({
+            ...filters,
+            cursor: getFlag(flags, "cursor"),
+            limit: parsePositiveIntFlag(getFlag(flags, "limit"), "--limit"),
+            direction
+          });
+        }
         break;
       }
       case "get-error-metrics": {
         await getErrorMetrics();
         break;
       }
-      case "list-integration-operations": {
-        await listIntegrationOperations({
+      case "list-integration-operations":
+      case "count-integration-operations": {
+        rejectRetiredPageFlags(flags);
+        const filters = {
           destination: parseCommaSeparatedIds(getFlag(flags, "destination")),
-          page: parsePositiveIntFlag(getFlag(flags, "page"), "--page") ?? 1,
-          perPage: parsePositiveIntFlag(getFlag(flags, "perPage"), "--perPage") ?? 25,
           search: getFlag(flags, "search"),
           status: parseCommaSeparatedIntegrationOperationStatuses(getFlag(flags, "status"))
+        };
+        if (cmd === "count-integration-operations") {
+          for (const key of ["limit", "cursor", "direction"])
+            if (flags[key] !== undefined)
+              throw new Error(`count-integration-operations does not accept --${key}; totals use filters only.`);
+          await countIntegrationOperations(filters);
+          break;
+        }
+        for (const key of ["limit", "cursor", "direction"])
+          rejectBareFlag(flags, key);
+        const cursor = getFlag(flags, "cursor");
+        if (cursor === "" || (cursor?.length ?? 0) > 8192)
+          throw new Error("--cursor must be a non-empty opaque token of at most 8192 characters.");
+        const direction = parseProjectDirection(getFlag(flags, "direction"));
+        if (direction === "backward" && !cursor)
+          throw new Error("--direction backward requires --cursor <token>.");
+        const limitRaw = getFlag(flags, "limit");
+        await listIntegrationOperations({
+          ...filters,
+          limit: limitRaw === undefined ? 25 : parseProjectLimit(limitRaw),
+          cursor,
+          direction
         });
         break;
       }
+      case "get-integration-operation": {
+        const operationId = positional[0];
+        if (!operationId) {
+          throw new Error("get-integration-operation requires <operationId>");
+        }
+        await getIntegrationOperation(operationId);
+        break;
+      }
       case "retry-integration-operation": {
         const operationId = positional[0];
         if (!operationId) {
@@ -14149,13 +15635,153 @@ Waiting for approval\u2026
         await retryIntegrationOperation(operationId, parseOptionalBoolFlag(flags, "confirmExternalStateReconciled") ?? false, outboundEmailResolution, getFlag(flags, "providerMessageId"));
         break;
       }
-      case "list-inbound-sources": {
-        await listInboundSources({
-          page: parsePositiveIntFlag(getFlag(flags, "page"), "--page") ?? 1,
-          perPage: parsePositiveIntFlag(getFlag(flags, "perPage"), "--perPage") ?? 25
+      case "list-webhook-event-types": {
+        await listWebhookEventTypes();
+        break;
+      }
+      case "list-webhook-endpoints": {
+        await listWebhookEndpoints();
+        break;
+      }
+      case "get-webhook-endpoint": {
+        const id = positional[0];
+        if (!id)
+          throw new Error("get-webhook-endpoint requires <id>");
+        await getWebhookEndpoint(id);
+        break;
+      }
+      case "create-webhook-endpoint": {
+        const name = getFlag(flags, "name");
+        const url = getFlag(flags, "url");
+        const events = parseCommaSeparatedIds(getFlag(flags, "events"));
+        if (!name || !url || !events?.length)
+          throw new Error("create-webhook-endpoint requires --name, --url and --events");
+        await createWebhookEndpoint({
+          name,
+          url,
+          eventPatterns: events,
+          enabled: parseOptionalBoolFlag(flags, "enabled") ?? true
+        });
+        break;
+      }
+      case "update-webhook-endpoint": {
+        const id = positional[0];
+        if (!id)
+          throw new Error("update-webhook-endpoint requires <id>");
+        const events = parseCommaSeparatedIds(getFlag(flags, "events"));
+        await updateWebhookEndpoint({
+          id,
+          name: getFlag(flags, "name"),
+          url: getFlag(flags, "url"),
+          eventPatterns: events?.length ? events : undefined,
+          enabled: parseOptionalBoolFlag(flags, "enabled")
+        });
+        break;
+      }
+      case "delete-webhook-endpoint": {
+        const id = positional[0];
+        if (!id)
+          throw new Error("delete-webhook-endpoint requires <id>");
+        await deleteWebhookEndpoint(id);
+        break;
+      }
+      case "rotate-webhook-secret": {
+        const id = positional[0];
+        if (!id)
+          throw new Error("rotate-webhook-secret requires <id>");
+        const ttl = getFlag(flags, "previousSecretTtlHours");
+        await rotateWebhookSecret({
+          id,
+          previousSecretTtlHours: ttl === undefined ? undefined : Number.parseInt(ttl, 10)
+        });
+        break;
+      }
+      case "send-webhook-test-event": {
+        const id = positional[0];
+        if (!id)
+          throw new Error("send-webhook-test-event requires <id>");
+        await sendWebhookTestEvent(id);
+        break;
+      }
+      case "list-webhook-deliveries": {
+        const status = getFlag(flags, "status");
+        if (status && status !== "PENDING" && status !== "SUCCEEDED" && status !== "FAILED")
+          throw new Error("--status must be PENDING, SUCCEEDED or FAILED");
+        await listWebhookDeliveries({
+          endpointId: getFlag(flags, "endpointId"),
+          status,
+          eventType: getFlag(flags, "eventType"),
+          cursor: getFlag(flags, "cursor"),
+          limit: parsePositiveIntFlag(getFlag(flags, "limit"), "--limit")
         });
         break;
       }
+      case "get-webhook-delivery": {
+        const id = positional[0];
+        if (!id)
+          throw new Error("get-webhook-delivery requires <id>");
+        await getWebhookDelivery(id);
+        break;
+      }
+      case "replay-webhook-delivery": {
+        const id = positional[0];
+        if (!id)
+          throw new Error("replay-webhook-delivery requires <id>");
+        await replayWebhookDelivery(id);
+        break;
+      }
+      case "reconcile-resource-operation": {
+        const operationId = positional[0];
+        if (!operationId) {
+          throw new Error("reconcile-resource-operation requires <operationId>");
+        }
+        await reconcileResourceOperation(operationId);
+        break;
+      }
+      case "list-inbound-sources":
+      case "count-inbound-sources": {
+        if (flags.page !== undefined || flags.perPage !== undefined)
+          throw new Error("Inbound sources now use --limit/--cursor/--direction; --page/--perPage are no longer supported.");
+        for (const key of ["search", "processingMode", "cursor", "direction"]) {
+          if (flags[key] === true)
+            throw new Error(`--${key} requires a value.`);
+        }
+        const enabled = flags.processingEnabled;
+        if (enabled !== undefined && enabled !== "true" && enabled !== "false")
+          throw new Error("--processingEnabled must be true or false.");
+        const mode = getFlag(flags, "processingMode");
+        const processingMode = Object.values(InboundProcessingMode).find((value) => value === mode);
+        if (mode !== undefined && processingMode === undefined)
+          throw new Error("Invalid --processingMode. Use ACTIVE, COLLECT_ONLY or SHADOW.");
+        const filters = {
+          search: getFlag(flags, "search"),
+          processingEnabled: enabled === undefined ? undefined : enabled === "true",
+          processingMode
+        };
+        if (cmd === "count-inbound-sources") {
+          if (["limit", "cursor", "direction"].some((key) => flags[key] !== undefined))
+            throw new Error("Source counts accept filters only, not pagination flags.");
+          await countInboundSources(filters);
+        } else {
+          const direction = getFlag(flags, "direction") ?? "forward";
+          if (direction !== "forward" && direction !== "backward")
+            throw new Error("--direction must be forward or backward.");
+          const cursor = getFlag(flags, "cursor");
+          if (direction === "backward" && !cursor)
+            throw new Error("Backward source pagination requires --cursor.");
+          const rawLimit = flags.limit;
+          const limit = rawLimit === undefined ? 25 : Number(rawLimit);
+          if (rawLimit === true || !Number.isInteger(limit) || limit < 1 || limit > 100)
+            throw new Error("--limit must be an integer between 1 and 100.");
+          await listInboundSources({
+            ...filters,
+            cursor,
+            direction,
+            limit
+          });
+        }
+        break;
+      }
       case "create-inbound-source": {
         const name = getFlag(flags, "name");
         const externalSourceId = getFlag(flags, "formId");
@@ -14182,13 +15808,20 @@ Waiting for approval\u2026
         break;
       }
       case "list-inbound-submissions": {
+        if (getFlag(flags, "page") !== undefined || getFlag(flags, "perPage") !== undefined) {
+          throw new Error("Inbound submissions now use --limit and --cursor; --page/--perPage are no longer supported.");
+        }
         await listInboundSubmissions({
-          page: parsePositiveIntFlag(getFlag(flags, "page"), "--page") ?? 1,
-          perPage: parsePositiveIntFlag(getFlag(flags, "perPage"), "--perPage") ?? 25,
+          cursor: getFlag(flags, "cursor"),
+          limit: parsePositiveIntFlag(getFlag(flags, "limit"), "--limit") ?? 25,
           sourceId: getFlag(flags, "sourceId")
         });
         break;
       }
+      case "count-inbound-submissions": {
+        await countInboundSubmissions({ sourceId: getFlag(flags, "sourceId") });
+        break;
+      }
       case "get-inbound-submission": {
         const submissionId = positional[0];
         if (!submissionId) {