@thinkingai/ae-cli 6.1.12 → 6.1.14

package/dist/{te-analysis-GJI5FZUL.js → te-analysis-FCHRTNIY.js}

@@ -1,28 +1,38 @@
+import {
+  assertOutputPathAvailable,
+  clientWaitTimeoutSeconds,
+  downloadAnalysisArtifact,
+  validateLifecycleFlags,
+  waitForAnalysisRun,
+  withAsyncArtifactLifecycle,
+  withInterruptSignal
+} from "./chunk-UIHQJK5E.js";
 import {
   createCapabilityCommand
-} from "./chunk-7KQWSBSL.js";
+} from "./chunk-753BUTNZ.js";
 import {
   registerCapabilityGatewayRoute,
   resolveGatewayDomain
 } from "./chunk-PTE56QPL.js";
 import {
   withOutputMetadata
-} from "./chunk-YTG6Q75E.js";
+} from "./chunk-WZRX4KOH.js";
 import {
   CapabilityGatewayError,
   buildCapabilityGatewayUrl,
   dryRunCapability,
   executeCapability,
   executeCapabilityWithEnvelope,
-  fetchCapabilityGateway,
   requestCapabilityGateway,
   requestCapabilityGatewayWithEnvelope,
   uploadInputFile,
   validateCapability
-} from "./chunk-RBNKI5ZW.js";
-import "./chunk-Z3OXWCIA.js";
-import "./chunk-YV52FB5G.js";
-import "./chunk-GJJA4CQZ.js";
+} from "./chunk-5XUSIK27.js";
+import {
+  getCliToken
+} from "./chunk-S5NTSDBS.js";
+import "./chunk-ZQKDZXDO.js";
+import "./chunk-3FY3RJ26.js";
 import {
   CliValidationError
 } from "./chunk-AXDXJTPC.js";
@@ -30,15 +40,17 @@ import "./chunk-JHENBQ5B.js";
 
 // src/commands/te-analysis/capability-shared.ts
 var ANALYSIS_GATEWAY_CLI_SERVICES = /* @__PURE__ */ new Set(["project", "system"]);
-var analysisDataRunRoutingHelp = "Routing: use run only for analysis data that fits <=1000 inline rows and <=180s; use export for full, unknown-size, >1000-row, or long-running data.";
-var analysisDataExportRoutingHelp = "Routing: use export for full, unknown-size, >1000-row, or long-running analysis data; inspect/download by run_id/artifact_id; use run only for <=1000-row inline previews.";
+var analysisDataRunRoutingHelp = "Routing: --preview-rows bounds returned business rows per result; omit it to use the model current cluster-configured synchronous limit. Agents should normally pass --preview-rows 100. Use export for full, unknown-size, timed-out, or long-running data.";
+var analysisDataExportRoutingHelp = "Routing: use export for full, unknown-size, timed-out, or long-running analysis data. Plain export submits only; --wait waits, --output waits and atomically downloads, and analysis run wait resumes by run_id. Export commands do not accept --preview-rows.";
 function createAnalysisCapabilityCommand(config) {
   const cliPath = resolveAnalysisGatewayCliPath(config);
-  return createCapabilityCommand({
-    ...config,
+  const { asyncArtifact, ...coreConfig } = config;
+  const command = createCapabilityCommand({
+    ...coreConfig,
     ...cliPath,
     gatewayDomain: "analysis"
   });
+  return asyncArtifact ? withAsyncArtifactLifecycle(command, typeof asyncArtifact === "object" ? asyncArtifact : void 0) : command;
 }
 function resolveAnalysisGatewayCliPath(config) {
   const [capabilityService, capabilityResource, capabilityAction, ...extraSegments] = config.capabilityId.split(".");
@@ -65,18 +77,22 @@ function resolveAnalysisGatewayCliPath(config) {
   return { cliService: capabilityService, resource, command };
 }
 function createAnalysisMetaCapabilityCommand(config) {
-  return createCapabilityCommand({
-    ...config,
+  const { asyncArtifact, ...coreConfig } = config;
+  const command = createCapabilityCommand({
+    ...coreConfig,
     cliService: "analysis-meta",
     gatewayDomain: "analysis"
   });
+  return asyncArtifact ? withAsyncArtifactLifecycle(command, typeof asyncArtifact === "object" ? asyncArtifact : void 0) : command;
 }
 function createAnalysisGovernanceCapabilityCommand(config) {
-  return createCapabilityCommand({
-    ...config,
+  const { asyncArtifact, ...coreConfig } = config;
+  const command = createCapabilityCommand({
+    ...coreConfig,
     cliService: "analysis-governance",
     gatewayDomain: "analysis"
   });
+  return asyncArtifact ? withAsyncArtifactLifecycle(command, typeof asyncArtifact === "object" ? asyncArtifact : void 0) : command;
 }
 var projectIdFlag = {
   name: "project-id",
@@ -106,20 +122,22 @@ var limitFlag = {
   desc: "Optional inline result limit.",
   alias: "l"
 };
-var directoryLimitFlag = {
-  name: "limit",
+var previewRowsFlag = {
+  name: "preview-rows",
   type: "number",
   required: false,
-  desc: "Directory page size. Default: 50, max: 200. Values outside 1..200 are rejected.",
-  alias: "l",
-  min: 1,
-  max: 200
+  desc: "Maximum business rows returned per result. Omit to use the current model/cluster synchronous limit. The runtime maximum varies by model; agents should normally pass 100.",
+  min: 1
 };
-var memberLimitFlag = {
+var analysisModelPreviewRowsFlag = {
+  ...previewRowsFlag,
+  desc: "Maximum synchronous preview units returned per result. Units are business rows for tabular results. For path results, this limits real nodes per path level before overflow nodes are combined into more. Omit to use the current model/cluster synchronous limit. The runtime maximum varies by model; agents should normally pass 100."
+};
+var directoryLimitFlag = {
   name: "limit",
   type: "number",
   required: false,
-  desc: "Bounded member row limit. Default: 50, max: 200. Values outside 1..200 are rejected.",
+  desc: "Directory page size. Default: 50, max: 200. Values outside 1..200 are rejected.",
   alias: "l",
   min: 1,
   max: 200
@@ -145,24 +163,6 @@ var reportModelTypesFlag = {
   required: false,
   desc: 'Optional semantic report model JSON array, for example ["event","sql","tag","revenue"].'
 };
-var syncLimitFlag = {
-  name: "limit",
-  type: "number",
-  required: false,
-  desc: "Maximum inline rows for sync query results. Default: 100, max: 1000. Use export for full data.",
-  alias: "l",
-  min: 1,
-  max: 1e3
-};
-var detailPreviewLimitFlag = {
-  name: "limit",
-  type: "number",
-  required: false,
-  desc: "Maximum first preview rows. Default: 100, max: 1000. This is not a pagination window; use export for more rows.",
-  alias: "l",
-  min: 1,
-  max: 1e3
-};
 var offsetFlag = {
   name: "offset",
   type: "number",
@@ -170,6 +170,14 @@ var offsetFlag = {
   desc: "Optional zero-based result offset.",
   alias: "o"
 };
+var directoryOffsetFlag = {
+  name: "offset",
+  type: "number",
+  required: false,
+  desc: "Zero-based directory page offset. Default: 0. Negative values are rejected.",
+  alias: "o",
+  min: 0
+};
 var payloadFlag = {
   name: "payload",
   type: "json",
@@ -250,7 +258,7 @@ function projectInput(ctx) {
 function listInput(ctx) {
   return compactInput({
     ...projectInput(ctx),
-    query: optionalString(ctx, "query"),
+    queries: optionalJson(ctx, "queries"),
     fields: optionalJson(ctx, "fields"),
     limit: optionalNumber(ctx, "limit"),
     offset: optionalNumber(ctx, "offset")
@@ -275,8 +283,8 @@ function dashboardReportDataInput(ctx) {
     zone_offset: optionalNumber(ctx, "zone-offset"),
     use_cache: optionalBoolean(ctx, "use-cache"),
     request_id: optionalString(ctx, "request-id"),
+    preview_rows: optionalNumber(ctx, "preview-rows"),
     timeout_seconds: optionalNumber(ctx, "timeout-seconds"),
-    limit: optionalNumber(ctx, "limit"),
     format: optionalString(ctx, "artifact-format")
   });
 }
@@ -298,14 +306,10 @@ function biPanelPageDataInput(ctx) {
     permission_controls: optionalJson(ctx, "permission-controls"),
     chart_filter_controls: optionalJson(ctx, "chart-filter-controls"),
     columns: optionalJson(ctx, "columns"),
-    row_limit: optionalNumber(ctx, "row-limit"),
-    row_offset: optionalNumber(ctx, "row-offset"),
-    block_limit: optionalNumber(ctx, "block-limit"),
-    block_offset: optionalNumber(ctx, "block-offset"),
     use_cache: optionalBoolean(ctx, "use-cache"),
     request_id: optionalString(ctx, "request-id"),
+    preview_rows: optionalNumber(ctx, "preview-rows"),
     timeout_seconds: optionalNumber(ctx, "timeout-seconds"),
-    limit: optionalNumber(ctx, "limit"),
     format: optionalString(ctx, "artifact-format")
   });
 }
@@ -350,57 +354,280 @@ function compactInput(input) {
   }
   return result;
 }
-function applyAnalysisInlineLimit(result, input) {
-  const limit = typeof input.limit === "number" && Number.isInteger(input.limit) && input.limit > 0 ? input.limit : void 0;
-  if (!limit) {
-    return result;
+
+// src/commands/te-analysis/catalog-list.ts
+import { createHash, randomBytes } from "crypto";
+import { createReadStream } from "fs";
+import { chmod, lstat, mkdir, open, rename, rm } from "fs/promises";
+import { basename, dirname, extname, join, resolve } from "path";
+var queriesFlag = {
+  name: "queries",
+  type: "json",
+  required: false,
+  desc: "Optional JSON array of 1 to 20 keyword filters. Results match any keyword."
+};
+var catalogExportOutputFlag = {
+  name: "output",
+  type: "string",
+  required: true,
+  desc: "JSONL output file path. Full rows stay in this file; completeness and identity metadata is written to the adjacent .meta.json file."
+};
+function validateCatalogListFlags(ctx) {
+  validateQueriesFlag(ctx);
+}
+function validateCatalogExportFlags(ctx) {
+  validateQueriesFlag(ctx);
+  const output = ctx.str("output");
+  if (!output) {
+    throw new CliValidationError("--output is required");
   }
-  const cloned = cloneJsonLike(result);
-  const summary = {
-    truncated: false,
-    containers: 0,
-    originalRows: 0,
-    returnedRows: 0
+  if (extname(output).toLowerCase() !== ".jsonl") {
+    throw new CliValidationError("--output must use the .jsonl extension");
+  }
+}
+function catalogArtifactMaterializer(resourceType) {
+  return async ({
+    ctx,
+    runId,
+    artifactId,
+    output,
+    force,
+    signal,
+    finalDescriptor
+  }) => {
+    const outputPath = resolve(output);
+    const metaPath = join(
+      dirname(outputPath),
+      `${basename(outputPath, extname(outputPath))}.meta.json`
+    );
+    await mkdir(dirname(outputPath), { recursive: true });
+    await assertRegularFileOrMissing(outputPath, force);
+    await assertRegularFileOrMissing(metaPath, force);
+    const suffix = `${process.pid}.${randomBytes(8).toString("hex")}`;
+    const partPath = `${outputPath}.part.${suffix}`;
+    const metaPartPath = `${metaPath}.part.${suffix}`;
+    let handle;
+    try {
+      const download = await downloadAnalysisArtifact(
+        ctx.host(),
+        runId,
+        artifactId,
+        partPath,
+        { force: true, signal, ensureReady: false }
+      );
+      const hash = createHash("sha256");
+      let bytes = 0;
+      let rows = 0;
+      for await (const chunk of createReadStream(partPath)) {
+        const buffer = Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk);
+        hash.update(buffer);
+        bytes += buffer.length;
+        for (const value of buffer) {
+          if (value === 10) rows++;
+        }
+      }
+      const contentSha256 = hash.digest("hex");
+      const token = await getCliToken(ctx.host());
+      const metadata = {
+        schema_version: 1,
+        resource_type: resourceType,
+        host: ctx.host(),
+        project_id: ctx.num("project-id"),
+        principal_fingerprint: `sha256:${createHash("sha256").update(token).digest("hex")}`,
+        generated_at: (/* @__PURE__ */ new Date()).toISOString(),
+        row_count: rows,
+        complete: true,
+        content_sha256: contentSha256,
+        run_id: runId,
+        artifact_id: artifactId
+      };
+      handle = await open(metaPartPath, "w", 384);
+      await handle.write(`${JSON.stringify(metadata)}
+`, void 0, "utf8");
+      await handle.sync();
+      await handle.close();
+      handle = void 0;
+      await publishCatalogPair(partPath, outputPath, metaPartPath, metaPath, suffix);
+      return {
+        ...finalDescriptor,
+        ...download,
+        output_path: outputPath,
+        metadata_path: metaPath,
+        format: "jsonl",
+        row_count: rows,
+        bytes,
+        content_sha256: contentSha256,
+        complete: true
+      };
+    } catch (error) {
+      await handle?.close().catch(() => void 0);
+      await rm(partPath, { force: true }).catch(() => void 0);
+      await rm(metaPartPath, { force: true }).catch(() => void 0);
+      throw error;
+    }
   };
-  trimRows(cloned, limit, summary);
-  if (summary.truncated && cloned && typeof cloned === "object" && !Array.isArray(cloned)) {
-    cloned._cli_inline_limit = {
-      requested_limit: limit,
-      containers_truncated: summary.containers,
-      original_rows: summary.originalRows,
-      returned_rows: summary.returnedRows,
-      note: "Rows were truncated by ae-cli to keep sync run output within the inline limit. Use export for full data."
-    };
+}
+async function preflightCatalogArtifactOutput({
+  output,
+  force
+}) {
+  const outputPath = resolve(output);
+  const metaPath = join(
+    dirname(outputPath),
+    `${basename(outputPath, extname(outputPath))}.meta.json`
+  );
+  await assertRegularFileOrMissing(outputPath, force);
+  await assertRegularFileOrMissing(metaPath, force);
+}
+function validateQueriesFlag(ctx) {
+  const queries = ctx.json("queries");
+  if (queries === void 0 || queries === null) return;
+  if (!Array.isArray(queries) || queries.length < 1 || queries.length > 20 || queries.some((query) => typeof query !== "string" || query.trim().length === 0)) {
+    throw new CliValidationError("--queries must be a JSON array containing 1 to 20 non-empty strings");
   }
-  return cloned;
 }
-function cloneJsonLike(value) {
-  if (value === void 0 || value === null) return value;
-  return JSON.parse(JSON.stringify(value));
+function optionalQueries(ctx) {
+  const value = ctx.json("queries");
+  return value === void 0 || value === null ? void 0 : value;
+}
+function catalogExportPostProcess(resourceType, arrayField) {
+  return async (result, input, ctx) => {
+    if (typeof result !== "object" || result === null) {
+      throw new Error(`Full ${resourceType} catalog returned an invalid response`);
+    }
+    const data = result;
+    const rows = data[arrayField];
+    if (!Array.isArray(rows)) {
+      throw new Error(`Full ${resourceType} catalog response is missing ${arrayField}`);
+    }
+    if (data.complete !== true || typeof data.total !== "number" || data.total !== rows.length) {
+      throw new Error(
+        `Full ${resourceType} catalog is incomplete: total=${String(data.total)}, rows=${rows.length}, complete=${String(data.complete)}`
+      );
+    }
+    const outputPath = resolve(ctx.str("output"));
+    const metaPath = join(
+      dirname(outputPath),
+      `${basename(outputPath, extname(outputPath))}.meta.json`
+    );
+    await mkdir(dirname(outputPath), { recursive: true });
+    await assertRegularFileOrMissing(outputPath);
+    await assertRegularFileOrMissing(metaPath);
+    const suffix = `${process.pid}.${randomBytes(8).toString("hex")}`;
+    const partPath = `${outputPath}.part.${suffix}`;
+    const metaPartPath = `${metaPath}.part.${suffix}`;
+    const hash = createHash("sha256");
+    let bytes = 0;
+    let handle;
+    try {
+      handle = await open(partPath, "w", 384);
+      for (const row of rows) {
+        const line = `${JSON.stringify(row)}
+`;
+        const buffer = Buffer.from(line, "utf8");
+        hash.update(buffer);
+        bytes += buffer.length;
+        await handle.write(buffer);
+      }
+      await handle.sync();
+      await handle.close();
+      handle = void 0;
+      const contentSha256 = hash.digest("hex");
+      const token = await getCliToken(ctx.host());
+      const metadata = {
+        schema_version: 1,
+        resource_type: resourceType,
+        host: ctx.host(),
+        project_id: input.project_id,
+        principal_fingerprint: `sha256:${createHash("sha256").update(token).digest("hex")}`,
+        generated_at: (/* @__PURE__ */ new Date()).toISOString(),
+        row_count: rows.length,
+        complete: true,
+        content_sha256: contentSha256
+      };
+      handle = await open(metaPartPath, "w", 384);
+      await handle.write(`${JSON.stringify(metadata)}
+`, void 0, "utf8");
+      await handle.sync();
+      await handle.close();
+      handle = void 0;
+      await publishCatalogPair(partPath, outputPath, metaPartPath, metaPath, suffix);
+      return {
+        resource_type: resourceType,
+        output_path: outputPath,
+        metadata_path: metaPath,
+        format: "jsonl",
+        row_count: rows.length,
+        bytes,
+        content_sha256: contentSha256,
+        complete: true
+      };
+    } catch (error) {
+      await handle?.close().catch(() => void 0);
+      await rm(partPath, { force: true }).catch(() => void 0);
+      await rm(metaPartPath, { force: true }).catch(() => void 0);
+      throw error;
+    }
+  };
 }
-function trimRows(value, limit, summary) {
-  if (!value || typeof value !== "object") return;
-  if (Array.isArray(value)) {
-    for (const item of value) trimRows(item, limit, summary);
-    return;
+async function assertRegularFileOrMissing(filePath, allowReplace = true) {
+  try {
+    const value = await lstat(filePath);
+    if (!value.isFile()) {
+      throw new Error(`Catalog output path must be a regular file: ${filePath}`);
+    }
+    if (!allowReplace) {
+      throw new Error(`Catalog output path already exists: ${filePath}. Use --force to replace it.`);
+    }
+  } catch (error) {
+    if (error.code !== "ENOENT") {
+      throw error;
+    }
   }
-  const record = value;
-  const rows = record.rows;
-  if (Array.isArray(rows) && rows.length > limit) {
-    record.rows = rows.slice(0, limit);
-    record._cli_truncation = {
-      field: "rows",
-      requested_limit: limit,
-      original_row_count: rows.length,
-      returned_row_count: limit
-    };
-    summary.truncated = true;
-    summary.containers += 1;
-    summary.originalRows += rows.length;
-    summary.returnedRows += limit;
+}
+async function publishCatalogPair(dataPartPath, dataPath, metaPartPath, metaPath, suffix) {
+  const dataBackupPath = `${dataPath}.backup.${suffix}`;
+  const metaBackupPath = `${metaPath}.backup.${suffix}`;
+  let dataBackedUp = false;
+  let metaBackedUp = false;
+  let dataPublished = false;
+  let metaPublished = false;
+  try {
+    dataBackedUp = await moveIfExists(dataPath, dataBackupPath);
+    metaBackedUp = await moveIfExists(metaPath, metaBackupPath);
+    await rename(dataPartPath, dataPath);
+    dataPublished = true;
+    await chmod(dataPath, 384);
+    await rename(metaPartPath, metaPath);
+    metaPublished = true;
+    await chmod(metaPath, 384);
+    await rm(dataBackupPath, { force: true });
+    await rm(metaBackupPath, { force: true });
+  } catch (error) {
+    if (metaPublished) {
+      await rm(metaPath, { force: true }).catch(() => void 0);
+    }
+    if (dataPublished) {
+      await rm(dataPath, { force: true }).catch(() => void 0);
+    }
+    if (metaBackedUp) {
+      await rename(metaBackupPath, metaPath).catch(() => void 0);
+    }
+    if (dataBackedUp) {
+      await rename(dataBackupPath, dataPath).catch(() => void 0);
+    }
+    throw error;
   }
-  for (const child of Object.values(record)) {
-    trimRows(child, limit, summary);
+}
+async function moveIfExists(source, target) {
+  try {
+    await rename(source, target);
+    return true;
+  } catch (error) {
+    if (error.code === "ENOENT") {
+      return false;
+    }
+    throw error;
   }
 }
 
@@ -409,19 +636,20 @@ var metadataEventList = createAnalysisMetaCapabilityCommand({
   resource: "event",
   command: "list",
   capabilityId: "metadata.event.list",
-  description: "List project events with optional search, field projection, pagination, and authentication filtering.",
+  description: "List project events with batch keyword search and bounded pagination.",
   flags: [
     projectIdFlag,
-    queryFlag,
+    queriesFlag,
     fieldsFlag,
-    limitFlag,
-    offsetFlag,
+    directoryLimitFlag,
+    directoryOffsetFlag,
     { name: "authenticated-only", type: "boolean", required: false, desc: "When true, return only authenticated events." }
   ],
   risk: "read",
+  validate: validateCatalogListFlags,
   buildInput: (ctx) => compactInput({
     ...projectInput(ctx),
-    query: optionalString(ctx, "query"),
+    queries: optionalQueries(ctx),
     fields: optionalJson(ctx, "fields"),
     limit: optionalNumber(ctx, "limit"),
     offset: optionalNumber(ctx, "offset"),
@@ -429,6 +657,138 @@ var metadataEventList = createAnalysisMetaCapabilityCommand({
   })
 });
 
+// src/commands/te-analysis/metadata-export.ts
+import { createHash as createHash2, randomBytes as randomBytes2 } from "crypto";
+import { chmod as chmod2, lstat as lstat2, mkdir as mkdir2, open as open2, rename as rename2, rm as rm2 } from "fs/promises";
+import { dirname as dirname2, extname as extname2, resolve as resolve2 } from "path";
+var metadataExportOutputFlag = {
+  name: "output",
+  type: "string",
+  required: true,
+  desc: "Local .json output file for the complete matching metadata rows."
+};
+function validateMetadataExportFlags(ctx) {
+  validateQueriesFlag(ctx);
+  const output = ctx.str("output").trim();
+  if (output && extname2(output).toLowerCase() !== ".json") {
+    throw new CliValidationError("--output must use the .json extension");
+  }
+}
+function metadataExportPostProcess(resourceType, arrayField) {
+  return async (result, _input, ctx) => {
+    if (typeof result !== "object" || result === null) {
+      throw new Error(`Metadata ${resourceType} export returned an invalid response`);
+    }
+    const data = result;
+    const rows = data[arrayField];
+    if (!Array.isArray(rows)) {
+      throw new Error(`Metadata ${resourceType} export response is missing ${arrayField}`);
+    }
+    if (data.complete !== true || typeof data.total !== "number" || data.total !== rows.length) {
+      throw new Error(
+        `Metadata ${resourceType} export is incomplete: total=${String(data.total)}, rows=${rows.length}, complete=${String(data.complete)}`
+      );
+    }
+    const outputPath = resolve2(ctx.str("output").trim());
+    await mkdir2(dirname2(outputPath), { recursive: true });
+    await assertRegularFileOrMissing2(outputPath);
+    const suffix = `${process.pid}.${randomBytes2(8).toString("hex")}`;
+    const partPath = `${outputPath}.part.${suffix}`;
+    const content = `${JSON.stringify(rows, null, 2)}
+`;
+    const bytes = Buffer.byteLength(content, "utf8");
+    let handle;
+    try {
+      handle = await open2(partPath, "w", 384);
+      await handle.write(content, void 0, "utf8");
+      await handle.sync();
+      await handle.close();
+      handle = void 0;
+      await publishExport(partPath, outputPath, suffix);
+    } catch (error) {
+      await handle?.close().catch(() => void 0);
+      await rm2(partPath, { force: true }).catch(() => void 0);
+      throw error;
+    }
+    return {
+      resource_type: resourceType,
+      output_path: outputPath,
+      format: "json",
+      row_count: rows.length,
+      bytes,
+      content_sha256: createHash2("sha256").update(content).digest("hex"),
+      complete: true
+    };
+  };
+}
+async function publishExport(partPath, outputPath, suffix) {
+  const backupPath = `${outputPath}.backup.${suffix}`;
+  let backedUp = false;
+  let published = false;
+  try {
+    backedUp = await moveIfExists2(outputPath, backupPath);
+    await rename2(partPath, outputPath);
+    published = true;
+    await chmod2(outputPath, 384);
+    await rm2(backupPath, { force: true });
+  } catch (error) {
+    if (published) {
+      await rm2(outputPath, { force: true }).catch(() => void 0);
+    }
+    if (backedUp) {
+      await rename2(backupPath, outputPath).catch(() => void 0);
+    }
+    throw error;
+  }
+}
+async function moveIfExists2(source, target) {
+  try {
+    await rename2(source, target);
+    return true;
+  } catch (error) {
+    if (error.code === "ENOENT") {
+      return false;
+    }
+    throw error;
+  }
+}
+async function assertRegularFileOrMissing2(filePath) {
+  try {
+    const value = await lstat2(filePath);
+    if (!value.isFile()) {
+      throw new Error(`Metadata export output path must be a regular file: ${filePath}`);
+    }
+  } catch (error) {
+    if (error.code !== "ENOENT") {
+      throw error;
+    }
+  }
+}
+
+// src/commands/te-analysis/meta/event/export.ts
+var metadataEventExport = createAnalysisMetaCapabilityCommand({
+  resource: "event",
+  command: "export",
+  capabilityId: "metadata.event.export",
+  description: "Export every matching project event to one local JSON file without pagination.",
+  flags: [
+    projectIdFlag,
+    queriesFlag,
+    fieldsFlag,
+    { name: "authenticated-only", type: "boolean", required: false, desc: "When true, export only authenticated events." },
+    metadataExportOutputFlag
+  ],
+  risk: "read",
+  validate: validateMetadataExportFlags,
+  buildInput: (ctx) => compactInput({
+    ...projectInput(ctx),
+    queries: optionalQueries(ctx),
+    fields: optionalJson(ctx, "fields"),
+    authenticated_only: optionalBoolean(ctx, "authenticated-only")
+  }),
+  postProcess: metadataExportPostProcess("event", "events")
+});
+
 // src/commands/te-analysis/meta/event/get.ts
 var metadataEventGet = createAnalysisMetaCapabilityCommand({
   resource: "event",
@@ -547,6 +907,7 @@ var metadataEventChangelogList = createAnalysisMetaCapabilityCommand({
 // src/commands/te-analysis/meta/event/index.ts
 var commands = [
   metadataEventList,
+  metadataEventExport,
   metadataEventGet,
   metadataEventCreate,
   metadataEventUpdate,
@@ -563,25 +924,26 @@ var metadataPropertyList = createAnalysisMetaCapabilityCommand({
   resource: "property",
   command: "list",
   capabilityId: "metadata.property.list",
-  description: "List event or user properties with optional search, field projection, pagination, and authentication filtering.",
+  description: "List event, user, dimension-table, or complex child properties with batch keyword search and bounded pagination.",
   flags: [
     projectIdFlag,
     { name: "table-type", type: "string", required: false, desc: "Optional property table type: event or user." },
     { name: "scope", type: "string", required: false, desc: "Optional property scope: event or user." },
     { name: "event-name", type: "string", required: false, desc: "Optional event name filter for event properties." },
-    queryFlag,
+    queriesFlag,
     fieldsFlag,
-    limitFlag,
-    offsetFlag,
+    directoryLimitFlag,
+    directoryOffsetFlag,
     { name: "authenticated-only", type: "boolean", required: false, desc: "When true, return only authenticated properties." }
   ],
   risk: "read",
+  validate: validateCatalogListFlags,
   buildInput: (ctx) => compactInput({
     ...projectInput(ctx),
     table_type: optionalString(ctx, "table-type"),
     scope: optionalString(ctx, "scope"),
     event_name: optionalString(ctx, "event-name"),
-    query: optionalString(ctx, "query"),
+    queries: optionalQueries(ctx),
     fields: optionalJson(ctx, "fields"),
     limit: optionalNumber(ctx, "limit"),
     offset: optionalNumber(ctx, "offset"),
@@ -589,6 +951,36 @@ var metadataPropertyList = createAnalysisMetaCapabilityCommand({
   })
 });
 
+// src/commands/te-analysis/meta/property/export.ts
+var metadataPropertyExport = createAnalysisMetaCapabilityCommand({
+  resource: "property",
+  command: "export",
+  capabilityId: "metadata.property.export",
+  description: "Export every matching property to one local JSON file without pagination.",
+  flags: [
+    projectIdFlag,
+    { name: "table-type", type: "string", required: false, desc: "Optional property table type: event or user." },
+    { name: "scope", type: "string", required: false, desc: "Optional property scope: event or user." },
+    { name: "event-name", type: "string", required: false, desc: "Optional event name filter for event properties." },
+    queriesFlag,
+    fieldsFlag,
+    { name: "authenticated-only", type: "boolean", required: false, desc: "When true, export only authenticated properties." },
+    metadataExportOutputFlag
+  ],
+  risk: "read",
+  validate: validateMetadataExportFlags,
+  buildInput: (ctx) => compactInput({
+    ...projectInput(ctx),
+    table_type: optionalString(ctx, "table-type"),
+    scope: optionalString(ctx, "scope"),
+    event_name: optionalString(ctx, "event-name"),
+    queries: optionalQueries(ctx),
+    fields: optionalJson(ctx, "fields"),
+    authenticated_only: optionalBoolean(ctx, "authenticated-only")
+  }),
+  postProcess: metadataExportPostProcess("property", "properties")
+});
+
 // src/commands/te-analysis/meta/property/get.ts
 var metadataPropertyGet = createAnalysisMetaCapabilityCommand({
   resource: "property",
@@ -729,6 +1121,7 @@ var metadataPropertyRelatedEvents = createAnalysisMetaCapabilityCommand({
 // src/commands/te-analysis/meta/property/index.ts
 var commands2 = [
   metadataPropertyList,
+  metadataPropertyExport,
   metadataPropertyGet,
   metadataPropertyCreate,
   metadataPropertyUpdate,
@@ -831,7 +1224,7 @@ var metadataVirtualPropertyCreate = createAnalysisMetaCapabilityCommand({
   flags: [
     projectIdFlag,
     { name: "sql-expression", type: "string", required: true, desc: "SQL expression used to calculate the virtual property." },
-    { name: "v-prop", type: "json", required: false, desc: "Virtual property JSON object with property.column_name/table_type/select_type fields." },
+    { name: "v-prop", type: "json", required: false, desc: "Virtual property JSON object with property.column_name/property.table_type/property.select_type fields." },
     { name: "property-name", type: "string", required: false, desc: "Virtual property name. Must start with '#vp@'." },
     { name: "property-desc", type: "string", required: false, desc: "Virtual property display name." },
     { name: "table-type", type: "string", required: false, desc: "Property table type: event or user." },
@@ -888,7 +1281,7 @@ var metadataVirtualPropertySqlRuleUpdate = createAnalysisMetaCapabilityCommand({
   flags: [
     projectIdFlag,
     { name: "sql-expression", type: "string", required: true, desc: "SQL expression used to calculate the virtual property." },
-    { name: "v-prop", type: "json", required: true, desc: "Virtual property JSON object with prop_id/property fields." },
+    { name: "v-prop", type: "json", required: true, desc: "Virtual property JSON object with prop_id beside property." },
     { name: "properties", type: "json", required: false, desc: "Dependent property JSON array." },
     { name: "sql-event-relation-type", type: "string", required: false, desc: "relation_default, relation_always, or relation_by_setting." },
     { name: "related-events", type: "json", required: false, desc: "Related events JSON array when using relation_by_setting." },
@@ -938,21 +1331,22 @@ var metadataMetricList = createAnalysisMetaCapabilityCommand({
   resource: "metric",
   command: "list",
   capabilityId: "metadata.metric.list",
-  description: "List project metrics with optional search, projection, pagination, and authentication filtering.",
+  description: "List project metrics with batch keyword search and bounded pagination.",
   flags: [
     projectIdFlag,
     { name: "ignore-authentication", type: "boolean", required: false, desc: "Whether to skip asset authentication status decoration." },
-    queryFlag,
+    queriesFlag,
     fieldsFlag,
-    limitFlag,
-    offsetFlag,
+    directoryLimitFlag,
+    directoryOffsetFlag,
     { name: "authenticated-only", type: "boolean", required: false, desc: "When true, return only authenticated metrics." }
   ],
   risk: "read",
+  validate: validateCatalogListFlags,
   buildInput: (ctx) => compactInput({
     ...projectInput(ctx),
     ignore_authentication: optionalBoolean(ctx, "ignore-authentication"),
-    query: optionalString(ctx, "query"),
+    queries: optionalQueries(ctx),
     fields: optionalJson(ctx, "fields"),
     limit: optionalNumber(ctx, "limit"),
     offset: optionalNumber(ctx, "offset"),
@@ -960,6 +1354,32 @@ var metadataMetricList = createAnalysisMetaCapabilityCommand({
   })
 });
 
+// src/commands/te-analysis/meta/metric/export.ts
+var metadataMetricExport = createAnalysisMetaCapabilityCommand({
+  resource: "metric",
+  command: "export",
+  capabilityId: "metadata.metric.export",
+  description: "Export every matching project metric to one local JSON file without pagination.",
+  flags: [
+    projectIdFlag,
+    { name: "ignore-authentication", type: "boolean", required: false, desc: "Whether to skip asset authentication status decoration." },
+    queriesFlag,
+    fieldsFlag,
+    { name: "authenticated-only", type: "boolean", required: false, desc: "When true, export only authenticated metrics." },
+    metadataExportOutputFlag
+  ],
+  risk: "read",
+  validate: validateMetadataExportFlags,
+  buildInput: (ctx) => compactInput({
+    ...projectInput(ctx),
+    ignore_authentication: optionalBoolean(ctx, "ignore-authentication"),
+    queries: optionalQueries(ctx),
+    fields: optionalJson(ctx, "fields"),
+    authenticated_only: optionalBoolean(ctx, "authenticated-only")
+  }),
+  postProcess: metadataExportPostProcess("metric", "metrics")
+});
+
 // src/commands/te-analysis/meta/metric/get.ts
 var metadataMetricGet = createAnalysisMetaCapabilityCommand({
   resource: "metric",
@@ -976,16 +1396,7 @@ var metadataMetricGet = createAnalysisMetaCapabilityCommand({
 
 // src/commands/te-analysis/meta/metric/shared.ts
 function metricMode(ctx) {
-  const mode = optionalNumber(ctx, "metric-mode");
-  const modelType = optionalString(ctx, "model-type");
-  const mapped = modelType === void 0 ? void 0 : modelTypeToMetricMode(modelType);
-  if (mode === void 0 && mapped === void 0) {
-    throw new Error("Pass one of --model-type or --metric-mode");
-  }
-  if (mode !== void 0 && mapped !== void 0 && mode !== mapped) {
-    throw new Error("--metric-mode must match --model-type when both are provided");
-  }
-  return mode ?? mapped;
+  return modelTypeToMetricMode(ctx.str("model-type"));
 }
 function optionalMetricMode(ctx) {
   const mode = optionalNumber(ctx, "metric-mode");
@@ -1018,9 +1429,8 @@ var metadataMetricCreate = createAnalysisMetaCapabilityCommand({
     { name: "metric-name", type: "string", required: true, desc: "Metric technical name, for example pay_count." },
     { name: "metric-desc", type: "string", required: true, desc: "Metric display name." },
     { name: "metric-remark", type: "string", required: false, desc: "Metric remark." },
-    { name: "metric-mode", type: "number", required: false, desc: "Metric model mode, for example 0 for event analysis." },
-    { name: "model-type", type: "string", required: false, desc: "Semantic metric model type: event or retention. Prefer this over metric-mode." },
-    { name: "metric-events", type: "json", required: true, desc: "Metric event-analysis QP JSON array." },
+    { name: "model-type", type: "string", required: true, desc: "Semantic metric model type: event or retention." },
+    { name: "metric-events", type: "json", required: true, desc: "One semantic event-analysis definition, or a native snake_case QP array for compatibility." },
     { name: "metric-params", type: "json", required: false, desc: "Metric params JSON object. Defaults to {} in common when omitted." }
   ],
   risk: "write",
@@ -1082,6 +1492,7 @@ var metadataMetricDelete = createAnalysisMetaCapabilityCommand({
 // src/commands/te-analysis/meta/metric/index.ts
 var commands5 = [
   metadataMetricList,
+  metadataMetricExport,
   metadataMetricGet,
   metadataMetricCreate,
   metadataMetricUpdate,
@@ -1097,10 +1508,17 @@ var metadataAssetSearch = createAnalysisMetaCapabilityCommand({
   description: "Search project assets by keyword.",
   flags: [
     projectIdFlag,
-    requiredPayloadFlag
+    requiredPayloadFlag,
+    directoryLimitFlag,
+    directoryOffsetFlag
   ],
   risk: "read",
-  buildInput: (ctx) => ({ ...projectInput(ctx), payload: ctx.json("payload") })
+  buildInput: (ctx) => compactInput({
+    ...projectInput(ctx),
+    payload: ctx.json("payload"),
+    limit: optionalNumber(ctx, "limit"),
+    offset: optionalNumber(ctx, "offset")
+  })
 });
 
 // src/commands/te-analysis/meta/asset/recent-list.ts
@@ -1124,10 +1542,16 @@ var metadataAssetAuthenticationList = createAnalysisMetaCapabilityCommand({
   capabilityId: "metadata.asset_authentication.list",
   description: "List authenticatable project assets and authentication status.",
   flags: [
-    projectIdFlag
+    projectIdFlag,
+    directoryLimitFlag,
+    directoryOffsetFlag
   ],
   risk: "read",
-  buildInput: projectInput
+  buildInput: (ctx) => compactInput({
+    ...projectInput(ctx),
+    limit: optionalNumber(ctx, "limit"),
+    offset: optionalNumber(ctx, "offset")
+  })
 });
 
 // src/commands/te-analysis/meta/asset/authentication-update.ts
@@ -1152,10 +1576,17 @@ var metadataAssetAbnormalList = createAnalysisMetaCapabilityCommand({
   description: "List abnormal assets by resource type.",
   flags: [
     projectIdFlag,
-    { name: "resource-types", type: "string", required: true, desc: "Resource types to query." }
+    { name: "resource-types", type: "string", required: true, desc: "Resource types to query." },
+    directoryLimitFlag,
+    directoryOffsetFlag
   ],
   risk: "read",
-  buildInput: (ctx) => ({ ...projectInput(ctx), resource_types: ctx.str("resource-types") })
+  buildInput: (ctx) => compactInput({
+    ...projectInput(ctx),
+    resource_types: ctx.str("resource-types"),
+    limit: optionalNumber(ctx, "limit"),
+    offset: optionalNumber(ctx, "offset")
+  })
 });
 
 // src/commands/te-analysis/meta/asset/abnormal-get.ts
@@ -1309,10 +1740,16 @@ var metadataExchangeRuleList = createAnalysisMetaCapabilityCommand({
   capabilityId: "metadata.exchange_rule.list",
   description: "List exchange-rate conversion rules.",
   flags: [
-    projectIdFlag
+    projectIdFlag,
+    directoryLimitFlag,
+    directoryOffsetFlag
   ],
   risk: "read",
-  buildInput: projectInput
+  buildInput: (ctx) => compactInput({
+    ...projectInput(ctx),
+    limit: optionalNumber(ctx, "limit"),
+    offset: optionalNumber(ctx, "offset")
+  })
 });
 
 // src/commands/te-analysis/meta/exchange/rule-validate.ts
@@ -1411,6 +1848,7 @@ var metadataSuperMetadataExport = createAnalysisMetaCapabilityCommand({
   resource: "event-property-bundle",
   command: "export",
   capabilityId: "metadata.event_property_bundle.export",
+  asyncArtifact: true,
   description: "Export super event and super property configuration as an asynchronous XLSX artifact.",
   flags: [
     projectIdFlag,
@@ -1491,10 +1929,17 @@ var metadataDataTableVersionList = createAnalysisMetaCapabilityCommand({
   description: "List data table historical versions.",
   flags: [
     projectIdFlag,
-    { name: "datatable-id", type: "number", required: true, desc: "Data table ID." }
+    { name: "datatable-id", type: "number", required: true, desc: "Data table ID." },
+    directoryLimitFlag,
+    directoryOffsetFlag
   ],
   risk: "read",
-  buildInput: (ctx) => ({ ...projectInput(ctx), datatable_id: ctx.num("datatable-id") })
+  buildInput: (ctx) => ({
+    ...projectInput(ctx),
+    datatable_id: ctx.num("datatable-id"),
+    limit: optionalNumber(ctx, "limit"),
+    offset: optionalNumber(ctx, "offset")
+  })
 });
 
 // src/commands/te-analysis/meta/datatable/version-get.ts
@@ -1520,8 +1965,96 @@ var commands9 = [
 ];
 var datatable_default = commands9;
 
+// src/commands/te-analysis/meta/catalog/export.ts
+var metadataCatalogExport = createAnalysisMetaCapabilityCommand({
+  resource: "catalog",
+  command: "export",
+  capabilityId: "metadata.catalog.export",
+  asyncArtifact: {
+    preflightOutput: preflightCatalogArtifactOutput,
+    materialize: catalogArtifactMaterializer("analysis_metadata")
+  },
+  description: "Export the complete accessible analysis metadata catalog to JSONL with an integrity sidecar.",
+  flags: [projectIdFlag, requestIdFlag, asyncTimeoutSecondsFlag],
+  risk: "read",
+  validate: validateCatalogExportFlags,
+  buildInput: (ctx) => compactInput({
+    ...projectInput(ctx),
+    request_id: optionalString(ctx, "request-id"),
+    timeout_seconds: optionalNumber(ctx, "timeout-seconds")
+  })
+});
+
+// src/commands/te-analysis/meta/catalog/list.ts
+var resourceTypes = [
+  "event",
+  "metric",
+  "event_property",
+  "user_property",
+  "cluster",
+  "tag"
+];
+var resourceTypesFlag = {
+  name: "resource-types",
+  type: "json",
+  required: false,
+  desc: "Online search resource type filter JSON array. Use event, metric, event_property, user_property, cluster, or tag."
+};
+var limitPerTypeFlag = {
+  name: "limit-per-type",
+  type: "number",
+  required: false,
+  min: 1,
+  max: 200,
+  desc: "Maximum online search results per resource type. Default: 20, max: 200."
+};
+function optionalResourceTypes(ctx) {
+  const value = ctx.json("resource-types");
+  return value === void 0 || value === null ? void 0 : value;
+}
+function validateMetadataCatalogList(ctx) {
+  const queries = ctx.json("queries");
+  const selectedTypes = ctx.json("resource-types");
+  const limitPerType = ctx.optionalNum("limit-per-type");
+  validateCatalogListFlags(ctx);
+  if (queries === void 0 || selectedTypes === void 0) {
+    throw new CliValidationError(
+      "online catalog search requires --queries and --resource-types"
+    );
+  }
+  if (!Array.isArray(selectedTypes) || selectedTypes.length < 1 || selectedTypes.length > resourceTypes.length || selectedTypes.some((type) => typeof type !== "string" || !resourceTypes.includes(type))) {
+    throw new CliValidationError(
+      "--resource-types must be a JSON array containing only event, metric, event_property, user_property, cluster, or tag"
+    );
+  }
+}
+var metadataCatalogList = createAnalysisMetaCapabilityCommand({
+  resource: "catalog",
+  command: "list",
+  capabilityId: "metadata.catalog.list",
+  description: "Search selected analysis metadata types with bounded per-type results.",
+  flags: [
+    projectIdFlag,
+    queriesFlag,
+    resourceTypesFlag,
+    limitPerTypeFlag
+  ],
+  risk: "read",
+  validate: validateMetadataCatalogList,
+  buildInput: (ctx) => compactInput({
+    ...projectInput(ctx),
+    queries: optionalQueries(ctx),
+    resource_types: optionalResourceTypes(ctx),
+    limit_per_type: ctx.optionalNum("limit-per-type")
+  })
+});
+
+// src/commands/te-analysis/meta/catalog/index.ts
+var commands10 = [metadataCatalogList, metadataCatalogExport];
+var catalog_default = commands10;
+
 // src/commands/te-analysis/meta/index.ts
-var commands10 = [
+var commands11 = [
   ...event_default,
   ...property_default,
   ...virtual_event_default,
@@ -1530,9 +2063,10 @@ var commands10 = [
   ...asset_default,
   ...exchange_default,
   ...super_metadata_default,
-  ...datatable_default
+  ...datatable_default,
+  ...catalog_default
 ];
-var meta_default = commands10;
+var meta_default = commands11;
 
 // src/commands/te-analysis/meta/asset/usage-list.ts
 var analysisMetaAssetUsageList = createAnalysisGovernanceCapabilityCommand({
@@ -1540,7 +2074,7 @@ var analysisMetaAssetUsageList = createAnalysisGovernanceCapabilityCommand({
   command: "list",
   capabilityId: "governance.asset.list",
   description: "List assets for usage governance.",
-  flags: [projectIdFlag, queryFlag, searchsFlag, ruleFlag, operationTypeFlag, directoryLimitFlag, offsetFlag, payloadFlag],
+  flags: [projectIdFlag, queryFlag, searchsFlag, ruleFlag, operationTypeFlag, directoryLimitFlag, directoryOffsetFlag, payloadFlag],
   risk: "read",
   buildInput: (ctx) => assetGovernanceInput(ctx, ["query", "searchs", "rule", "operation_type", "limit", "offset"])
 });
@@ -1573,7 +2107,7 @@ var analysisMetaAssetDependencyList = createAnalysisGovernanceCapabilityCommand(
   command: "list",
   capabilityId: "governance.asset_dependency.list",
   description: "List upstream dependencies for one asset.",
-  flags: [projectIdFlag, nodeIdFlag, queryFlag, searchsFlag, ruleFlag, directoryLimitFlag, offsetFlag, payloadFlag],
+  flags: [projectIdFlag, nodeIdFlag, queryFlag, searchsFlag, ruleFlag, directoryLimitFlag, directoryOffsetFlag, payloadFlag],
   risk: "read",
   buildInput: (ctx) => assetGovernanceInput(ctx, ["node_id", "query", "searchs", "rule", "limit", "offset"])
 });
@@ -1584,7 +2118,7 @@ var analysisMetaAssetImpactList = createAnalysisGovernanceCapabilityCommand({
   command: "list",
   capabilityId: "governance.asset_impact.list",
   description: "List downstream impacts for one asset.",
-  flags: [projectIdFlag, nodeIdFlag, queryFlag, searchsFlag, ruleFlag, directoryLimitFlag, offsetFlag, payloadFlag],
+  flags: [projectIdFlag, nodeIdFlag, queryFlag, searchsFlag, ruleFlag, directoryLimitFlag, directoryOffsetFlag, payloadFlag],
   risk: "read",
   buildInput: (ctx) => assetGovernanceInput(ctx, ["node_id", "query", "searchs", "rule", "limit", "offset"])
 });
@@ -1595,7 +2129,7 @@ var analysisMetaAssetQueryHistoryList = createAnalysisGovernanceCapabilityComman
   command: "list",
   capabilityId: "governance.asset_query_history.list",
   description: "List query history for one asset.",
-  flags: [projectIdFlag, nodeIdFlag, queryFlag, searchsFlag, ruleFlag, directoryLimitFlag, offsetFlag, payloadFlag],
+  flags: [projectIdFlag, nodeIdFlag, queryFlag, searchsFlag, ruleFlag, directoryLimitFlag, directoryOffsetFlag, payloadFlag],
   risk: "read",
   buildInput: (ctx) => assetGovernanceInput(ctx, ["node_id", "query", "searchs", "rule", "limit", "offset"])
 });
@@ -1617,9 +2151,9 @@ var analysisMetaAssetRuleList = createAnalysisGovernanceCapabilityCommand({
   command: "list",
   capabilityId: "governance.rule.list",
   description: "List asset governance rules.",
-  flags: [projectIdFlag, payloadFlag],
+  flags: [projectIdFlag, payloadFlag, directoryLimitFlag, directoryOffsetFlag],
   risk: "read",
-  buildInput: (ctx) => assetGovernanceInput(ctx, [])
+  buildInput: (ctx) => assetGovernanceInput(ctx, ["limit", "offset"])
 });
 
 // src/commands/te-analysis/meta/asset/rule-create.ts
@@ -1738,7 +2272,7 @@ var analysisMetaAssetOperationRecordList = createAnalysisGovernanceCapabilityCom
   command: "list",
   capabilityId: "governance.operation_record.list",
   description: "List asset batch operation records.",
-  flags: [projectIdFlag, typeFlag, statusFlag, queryFlag, sortFieldFlag, sortOrderFlag, directoryLimitFlag, offsetFlag, payloadFlag],
+  flags: [projectIdFlag, typeFlag, statusFlag, queryFlag, sortFieldFlag, sortOrderFlag, directoryLimitFlag, directoryOffsetFlag, payloadFlag],
   risk: "read",
   buildInput: (ctx) => assetGovernanceInput(ctx, ["type", "status", "query", "sort_field", "sort_order", "limit", "offset"])
 });
@@ -1755,7 +2289,7 @@ var analysisMetaAssetOperationRecordExport = createAnalysisGovernanceCapabilityC
 });
 
 // src/commands/te-analysis/governance/index.ts
-var commands11 = [
+var commands12 = [
   analysisMetaAssetUsageList,
   analysisMetaAssetUsageExport,
   analysisMetaAssetBatchInfoExport,
@@ -1777,7 +2311,7 @@ var commands11 = [
   analysisMetaAssetOperationRecordList,
   analysisMetaAssetOperationRecordExport
 ];
-var governance_default = commands11;
+var governance_default = commands12;
 
 // src/commands/te-analysis/report/list.ts
 var reportList = createAnalysisCapabilityCommand({
@@ -1785,8 +2319,9 @@ var reportList = createAnalysisCapabilityCommand({
   command: "list",
   capabilityId: "analysis.report.list",
   description: "List analysis reports visible to the current user through the capability gateway.",
-  flags: [projectIdFlag, queryFlag, fieldsFlag, reportModelTypesFlag, reportListLimitFlag, offsetFlag],
+  flags: [projectIdFlag, queriesFlag, fieldsFlag, reportModelTypesFlag, reportListLimitFlag, directoryOffsetFlag],
   risk: "read",
+  validate: validateQueriesFlag,
   buildInput: reportListInput
 });
 
@@ -1795,10 +2330,11 @@ var reportListExport = createAnalysisCapabilityCommand({
   resource: "report",
   command: "list-export",
   capabilityId: "analysis.report.list_export",
+  asyncArtifact: true,
   description: "Export the accessible report catalog as a gzip artifact.",
   flags: [
     projectIdFlag,
-    queryFlag,
+    queriesFlag,
     fieldsFlag,
     reportModelTypesFlag,
     requestIdFlag,
@@ -1806,9 +2342,10 @@ var reportListExport = createAnalysisCapabilityCommand({
     asyncTimeoutSecondsFlag
   ],
   risk: "read",
+  validate: validateQueriesFlag,
   buildInput: (ctx) => compactInput({
     ...projectInput(ctx),
-    query: optionalString(ctx, "query"),
+    queries: optionalQueries(ctx),
     fields: optionalJson(ctx, "fields"),
     model_types: optionalJson(ctx, "model-types"),
     ...exportLifecycleInput(ctx)
@@ -1850,7 +2387,7 @@ var REPORT_WRITE_MODEL_TYPE_VALUES = [
   "tag"
 ];
 var REPORT_WRITE_MODEL_DESCRIPTION = `${AI_MODEL_DESCRIPTION} Report create/update also supports tag for saved tag report data; use tag as the AI-facing spelling.`;
-var AI_DEFINITION_DESCRIPTION = 'AI-facing model definition JSON. Do not pass raw QP, events, event_view, visual_view, or analysis_query. For path definitions, global filters support user_property, cluster, and tag only; event_property is not supported. session_unit accepts second (1..999), minute (1..999), or hour (1..24). Do not use day; express one day as session_interval=24 and session_unit=hour. For SQL, a simple query is {"sql":"select ..."}; raw variables use ${name}, while typed params use ${Text:name}, ${Selector:name}, or ${PartDate:name}. PartDate expands to a complete predicate, so write WHERE ${PartDate:d}, not a column followed by the placeholder. A part_date parameter may set boolean use_timezone; it defaults to false and controls whether that parameter uses the query effective timezone. Selector value must match one options[].value. Trino identifiers containing #, $, @, spaces, or punctuation must be delimited with double quotes, for example SELECT "#user_id", "$part_event" FROM ...; single quotes are string literals. Queries against an event table must include a date-partition predicate on the quoted "$part_date" column, for example WHERE "$part_date" BETWEEN \'2026-07-01\' AND \'2026-07-07\'; the backend rejects event-table SQL without it. The CLI preserves SQL text and never auto-quotes identifiers.';
+var AI_DEFINITION_DESCRIPTION = 'AI-facing model definition JSON. Do not pass raw QP, events, event_view, visual_view, or analysis_query. Distribution filters must be attached to the corresponding distribution_metrics[].filters; do not use top-level filters or relation. For path definitions, global filters support user_property, cluster, and tag only; event_property is not supported. session_unit accepts second (1..999), minute (1..999), or hour (1..24). Do not use day; express one day as session_interval=24 and session_unit=hour. For SQL, a simple query is {"sql":"select ..."}; raw variables use ${name}, while typed params use ${Text:name}, ${Selector:name}, or ${PartDate:name}. PartDate expands to a complete predicate, so write WHERE ${PartDate:d}, not a column followed by the placeholder. A part_date parameter may set boolean use_timezone; it defaults to false and controls whether that parameter uses the query effective timezone. Selector value must match one options[].value. Trino identifiers containing #, $, @, spaces, punctuation, or a reserved word must be delimited with double quotes, for example SELECT "#user_id", "$part_event", "end" FROM ...; single quotes are string literals. For multiline SQL JSON, the decoded sql value must contain a real line break; do not submit a literal \\n sequence outside quoted SQL text. Queries against an event table must include a date-partition predicate on the quoted "$part_date" column, for example WHERE "$part_date" BETWEEN \'2026-07-01\' AND \'2026-07-07\'; the backend rejects event-table SQL without it. The CLI preserves SQL text and never auto-quotes identifiers.';
 var REPORT_WRITE_DEFINITION_DESCRIPTION = `${AI_DEFINITION_DESCRIPTION} For model_type=tag, pass a tag report intent such as {"tag":{"tag_name":"vip_users","time_range":{"mode":"recent","unit":"day","value":7}}}. Tags are supported for report create/update and report data, not ad-hoc analysis.`;
 function aiModelTypeFlag(required) {
   return {
@@ -1884,6 +2421,21 @@ function reportWriteDefinitionFlag(required) {
     desc: REPORT_WRITE_DEFINITION_DESCRIPTION
   };
 }
+var metadataResolutionsFlag = {
+  name: "resolutions",
+  type: "json",
+  required: false,
+  desc: "Optional user-confirmed metadata bindings keyed by compiler error path. Each value requires raw_value, resource_type, and resource_key. Reuse the unchanged definition and only pass values explicitly confirmed by the user."
+};
+var reportMetadataResolutionsFlag = {
+  ...metadataResolutionsFlag,
+  desc: `${metadataResolutionsFlag.desc} This option is not supported with --model-type tag.`
+};
+function validateReportMetadataResolutions(ctx) {
+  if (ctx.json("resolutions") !== void 0 && ctx.str("model-type") === "tag") {
+    throw new Error("--resolutions is not supported with --model-type tag.");
+  }
+}
 
 // src/commands/te-analysis/report/create.ts
 var reportCreate = createAnalysisCapabilityCommand({
@@ -1896,17 +2448,20 @@ var reportCreate = createAnalysisCapabilityCommand({
     { name: "report-name", type: "string", required: true, desc: "Report display name." },
     reportWriteModelTypeFlag(true),
     reportWriteDefinitionFlag(true),
+    reportMetadataResolutionsFlag,
     { name: "report-desc", type: "string", required: false, desc: "Optional report description." },
     { name: "cache-seconds", type: "number", required: false, desc: "Optional cache duration in seconds." },
     { name: "query-duration-ms", type: "number", required: false, desc: "Optional last query duration in milliseconds." },
     { name: "dashboard-ids", type: "json", required: false, desc: "Optional dashboard ID array to associate after creation." }
   ],
   risk: "write",
+  validate: validateReportMetadataResolutions,
   buildInput: (ctx) => compactInput({
     ...projectInput(ctx),
     report_name: ctx.str("report-name"),
     model_type: ctx.str("model-type"),
     definition: ctx.json("definition"),
+    resolutions: optionalJson(ctx, "resolutions"),
     report_desc: optionalString(ctx, "report-desc"),
     cache_seconds: optionalNumber(ctx, "cache-seconds"),
     query_duration_ms: optionalNumber(ctx, "query-duration-ms"),
@@ -1917,6 +2472,7 @@ var reportCreate = createAnalysisCapabilityCommand({
 // src/commands/te-analysis/report/update.ts
 function validateReportUpdate(ctx) {
   const hasDefinition = ctx.str("definition") !== "";
+  const hasResolutions = ctx.json("resolutions") !== void 0;
   const hasMetadataUpdate = ctx.str("report-name") !== "" || ctx.str("report-desc") !== "";
   if (!hasDefinition && !hasMetadataUpdate) {
     throw new Error("At least one of --report-name, --report-desc, or --definition is required.");
@@ -1924,6 +2480,10 @@ function validateReportUpdate(ctx) {
   if (hasDefinition && ctx.str("model-type") === "") {
     throw new Error("--model-type is required when --definition is provided.");
   }
+  if (hasResolutions && !hasDefinition) {
+    throw new Error("--resolutions requires --definition.");
+  }
+  validateReportMetadataResolutions(ctx);
 }
 var reportUpdate = createAnalysisCapabilityCommand({
   resource: "report",
@@ -1938,6 +2498,7 @@ var reportUpdate = createAnalysisCapabilityCommand({
     { name: "report-desc", type: "string", required: false, desc: "New report description." },
     reportWriteModelTypeFlag(false),
     reportWriteDefinitionFlag(false),
+    reportMetadataResolutionsFlag,
     { name: "cache-seconds", type: "number", required: false, desc: "Optional cache duration in seconds." },
     { name: "query-duration-ms", type: "number", required: false, desc: "Optional last query duration in milliseconds." }
   ],
@@ -1951,6 +2512,7 @@ var reportUpdate = createAnalysisCapabilityCommand({
     report_desc: optionalString(ctx, "report-desc"),
     model_type: optionalString(ctx, "model-type"),
     definition: optionalJson(ctx, "definition"),
+    resolutions: optionalJson(ctx, "resolutions"),
     cache_seconds: optionalNumber(ctx, "cache-seconds"),
     query_duration_ms: optionalNumber(ctx, "query-duration-ms")
   })
@@ -1971,7 +2533,7 @@ var reportDelete = createAnalysisCapabilityCommand({
 });
 
 // src/commands/te-analysis/report/index.ts
-var commands12 = [
+var commands13 = [
   reportList,
   reportListExport,
   reportGet,
@@ -1979,7 +2541,7 @@ var commands12 = [
   reportUpdate,
   reportDelete
 ];
-var report_default = commands12;
+var report_default = commands13;
 
 // src/commands/te-analysis/report-data/shared.ts
 var reportDataZoneOffsetDescription = "Query execution timezone. Omit it to match the report UI for the current user (user selection when available, otherwise project default). Use a fixed UTC offset from -12 through 14, or 99 for local-time mode with no conversion to one fixed UTC offset; 99 is not UTC+99. This is not persisted in the report definition.";
@@ -1998,14 +2560,13 @@ function reportDataInput(ctx) {
     slave_cluster_id: optionalString(ctx, "slave-cluster-id"),
     zone_offset: optionalNumber(ctx, "zone-offset"),
     use_cache: optionalBoolean(ctx, "use-cache"),
-    limit: optionalNumber(ctx, "limit"),
+    preview_rows: optionalNumber(ctx, "preview-rows"),
     timeout_seconds: optionalNumber(ctx, "timeout-seconds")
   });
 }
 function reportDataExportInput(ctx) {
   return compactInput({
     ...reportDataInput(ctx),
-    limit: void 0,
     ...exportLifecycleInput(ctx)
   });
 }
@@ -2030,13 +2591,12 @@ var reportDataRun = createAnalysisCapabilityCommand({
     slaveClusterIdFlag,
     { name: "zone-offset", type: "number", required: false, desc: reportDataZoneOffsetDescription },
     { name: "use-cache", type: "boolean", required: false, desc: "Whether to use cache. Default: true." },
-    syncLimitFlag,
+    analysisModelPreviewRowsFlag,
     syncTimeoutSecondsFlag
   ],
   risk: "read",
   validate: validateClusterQueryRouting,
-  buildInput: reportDataInput,
-  postProcess: applyAnalysisInlineLimit
+  buildInput: reportDataInput
 });
 
 // src/commands/te-analysis/report-data/export.ts
@@ -2044,6 +2604,7 @@ var reportDataExport = createAnalysisCapabilityCommand({
   resource: "report-data",
   command: "export",
   capabilityId: "analysis.report_data.export",
+  asyncArtifact: true,
   description: `Submit report data as an asynchronous gzip artifact. Override contract: SQL uses only --sql-params; non-SQL analysis models use filters/group/time; tag uses its saved tag definition. Mixed-model batches are best-effort. Exports do not create interactive drilldown contexts. ${analysisDataExportRoutingHelp}`,
   flags: [
     projectIdFlag,
@@ -2068,11 +2629,11 @@ var reportDataExport = createAnalysisCapabilityCommand({
 });
 
 // src/commands/te-analysis/report-data/index.ts
-var commands13 = [
+var commands14 = [
   reportDataRun,
   reportDataExport
 ];
-var report_data_default = commands13;
+var report_data_default = commands14;
 
 // src/commands/te-analysis/report-change-log/list.ts
 var reportChangeLogList = createAnalysisCapabilityCommand({
@@ -2108,11 +2669,11 @@ var reportChangeLogGet = createAnalysisCapabilityCommand({
 });
 
 // src/commands/te-analysis/report-change-log/index.ts
-var commands14 = [
+var commands15 = [
   reportChangeLogList,
   reportChangeLogGet
 ];
-var report_change_log_default = commands14;
+var report_change_log_default = commands15;
 
 // src/commands/te-analysis/report-version/rollback.ts
 var reportVersionRollback = createAnalysisCapabilityCommand({
@@ -2134,10 +2695,10 @@ var reportVersionRollback = createAnalysisCapabilityCommand({
 });
 
 // src/commands/te-analysis/report-version/index.ts
-var commands15 = [
+var commands16 = [
   reportVersionRollback
 ];
-var report_version_default = commands15;
+var report_version_default = commands16;
 
 // src/commands/te-analysis/report-abnormal/get.ts
 var reportAbnormalGet = createAnalysisCapabilityCommand({
@@ -2154,10 +2715,10 @@ var reportAbnormalGet = createAnalysisCapabilityCommand({
 });
 
 // src/commands/te-analysis/report-abnormal/index.ts
-var commands16 = [
+var commands17 = [
   reportAbnormalGet
 ];
-var report_abnormal_default = commands16;
+var report_abnormal_default = commands17;
 
 // src/commands/te-analysis/dashboard/list.ts
 var dashboardList = createAnalysisCapabilityCommand({
@@ -2167,7 +2728,7 @@ var dashboardList = createAnalysisCapabilityCommand({
   description: "List dashboards visible to the current user through the capability gateway.",
   flags: [
     projectIdFlag,
-    queryFlag,
+    queriesFlag,
     {
       name: "fields",
       type: "json",
@@ -2176,9 +2737,10 @@ var dashboardList = createAnalysisCapabilityCommand({
       alias: "f"
     },
     directoryLimitFlag,
-    offsetFlag
+    directoryOffsetFlag
   ],
   risk: "read",
+  validate: validateQueriesFlag,
   buildInput: listInput
 });
 
@@ -2406,7 +2968,7 @@ var dashboardTaskStatus = createAnalysisCapabilityCommand({
 });
 
 // src/commands/te-analysis/dashboard/index.ts
-var commands17 = [
+var commands18 = [
   dashboardList,
   dashboardCreate,
   dashboardGet,
@@ -2420,7 +2982,7 @@ var commands17 = [
   dashboardAbnormalGet,
   dashboardTaskStatus
 ];
-var dashboard_default = commands17;
+var dashboard_default = commands18;
 
 // src/commands/te-analysis/dashboard-report/add.ts
 var dashboardReportAdd = createAnalysisCapabilityCommand({
@@ -2442,10 +3004,10 @@ var dashboardReportAdd = createAnalysisCapabilityCommand({
 });
 
 // src/commands/te-analysis/dashboard-report/index.ts
-var commands18 = [
+var commands19 = [
   dashboardReportAdd
 ];
-var dashboard_report_default = commands18;
+var dashboard_report_default = commands19;
 
 // src/commands/te-analysis/dashboard-report-data/run.ts
 var dashboardReportDataRun = createAnalysisCapabilityCommand({
@@ -2465,13 +3027,12 @@ var dashboardReportDataRun = createAnalysisCapabilityCommand({
     { name: "zone-offset", type: "number", required: false, desc: reportDataZoneOffsetDescription },
     { name: "use-cache", type: "boolean", required: false, desc: "Whether to use cache. Default: true." },
     { name: "request-id", type: "string", required: false, desc: "Optional cli_<32 lowercase hex> request ID. Generated when omitted." },
-    dashboardSyncTimeoutSecondsFlag,
-    syncLimitFlag
+    analysisModelPreviewRowsFlag,
+    dashboardSyncTimeoutSecondsFlag
   ],
   risk: "read",
   validate: validateClusterQueryRouting,
-  buildInput: dashboardReportDataInput,
-  postProcess: applyAnalysisInlineLimit
+  buildInput: dashboardReportDataInput
 });
 
 // src/commands/te-analysis/dashboard-report-data/export.ts
@@ -2479,6 +3040,7 @@ var dashboardReportDataExport = createAnalysisCapabilityCommand({
   resource: "dashboard-report-data",
   command: "export",
   capabilityId: "analysis.dashboard_report_data.export",
+  asyncArtifact: true,
   description: `Submit dashboard report data as an asynchronous gzip JSONL artifact. Filters and time overrides do not apply to SQL reports; the artifact still contains data plus structured warnings. Exports do not create interactive drilldown contexts. ${analysisDataExportRoutingHelp}`,
   flags: [
     projectIdFlag,
@@ -2501,11 +3063,11 @@ var dashboardReportDataExport = createAnalysisCapabilityCommand({
 });
 
 // src/commands/te-analysis/dashboard-report-data/index.ts
-var commands19 = [
+var commands20 = [
   dashboardReportDataRun,
   dashboardReportDataExport
 ];
-var dashboard_report_data_default = commands19;
+var dashboard_report_data_default = commands20;
 
 // src/commands/te-analysis/query/cancel.ts
 var queryCancel = createAnalysisCapabilityCommand({
@@ -2529,13 +3091,13 @@ var sourceFlag = {
   name: "source",
   type: "json",
   required: false,
-  desc: "Source selector copied from sources[] when the synchronous preview contains multiple reports or charts. Pass only returned selector fields such as report_id or chart_id."
+  desc: "Source selector copied from the compact sources[] summary when the synchronous preview contains multiple reports or charts. Pass exactly one returned field: report_id or chart_id."
 };
 var coordinateFlag = {
   name: "coordinate",
   type: "json",
   required: true,
-  desc: "One semantic cell coordinate assembled only from the selected source.drilldown row_options, column_options, and metric_options. Never pass target_id, raw QP, or values absent from the synchronous preview."
+  desc: "One semantic cell coordinate assembled only from row_options, column_options, and metric_options returned by analysis query-context get. Never pass target_id, raw QP, or inferred values."
 };
 var propertiesFlag = {
   name: "properties",
@@ -2600,11 +3162,44 @@ var queryCreateResultCluster = createAnalysisCapabilityCommand({
 });
 
 // src/commands/te-analysis/query/index.ts
-var commands20 = [
+var commands21 = [
   queryCancel,
   queryCreateResultCluster
 ];
-var query_default = commands20;
+var query_default = commands21;
+
+// src/commands/te-analysis/query-context/get.ts
+var queryContextGet = createAnalysisCapabilityCommand({
+  resource: "query-context",
+  command: "get",
+  capabilityId: "analysis.query.context_get",
+  description: "Read full selectable row, column, and metric coordinate options for one source from a synchronous analysis query context.",
+  flags: [
+    projectIdFlag,
+    {
+      name: "query-context-id",
+      type: "string",
+      required: true,
+      desc: "query_context_id returned by a synchronous analysis preview."
+    },
+    {
+      name: "source",
+      type: "json",
+      required: false,
+      desc: "Source selector copied from the compact sources[] summary. Required for multi-source contexts; pass exactly one field: report_id or chart_id."
+    }
+  ],
+  risk: "read",
+  buildInput: (ctx) => compactInput({
+    project_id: ctx.num("project-id"),
+    query_context_id: ctx.str("query-context-id"),
+    source: optionalJson(ctx, "source")
+  })
+});
+
+// src/commands/te-analysis/query-context/index.ts
+var commands22 = [queryContextGet];
+var query_context_default = commands22;
 
 // src/commands/te-analysis/run/inspect.ts
 var runInspect = {
@@ -2634,15 +3229,76 @@ var runInspect = {
   }
 };
 
+// src/commands/te-analysis/run/wait.ts
+var runWait = {
+  service: "analysis",
+  resource: "run",
+  command: "wait",
+  description: "Resume waiting for an async run; optionally stream its completed artifact to a local file.",
+  flags: [
+    { name: "run-id", type: "string", required: true, desc: "Async run ID returned by an export capability." },
+    { name: "wait-timeout-seconds", type: "number", required: false, min: 1, max: 21600, desc: "Maximum time this CLI process waits. Default: 600 seconds; expiry never cancels the remote run." },
+    { name: "output", type: "string", required: false, desc: "After success, stream the artifact to this local file." },
+    { name: "force", type: "boolean", required: false, desc: "Allow --output to atomically replace an existing file." }
+  ],
+  risk: "read",
+  validate: (ctx) => validateLifecycleFlags(ctx, true),
+  dryRun: (ctx) => ({
+    method: "GET",
+    url: buildCapabilityGatewayUrl(
+      ctx.host(),
+      resolveGatewayDomain("analysis"),
+      `runs/${encodeURIComponent(ctx.str("run-id"))}`
+    ),
+    wait_until_terminal: true,
+    wait_timeout_seconds: clientWaitTimeoutSeconds(ctx),
+    ...ctx.str("output") ? { output_path: ctx.str("output") } : {}
+  }),
+  execute: async (ctx) => {
+    validateLifecycleFlags(ctx, true);
+    const runId = ctx.str("run-id");
+    const output = ctx.str("output");
+    if (output) await assertOutputPathAvailable(output, ctx.bool("force"), { run_id: runId });
+    return withInterruptSignal(async (signal) => {
+      const descriptor = await waitForAnalysisRun(ctx.host(), runId, {
+        signal,
+        waitTimeoutSeconds: clientWaitTimeoutSeconds(ctx)
+      });
+      if (!output) return descriptor;
+      const artifactId = artifactIdFrom(descriptor);
+      if (!artifactId) {
+        throw new CapabilityGatewayError(
+          `Completed async run ${runId} has no artifact_id.`,
+          "ASYNC_RUN_PROTOCOL_ERROR",
+          502,
+          `Inspect with: ae-cli analysis run inspect --run-id ${runId}`,
+          { run_id: runId }
+        );
+      }
+      const download = await downloadAnalysisArtifact(
+        ctx.host(),
+        runId,
+        artifactId,
+        output,
+        { force: ctx.bool("force"), signal, ensureReady: false }
+      );
+      return { ...descriptor, ...download };
+    }, runId);
+  }
+};
+function artifactIdFrom(descriptor) {
+  return descriptor.artifact_id ?? descriptor.artifact?.artifact_id ?? descriptor.artifact?.id;
+}
+
 // src/commands/te-analysis/run/index.ts
-var commands21 = [
-  runInspect
+var commands23 = [
+  runInspect,
+  runWait
 ];
-var run_default = commands21;
+var run_default = commands23;
 
 // src/commands/te-analysis/artifact/download.ts
-import { mkdir, writeFile } from "fs/promises";
-import { dirname, resolve } from "path";
+import { resolve as resolve3 } from "path";
 function artifactPath(runId, artifactId) {
   return `runs/${encodeURIComponent(runId)}/artifacts/${encodeURIComponent(artifactId)}/download`;
 }
@@ -2650,13 +3306,15 @@ var artifactDownload = {
   service: "analysis",
   resource: "artifact",
   command: "download",
-  description: "Download an analysis capability-gateway artifact by run_id and artifact_id. Keep run_id bound to artifact_id from the export result.",
+  description: "Stream a completed analysis capability-gateway artifact to a local file by its bound run_id/artifact_id pair.",
   flags: [
     { name: "run-id", type: "string", required: true, desc: "Async run ID returned by an export capability." },
     { name: "artifact-id", type: "string", required: true, desc: "Artifact ID returned by the same export capability." },
-    { name: "output", type: "string", required: true, desc: "Local output file path. Use a file path, not a directory." }
+    { name: "output", type: "string", required: true, desc: "Local output file path. Existing paths are refused unless --force is passed." },
+    { name: "force", type: "boolean", required: false, desc: "Atomically replace an existing output file." }
   ],
   risk: "read",
+  validate: validateLifecycleFlags,
   dryRun: (ctx) => ({
     method: "GET",
     url: buildCapabilityGatewayUrl(
@@ -2664,72 +3322,30 @@ var artifactDownload = {
       resolveGatewayDomain("analysis"),
       artifactPath(ctx.str("run-id"), ctx.str("artifact-id"))
     ),
-    output_path: resolve(ctx.str("output"))
+    output_path: resolve3(ctx.str("output")),
+    ...ctx.bool("force") ? { force: true } : {}
   }),
   execute: async (ctx) => {
+    validateLifecycleFlags(ctx);
     const runId = ctx.str("run-id");
-    const artifactId = ctx.str("artifact-id");
-    const outputPath = resolve(ctx.str("output"));
-    await ensureArtifactReady(ctx.host(), runId, artifactId);
-    const resp = await fetchArtifact(ctx.host(), runId, artifactId);
-    const bytes = Buffer.from(await resp.arrayBuffer());
-    await mkdir(dirname(outputPath), { recursive: true });
-    await writeFile(outputPath, bytes);
-    return {
-      run_id: runId,
-      artifact_id: artifactId,
-      output_path: outputPath,
-      bytes: bytes.length,
-      content_type: resp.headers.get("content-type") ?? void 0,
-      content_encoding: resp.headers.get("content-encoding") ?? void 0,
-      content_disposition: resp.headers.get("content-disposition") ?? void 0
-    };
-  }
-};
-async function ensureArtifactReady(host, runId, artifactId) {
-  const descriptor = await inspectRun(host, runId);
-  if (descriptor.artifact_id && descriptor.artifact_id !== artifactId) {
-    throw new CapabilityGatewayError(
-      `artifact_id ${artifactId} does not belong to run_id ${runId}`,
-      "ARTIFACT_RUN_MISMATCH",
-      400,
-      "Use the run_id and artifact_id pair from the same export response."
+    return withInterruptSignal(
+      (signal) => downloadAnalysisArtifact(
+        ctx.host(),
+        runId,
+        ctx.str("artifact-id"),
+        ctx.str("output"),
+        { force: ctx.bool("force"), signal }
+      ),
+      runId
     );
   }
-  if (descriptor.status === "SUCCEEDED" && descriptor.artifact_status === "COMPLETED") {
-    return;
-  }
-  const reason = descriptor.error_message ? `; error=${descriptor.error_message}` : "";
-  throw new CapabilityGatewayError(
-    `Artifact is not ready: run_status=${descriptor.status ?? "UNKNOWN"}, artifact_status=${descriptor.artifact_status ?? "UNKNOWN"}${reason}`,
-    "ARTIFACT_NOT_READY",
-    409,
-    "Run ae-cli analysis run inspect --run-id <run_id> until status=SUCCEEDED and artifact_status=COMPLETED, then retry artifact download. If status is FAILED or CANCELED, do not retry download."
-  );
-}
-async function inspectRun(host, runId) {
-  return await requestCapabilityGateway(
-    host,
-    resolveGatewayDomain("analysis"),
-    `runs/${encodeURIComponent(runId)}`
-  );
-}
-async function fetchArtifact(host, runId, artifactId) {
-  return fetchCapabilityGateway(
-    host,
-    resolveGatewayDomain("analysis"),
-    artifactPath(runId, artifactId),
-    "GET",
-    void 0,
-    "application/octet-stream"
-  );
-}
+};
 
 // src/commands/te-analysis/artifact/index.ts
-var commands22 = [
+var commands24 = [
   artifactDownload
 ];
-var artifact_default = commands22;
+var artifact_default = commands24;
 
 // src/commands/te-analysis/adhoc/shared.ts
 var useCacheFlag2 = {
@@ -2749,13 +3365,14 @@ function adhocRunInput(ctx) {
     project_id: ctx.num("project-id"),
     model_type: ctx.str("model-type"),
     definition: ctx.json("definition"),
+    resolutions: optionalJson(ctx, "resolutions"),
     request_id: optionalString(ctx, "request-id"),
     use_cache: optionalBoolean(ctx, "use-cache"),
     zone_offset: optionalNumber(ctx, "zone-offset"),
     fields: optionalJsonArray(ctx, "fields"),
     cluster_query_scope: optionalString(ctx, "cluster-query-scope"),
     slave_cluster_id: optionalString(ctx, "slave-cluster-id"),
-    limit: optionalNumber(ctx, "limit"),
+    preview_rows: optionalNumber(ctx, "preview-rows"),
     timeout_seconds: optionalNumber(ctx, "timeout-seconds")
   });
 }
@@ -2764,6 +3381,7 @@ function adhocExportInput(ctx) {
     project_id: ctx.num("project-id"),
     model_type: ctx.str("model-type"),
     definition: ctx.json("definition"),
+    resolutions: optionalJson(ctx, "resolutions"),
     request_id: optionalString(ctx, "request-id"),
     use_cache: optionalBoolean(ctx, "use-cache"),
     zone_offset: optionalNumber(ctx, "zone-offset"),
@@ -2778,6 +3396,7 @@ var adhocBaseFlags = [
   projectIdFlag,
   aiModelTypeFlag(true),
   aiDefinitionFlag(true),
+  metadataResolutionsFlag,
   requestIdFlag,
   useCacheFlag2,
   zoneOffsetFlag2,
@@ -2785,6 +3404,10 @@ var adhocBaseFlags = [
   clusterQueryScopeFlag,
   slaveClusterIdFlag
 ];
+var adhocRunFlags = [
+  ...adhocBaseFlags,
+  analysisModelPreviewRowsFlag
+];
 var adhocExportFlags = [
   ...adhocBaseFlags,
   artifactFormatFlag,
@@ -2798,14 +3421,12 @@ var adhocRun = createAnalysisCapabilityCommand({
   capabilityId: "analysis.adhoc.run",
   description: `Run one unified ad-hoc analysis from an AI-facing model definition. Supports 12 AI-facing models: 9 common models plus 3 scenario models. Tags and cohorts/clusters are separate capabilities, not ad-hoc model_type values. Returns query_context_id for Redis-backed query follow-ups. ${analysisDataRunRoutingHelp}`,
   flags: [
-    ...adhocBaseFlags,
-    syncLimitFlag,
+    ...adhocRunFlags,
     syncTimeoutSecondsFlag
   ],
   risk: "read",
   validate: validateClusterQueryRouting,
-  buildInput: adhocRunInput,
-  postProcess: applyAnalysisInlineLimit
+  buildInput: adhocRunInput
 });
 
 // src/commands/te-analysis/adhoc/export.ts
@@ -2813,6 +3434,7 @@ var adhocExport = createAnalysisCapabilityCommand({
   resource: "adhoc",
   command: "export",
   capabilityId: "analysis.adhoc.export",
+  asyncArtifact: true,
   description: `Submit one unified ad-hoc analysis export from an AI-facing model definition. Returns run_id/artifact_id plus the actual format, compression, file_name, content_type, and content_encoding. Exports do not create interactive drilldown contexts. ${analysisDataExportRoutingHelp}`,
   flags: [
     ...adhocExportFlags
@@ -2823,11 +3445,11 @@ var adhocExport = createAnalysisCapabilityCommand({
 });
 
 // src/commands/te-analysis/adhoc/index.ts
-var commands23 = [
+var commands25 = [
   adhocRun,
   adhocExport
 ];
-var adhoc_default = commands23;
+var adhoc_default = commands25;
 
 // src/commands/te-analysis/dashboard-definition/export.ts
 var dashboardDefinitionExport = createAnalysisCapabilityCommand({
@@ -2882,11 +3504,11 @@ var dashboardDefinitionImport = createAnalysisCapabilityCommand({
 });
 
 // src/commands/te-analysis/dashboard-definition/index.ts
-var commands24 = [
+var commands26 = [
   dashboardDefinitionExport,
   dashboardDefinitionImport
 ];
-var dashboard_definition_default = commands24;
+var dashboard_definition_default = commands26;
 
 // src/commands/te-analysis/dashboard-daily-report/get.ts
 var dashboardDailyReportGet = createAnalysisCapabilityCommand({
@@ -3070,13 +3692,13 @@ var dashboardDailyReportSendStatus = createAnalysisCapabilityCommand({
 });
 
 // src/commands/te-analysis/dashboard-daily-report/index.ts
-var commands25 = [
+var commands27 = [
   dashboardDailyReportGet,
   dashboardDailyReportUpdate,
   dashboardDailyReportSend,
   dashboardDailyReportSendStatus
 ];
-var dashboard_daily_report_default = commands25;
+var dashboard_daily_report_default = commands27;
 
 // src/commands/te-analysis/bi-panel/list.ts
 var biPanelList = createAnalysisCapabilityCommand({
@@ -3084,8 +3706,9 @@ var biPanelList = createAnalysisCapabilityCommand({
   command: "list",
   capabilityId: "analysis.bi_panel.list",
   description: "List BI panels visible to the current user through the capability gateway.",
-  flags: [projectIdFlag, queryFlag, fieldsFlag, directoryLimitFlag, offsetFlag],
+  flags: [projectIdFlag, queriesFlag, fieldsFlag, directoryLimitFlag, directoryOffsetFlag],
   risk: "read",
+  validate: validateQueriesFlag,
   buildInput: listInput
 });
 
@@ -3203,7 +3826,7 @@ var biPanelCopy = createAnalysisCapabilityCommand({
 });
 
 // src/commands/te-analysis/bi-panel/index.ts
-var commands26 = [
+var commands28 = [
   biPanelList,
   biPanelGet,
   biPanelCreate,
@@ -3212,7 +3835,7 @@ var commands26 = [
   biPanelShare,
   biPanelCopy
 ];
-var bi_panel_default = commands26;
+var bi_panel_default = commands28;
 
 // src/commands/te-analysis/bi-panel-version/get.ts
 var biPanelVersionGet = createAnalysisCapabilityCommand({
@@ -3259,18 +3882,18 @@ var biPanelVersionPublish = createAnalysisCapabilityCommand({
 });
 
 // src/commands/te-analysis/bi-panel-version/index.ts
-var commands27 = [
+var commands29 = [
   biPanelVersionGet,
   biPanelVersionPublish
 ];
-var bi_panel_version_default = commands27;
+var bi_panel_version_default = commands29;
 
 // src/commands/te-analysis/bi-panel-page-data/run.ts
 var biPanelPageDataRun = createAnalysisCapabilityCommand({
   resource: "bi-panel-page-data",
   command: "run",
   capabilityId: "analysis.bi_panel_page_data.run",
-  description: `Run a bounded BI panel page data query and return inline JSON. BI SQL chart data does not support analysis model drilldown or result-cluster creation. ${analysisDataRunRoutingHelp}`,
+  description: `Run a BI panel page query with the same chart result cap as the UI and return has_more when that cap is reached. BI SQL chart data does not support analysis model drilldown or result-cluster creation. ${analysisDataRunRoutingHelp}`,
   flags: [
     projectIdFlag,
     { name: "panel-id", type: "number", required: true, desc: "BI panel ID." },
@@ -3281,18 +3904,13 @@ var biPanelPageDataRun = createAnalysisCapabilityCommand({
     { name: "permission-controls", type: "json", required: false, desc: "Optional permission control array." },
     { name: "chart-filter-controls", type: "json", required: false, desc: "Optional chart filter control array." },
     { name: "columns", type: "json", required: false, desc: "Optional returned column array." },
-    { name: "row-limit", type: "number", required: false, desc: "BI chart row window control. Default: 100, max: 1000. This is chart paging, not the sync/export routing policy.", min: 1, max: 1e3 },
-    { name: "row-offset", type: "number", required: false, desc: "Chart row offset." },
-    { name: "block-limit", type: "number", required: false, desc: "Summary block limit." },
-    { name: "block-offset", type: "number", required: false, desc: "Summary block offset." },
     { name: "use-cache", type: "boolean", required: false, desc: "Whether to use cache. Default: true." },
     { name: "request-id", type: "string", required: false, desc: "Optional cli_<32 lowercase hex> request ID. Generated when omitted." },
-    syncTimeoutSecondsFlag,
-    syncLimitFlag
+    previewRowsFlag,
+    syncTimeoutSecondsFlag
   ],
   risk: "read",
-  buildInput: biPanelPageDataInput,
-  postProcess: applyAnalysisInlineLimit
+  buildInput: biPanelPageDataInput
 });
 
 // src/commands/te-analysis/bi-panel-page-data/export.ts
@@ -3300,21 +3918,18 @@ var biPanelPageDataExport = createAnalysisCapabilityCommand({
   resource: "bi-panel-page-data",
   command: "export",
   capabilityId: "analysis.bi_panel_page_data.export",
-  description: `Submit a BI panel page data query as an asynchronous gzip JSONL artifact. BI SQL chart exports do not create analysis drilldown contexts. ${analysisDataExportRoutingHelp}`,
+  asyncArtifact: true,
+  description: `Stream complete BI panel chart data into an asynchronous gzip JSONL artifact under Common's full-download row cap. BI SQL chart exports do not create analysis drilldown contexts. ${analysisDataExportRoutingHelp}`,
   flags: [
     projectIdFlag,
     { name: "panel-id", type: "number", required: true, desc: "BI panel ID." },
     { name: "page-key", type: "string", required: true, desc: "Page key returned by bi-panel get." },
-    { name: "result-type", type: "string", required: true, desc: "Result type: charts or summary." },
+    { name: "result-type", type: "string", required: true, desc: "Must be charts. Summary is presentation data and is available only from run." },
     { name: "chart-ids", type: "json", required: false, desc: "Optional chart ID array." },
     { name: "parameter-controls", type: "json", required: false, desc: "Optional parameter control override array." },
     { name: "permission-controls", type: "json", required: false, desc: "Optional permission control array." },
     { name: "chart-filter-controls", type: "json", required: false, desc: "Optional chart filter control array." },
     { name: "columns", type: "json", required: false, desc: "Optional returned column array." },
-    { name: "row-limit", type: "number", required: false, desc: "BI chart row window control. Default: 100, max: 1000. This is chart paging, not the async artifact total-row policy.", min: 1, max: 1e3 },
-    { name: "row-offset", type: "number", required: false, desc: "Chart row offset." },
-    { name: "block-limit", type: "number", required: false, desc: "Summary block limit." },
-    { name: "block-offset", type: "number", required: false, desc: "Summary block offset." },
     { name: "use-cache", type: "boolean", required: false, desc: "Whether to use cache. Default: true." },
     { name: "request-id", type: "string", required: false, desc: "Optional cli_<32 lowercase hex> request ID. Generated when omitted." },
     asyncTimeoutSecondsFlag,
@@ -3325,11 +3940,11 @@ var biPanelPageDataExport = createAnalysisCapabilityCommand({
 });
 
 // src/commands/te-analysis/bi-panel-page-data/index.ts
-var commands28 = [
+var commands30 = [
   biPanelPageDataRun,
   biPanelPageDataExport
 ];
-var bi_panel_page_data_default = commands28;
+var bi_panel_page_data_default = commands30;
 
 // src/commands/te-analysis/project-space/list.ts
 var projectSpaceList = createAnalysisCapabilityCommand({
@@ -3337,8 +3952,9 @@ var projectSpaceList = createAnalysisCapabilityCommand({
   command: "list",
   capabilityId: "analysis.project_space.list",
   description: "List project spaces visible to the current user.",
-  flags: [projectIdFlag, queryFlag, fieldsFlag, directoryLimitFlag, offsetFlag],
+  flags: [projectIdFlag, queriesFlag, fieldsFlag, directoryLimitFlag, directoryOffsetFlag],
   risk: "read",
+  validate: validateQueriesFlag,
   buildInput: listInput
 });
 
@@ -3358,11 +3974,11 @@ var projectSpaceGet = createAnalysisCapabilityCommand({
 });
 
 // src/commands/te-analysis/project-space/index.ts
-var commands29 = [
+var commands31 = [
   projectSpaceList,
   projectSpaceGet
 ];
-var project_space_default = commands29;
+var project_space_default = commands31;
 
 // src/commands/te-analysis/favorite/add.ts
 var favoriteAdd = createAnalysisCapabilityCommand({
@@ -3372,20 +3988,16 @@ var favoriteAdd = createAnalysisCapabilityCommand({
   description: "Favorite one dashboard, BI panel, or folder.",
   flags: [
     projectIdFlag,
-    { name: "asset-id", type: "number", required: false, desc: "Asset ID." },
-    { name: "asset-type", type: "string", required: false, desc: "Asset type, for example dashboard, bi_panel, or folder." },
-    { name: "space-id", type: "number", required: false, desc: "Project space ID when relevant." },
-    { name: "id", type: "number", required: false, desc: "Backend DTO ID field when required." },
-    payloadFlag
+    { name: "asset-id", type: "number", required: true, desc: "Dashboard, BI panel, or folder ID." },
+    { name: "asset-type", type: "string", required: true, desc: "Asset type: dashboard, bi_panel, or folder." },
+    { name: "space-id", type: "number", required: false, desc: "Project space ID when relevant." }
   ],
   risk: "write",
   buildInput: (ctx) => compactInput({
     ...projectInput(ctx),
-    asset_id: optionalNumber(ctx, "asset-id"),
-    asset_type: optionalString(ctx, "asset-type"),
-    space_id: optionalNumber(ctx, "space-id"),
-    id: optionalNumber(ctx, "id"),
-    payload: optionalJson(ctx, "payload")
+    asset_id: ctx.num("asset-id"),
+    asset_type: ctx.str("asset-type"),
+    space_id: optionalNumber(ctx, "space-id")
   })
 });
 
@@ -3397,29 +4009,25 @@ var favoriteRemove = createAnalysisCapabilityCommand({
   description: "Remove favorite from one dashboard, BI panel, or folder.",
   flags: [
     projectIdFlag,
-    { name: "asset-id", type: "number", required: false, desc: "Asset ID." },
-    { name: "asset-type", type: "string", required: false, desc: "Asset type, for example dashboard, bi_panel, or folder." },
-    { name: "space-id", type: "number", required: false, desc: "Project space ID when relevant." },
-    { name: "id", type: "number", required: false, desc: "Backend DTO ID field when required." },
-    payloadFlag
+    { name: "asset-id", type: "number", required: true, desc: "Dashboard, BI panel, or folder ID." },
+    { name: "asset-type", type: "string", required: true, desc: "Asset type: dashboard, bi_panel, or folder." },
+    { name: "space-id", type: "number", required: false, desc: "Project space ID when relevant." }
   ],
   risk: "write",
   buildInput: (ctx) => compactInput({
     ...projectInput(ctx),
-    asset_id: optionalNumber(ctx, "asset-id"),
-    asset_type: optionalString(ctx, "asset-type"),
-    space_id: optionalNumber(ctx, "space-id"),
-    id: optionalNumber(ctx, "id"),
-    payload: optionalJson(ctx, "payload")
+    asset_id: ctx.num("asset-id"),
+    asset_type: ctx.str("asset-type"),
+    space_id: optionalNumber(ctx, "space-id")
   })
 });
 
 // src/commands/te-analysis/favorite/index.ts
-var commands30 = [
+var commands32 = [
   favoriteAdd,
   favoriteRemove
 ];
-var favorite_default = commands30;
+var favorite_default = commands32;
 
 // src/commands/te-analysis/public-link/create.ts
 var publicLinkCreate = createAnalysisCapabilityCommand({
@@ -3458,8 +4066,9 @@ var publicLinkList = createAnalysisCapabilityCommand({
   command: "list",
   capabilityId: "analysis.public_link.list",
   description: "List public links in a project.",
-  flags: [projectIdFlag, queryFlag, fieldsFlag, directoryLimitFlag, offsetFlag],
+  flags: [projectIdFlag, queriesFlag, fieldsFlag, directoryLimitFlag, directoryOffsetFlag],
   risk: "read",
+  validate: validateQueriesFlag,
   buildInput: listInput
 });
 
@@ -3535,14 +4144,14 @@ var publicLinkDelete = createAnalysisCapabilityCommand({
 });
 
 // src/commands/te-analysis/public-link/index.ts
-var commands31 = [
+var commands33 = [
   publicLinkCreate,
   publicLinkList,
   publicLinkUpdate,
   publicLinkOffline,
   publicLinkDelete
 ];
-var public_link_default = commands31;
+var public_link_default = commands33;
 
 // src/commands/te-analysis/filter-value/list.ts
 var filterValueList = createAnalysisCapabilityCommand({
@@ -3576,8 +4185,8 @@ var filterValueList = createAnalysisCapabilityCommand({
 });
 
 // src/commands/te-analysis/filter-value/index.ts
-var commands32 = [filterValueList];
-var filter_value_default = commands32;
+var commands34 = [filterValueList];
+var filter_value_default = commands34;
 
 // src/commands/te-analysis/event-detail/shared.ts
 var eventDetailDefinitionFlag = {
@@ -3586,6 +4195,12 @@ var eventDetailDefinitionFlag = {
   required: true,
   desc: 'AI-facing event detail definition: {"event":"login","time_range":{"mode":"absolute","start_time":"2026-07-01 00:00:00","end_time":"2026-07-01 23:59:59"},"filters":{"relation":"and","items":[{"field":{"name":"country","type":"user_property"},"operator":"eq","values":["US"]}]},"properties":["#event_time",{"name":"country","type":"user_property"}],"sort":[{"field":"#event_time","order":"desc"}]}. Do not pass raw QP/eventView/taFilters.'
 };
+var eventDetailArtifactFormatFlag = {
+  name: "artifact-format",
+  type: "string",
+  required: false,
+  desc: "Native streaming artifact format: jsonl or csv. Default: jsonl."
+};
 function eventDetailRunInput(ctx) {
   return compactInput({
     project_id: ctx.num("project-id"),
@@ -3593,18 +4208,22 @@ function eventDetailRunInput(ctx) {
     request_id: optionalString(ctx, "request-id"),
     use_cache: optionalBoolean(ctx, "use-cache"),
     zone_offset: optionalNumber(ctx, "zone-offset"),
-    limit: optionalNumber(ctx, "limit"),
+    preview_rows: optionalNumber(ctx, "preview-rows"),
     timeout_seconds: optionalNumber(ctx, "timeout-seconds")
   });
 }
 function eventDetailExportInput(ctx) {
+  const format = optionalString(ctx, "artifact-format");
+  if (format !== void 0 && format !== "jsonl" && format !== "csv") {
+    throw new Error("--artifact-format only supports jsonl or csv for event detail export");
+  }
   return compactInput({
     project_id: ctx.num("project-id"),
     definition: ctx.json("definition"),
     request_id: optionalString(ctx, "request-id"),
     use_cache: optionalBoolean(ctx, "use-cache"),
     zone_offset: optionalNumber(ctx, "zone-offset"),
-    format: optionalString(ctx, "artifact-format"),
+    format,
     timeout_seconds: optionalNumber(ctx, "timeout-seconds")
   });
 }
@@ -3617,7 +4236,7 @@ var eventDetailBaseFlags = [
 ];
 var eventDetailExportFlags = [
   ...eventDetailBaseFlags,
-  artifactFormatFlag,
+  eventDetailArtifactFormatFlag,
   asyncTimeoutSecondsFlag
 ];
 
@@ -3629,12 +4248,11 @@ var eventDetailRun = createAnalysisCapabilityCommand({
   description: `Run a bounded event detail query from an AI-facing definition. ${analysisDataRunRoutingHelp}`,
   flags: [
     ...eventDetailBaseFlags,
-    detailPreviewLimitFlag,
+    previewRowsFlag,
     syncTimeoutSecondsFlag
   ],
   risk: "read",
-  buildInput: eventDetailRunInput,
-  postProcess: applyAnalysisInlineLimit
+  buildInput: eventDetailRunInput
 });
 
 // src/commands/te-analysis/event-detail/export.ts
@@ -3642,7 +4260,8 @@ var eventDetailExport = createAnalysisCapabilityCommand({
   resource: "event-detail",
   command: "export",
   capabilityId: "analysis.event_detail.export",
-  description: "Export complete event detail data as an asynchronous gzip artifact. The server reads backend pages internally; callers inspect and download one artifact without pagination.",
+  asyncArtifact: true,
+  description: "Export complete event detail data through the native Trino JSONL or CSV stream as an asynchronous gzip artifact. Default: JSONL.",
   flags: [
     ...eventDetailExportFlags
   ],
@@ -3651,11 +4270,11 @@ var eventDetailExport = createAnalysisCapabilityCommand({
 });
 
 // src/commands/te-analysis/event-detail/index.ts
-var commands33 = [
+var commands35 = [
   eventDetailRun,
   eventDetailExport
 ];
-var event_detail_default = commands33;
+var event_detail_default = commands35;
 
 // src/commands/te-analysis/entity-detail/shared.ts
 var entityDetailDefinitionFlag = {
@@ -3664,6 +4283,12 @@ var entityDetailDefinitionFlag = {
   required: true,
   desc: 'Bounded entity detail definition. properties is supported only for entity="user" (#user_id); user rows always include #user_id, #account_id, and #distinct_id plus requested user properties. Custom entities reject properties and return only their entity value column. cohort is AI-facing for user_property/tag/cluster filters; do not pass raw QP.'
 };
+var entityDetailArtifactFormatFlag = {
+  name: "artifact-format",
+  type: "string",
+  required: false,
+  desc: "Native streaming artifact format: jsonl or csv. Default: jsonl."
+};
 function entityDetailRunInput(ctx) {
   return compactInput({
     project_id: ctx.num("project-id"),
@@ -3671,18 +4296,22 @@ function entityDetailRunInput(ctx) {
     request_id: optionalString(ctx, "request-id"),
     use_cache: optionalBoolean(ctx, "use-cache"),
     zone_offset: optionalNumber(ctx, "zone-offset"),
-    limit: optionalNumber(ctx, "limit"),
+    preview_rows: optionalNumber(ctx, "preview-rows"),
     timeout_seconds: optionalNumber(ctx, "timeout-seconds")
   });
 }
 function entityDetailExportInput(ctx) {
+  const format = optionalString(ctx, "artifact-format");
+  if (format !== void 0 && format !== "jsonl" && format !== "csv") {
+    throw new Error("--artifact-format only supports jsonl or csv for entity detail export");
+  }
   return compactInput({
     project_id: ctx.num("project-id"),
     definition: ctx.json("definition"),
     request_id: optionalString(ctx, "request-id"),
     use_cache: optionalBoolean(ctx, "use-cache"),
     zone_offset: optionalNumber(ctx, "zone-offset"),
-    format: optionalString(ctx, "artifact-format"),
+    format,
     timeout_seconds: optionalNumber(ctx, "timeout-seconds")
   });
 }
@@ -3695,7 +4324,7 @@ var entityDetailBaseFlags = [
 ];
 var entityDetailExportFlags = [
   ...entityDetailBaseFlags,
-  artifactFormatFlag,
+  entityDetailArtifactFormatFlag,
   asyncTimeoutSecondsFlag
 ];
 
@@ -3707,12 +4336,11 @@ var entityDetailRun = createAnalysisCapabilityCommand({
   description: `Run a bounded entity detail query from a cluster cohort definition. ${analysisDataRunRoutingHelp}`,
   flags: [
     ...entityDetailBaseFlags,
-    detailPreviewLimitFlag,
+    previewRowsFlag,
     syncTimeoutSecondsFlag
   ],
   risk: "read",
-  buildInput: entityDetailRunInput,
-  postProcess: applyAnalysisInlineLimit
+  buildInput: entityDetailRunInput
 });
 
 // src/commands/te-analysis/entity-detail/export.ts
@@ -3720,7 +4348,8 @@ var entityDetailExport = createAnalysisCapabilityCommand({
   resource: "entity-detail",
   command: "export",
   capabilityId: "analysis.entity_detail.export",
-  description: "Export complete entity detail data as an asynchronous gzip artifact. The server reads backend pages internally; callers inspect and download one artifact without pagination.",
+  asyncArtifact: true,
+  description: "Export complete entity detail data through the native Trino JSONL or CSV stream as an asynchronous gzip artifact. Default: JSONL.",
   flags: [
     ...entityDetailExportFlags
   ],
@@ -3729,11 +4358,11 @@ var entityDetailExport = createAnalysisCapabilityCommand({
 });
 
 // src/commands/te-analysis/entity-detail/index.ts
-var commands34 = [
+var commands36 = [
   entityDetailRun,
   entityDetailExport
 ];
-var entity_detail_default = commands34;
+var entity_detail_default = commands36;
 
 // src/commands/te-analysis/drilldown-events/shared.ts
 var queryContextIdFlag = {
@@ -3750,7 +4379,7 @@ var drilldownEventsRunFlags = [
   propertiesFlag,
   requestIdFlag,
   useCacheFlag,
-  detailPreviewLimitFlag,
+  previewRowsFlag,
   syncTimeoutSecondsFlag
 ];
 var csvArtifactFormatFlag = {
@@ -3779,7 +4408,7 @@ function drilldownEventsRunInput(ctx) {
     properties: optionalJson(ctx, "properties"),
     request_id: optionalString(ctx, "request-id"),
     use_cache: optionalBoolean(ctx, "use-cache"),
-    limit: optionalNumber(ctx, "limit"),
+    preview_rows: optionalNumber(ctx, "preview-rows"),
     timeout_seconds: optionalNumber(ctx, "timeout-seconds")
   });
 }
@@ -3802,6 +4431,7 @@ var drilldownEventsExport = createAnalysisCapabilityCommand({
   resource: "drilldown-events",
   command: "export",
   capabilityId: "analysis.query.drilldown_events_export",
+  asyncArtifact: true,
   description: `Stream all raw events behind one synchronous event-analysis cell into one csv.gz artifact. ${analysisDataExportRoutingHelp}`,
   flags: [...drilldownEventsExportFlags],
   risk: "read",
@@ -3816,13 +4446,12 @@ var drilldownEventsRun = createAnalysisCapabilityCommand({
   description: `Preview raw events behind one synchronous event-analysis cell whose selected metric advertises drilldown_events. ${analysisDataRunRoutingHelp}`,
   flags: [...drilldownEventsRunFlags],
   risk: "read",
-  buildInput: drilldownEventsRunInput,
-  postProcess: applyAnalysisInlineLimit
+  buildInput: drilldownEventsRunInput
 });
 
 // src/commands/te-analysis/drilldown-events/index.ts
-var commands35 = [drilldownEventsRun, drilldownEventsExport];
-var drilldown_events_default = commands35;
+var commands37 = [drilldownEventsRun, drilldownEventsExport];
+var drilldown_events_default = commands37;
 
 // src/commands/te-analysis/drilldown-entities/shared.ts
 var queryContextIdFlag2 = {
@@ -3848,7 +4477,7 @@ var drilldownEntitiesBaseFlags = [
 ];
 var drilldownEntitiesRunFlags = [
   ...drilldownEntitiesBaseFlags,
-  detailPreviewLimitFlag,
+  previewRowsFlag,
   syncTimeoutSecondsFlag
 ];
 var drilldownEntitiesExportFlags = [
@@ -3859,7 +4488,7 @@ var drilldownEntitiesExportFlags = [
 function drilldownEntitiesRunInput(ctx) {
   return compactInput({
     ...baseInput(ctx),
-    limit: optionalNumber(ctx, "limit"),
+    preview_rows: optionalNumber(ctx, "preview-rows"),
     timeout_seconds: optionalNumber(ctx, "timeout-seconds")
   });
 }
@@ -3887,6 +4516,7 @@ var drilldownEntitiesExport = createAnalysisCapabilityCommand({
   resource: "drilldown-entities",
   command: "export",
   capabilityId: "analysis.query.drilldown_entities_export",
+  asyncArtifact: true,
   description: `Stream all users or custom entities behind one synchronous-preview cell into one csv.gz artifact. ${analysisDataExportRoutingHelp}`,
   flags: [...drilldownEntitiesExportFlags],
   risk: "read",
@@ -3901,13 +4531,12 @@ var drilldownEntitiesRun = createAnalysisCapabilityCommand({
   description: `Preview users or custom entities behind one synchronous-preview cell whose metric advertises drilldown_entities. ${analysisDataRunRoutingHelp}`,
   flags: [...drilldownEntitiesRunFlags],
   risk: "read",
-  buildInput: drilldownEntitiesRunInput,
-  postProcess: applyAnalysisInlineLimit
+  buildInput: drilldownEntitiesRunInput
 });
 
 // src/commands/te-analysis/drilldown-entities/index.ts
-var commands36 = [drilldownEntitiesRun, drilldownEntitiesExport];
-var drilldown_entities_default = commands36;
+var commands38 = [drilldownEntitiesRun, drilldownEntitiesExport];
+var drilldown_entities_default = commands38;
 
 // src/commands/te-analysis/drilldown-user-events/shared.ts
 var drilldownContextIdFlag = {
@@ -3946,7 +4575,7 @@ var drilldownUserEventsBaseFlags = [
 ];
 var drilldownUserEventsRunFlags = [
   ...drilldownUserEventsBaseFlags,
-  detailPreviewLimitFlag,
+  previewRowsFlag,
   syncTimeoutSecondsFlag
 ];
 var drilldownUserEventsExportFlags = [
@@ -3957,7 +4586,7 @@ var drilldownUserEventsExportFlags = [
 function drilldownUserEventsRunInput(ctx) {
   return compactInput({
     ...baseInput2(ctx),
-    limit: optionalNumber(ctx, "limit"),
+    preview_rows: optionalNumber(ctx, "preview-rows"),
     timeout_seconds: optionalNumber(ctx, "timeout-seconds")
   });
 }
@@ -3989,6 +4618,7 @@ var drilldownUserEventsExport = createAnalysisCapabilityCommand({
   resource: "drilldown-user-events",
   command: "export",
   capabilityId: "analysis.query.drilldown_user_events_export",
+  asyncArtifact: true,
   description: `Stream one user's complete event sequence from a drilldown context into one csv.gz artifact. ${analysisDataExportRoutingHelp}`,
   flags: [...drilldownUserEventsExportFlags],
   risk: "read",
@@ -4003,13 +4633,12 @@ var drilldownUserEventsRun = createAnalysisCapabilityCommand({
   description: `Preview one user's event sequence from a drilldown context. Do not pass raw QP. ${analysisDataRunRoutingHelp}`,
   flags: [...drilldownUserEventsRunFlags],
   risk: "read",
-  buildInput: drilldownUserEventsRunInput,
-  postProcess: applyAnalysisInlineLimit
+  buildInput: drilldownUserEventsRunInput
 });
 
 // src/commands/te-analysis/drilldown-user-events/index.ts
-var commands37 = [drilldownUserEventsRun, drilldownUserEventsExport];
-var drilldown_user_events_default = commands37;
+var commands39 = [drilldownUserEventsRun, drilldownUserEventsExport];
+var drilldown_user_events_default = commands39;
 
 // src/commands/te-analysis/user/index.ts
 import { existsSync, statSync } from "fs";
@@ -4035,6 +4664,12 @@ var clusterMemberFieldsFlag = {
   ...fieldsFlag,
   desc: "Optional result fields. Defaults to #user_id, #account_id, and #distinct_id."
 };
+var memberPreviewRowsFlag = {
+  ...previewRowsFlag,
+  max: 1e5,
+  desc: "Maximum business rows returned per result. Default: 1000, matching the UI member query. Maximum: 100000."
+};
+var memberDataRunRoutingHelp = "Routing: --preview-rows bounds returned business rows per result; omitting it defaults to 1000 rows, matching the UI member query. Use export for full, unknown-size, timed-out, or long-running data.";
 var clusterNameFlag = {
   name: "cluster-name",
   type: "string",
@@ -4100,6 +4735,12 @@ var zoneOffsetFlag3 = {
   required: false,
   desc: "Optional timezone offset. UTC+8 is 8; UTC-5 is -5."
 };
+var autoRefreshCronFlag = {
+  name: "auto-refresh-cron",
+  type: "string",
+  required: false,
+  desc: "Optional Quartz cron expression for an existing enabled auto-refresh schedule. This does not enable auto refresh."
+};
 var entityIdFlag = {
   name: "entity-id",
   type: "number",
@@ -4171,7 +4812,13 @@ var jsonlArtifactFormatFlag = {
   name: "artifact-format",
   type: "string",
   required: false,
-  desc: "Artifact format. Only jsonl is supported for user member/history-tag exports."
+  desc: "Artifact format. Only jsonl is supported for history-tag statistics exports."
+};
+var memberArtifactFormatFlag = {
+  name: "artifact-format",
+  type: "string",
+  required: false,
+  desc: "Artifact format: jsonl or csv. Default: jsonl. Both formats use native full-download streaming and gzip compression."
 };
 var confirmedFlag = {
   name: "confirmed",
@@ -4197,7 +4844,7 @@ var groupColFlag = {
   required: true,
   desc: "Exact statistic value or bucket from history-tag-data results to drill down into."
 };
-function capability(resource, command, capabilityId, description, flags, risk, buildInput2) {
+function capability(resource, command, capabilityId, description, flags, risk, buildInput2, options = {}) {
   return createAnalysisCapabilityCommand({
     resource,
     command,
@@ -4205,7 +4852,8 @@ function capability(resource, command, capabilityId, description, flags, risk, b
     description,
     flags,
     risk,
-    buildInput: buildInput2
+    buildInput: buildInput2,
+    ...options
   });
 }
 function idImportCapability(command) {
@@ -4292,13 +4940,21 @@ function uploadedInputFileId(value) {
 function assetListInput(ctx) {
   return compactInput({
     project_id: ctx.num("project-id"),
-    query: optionalString(ctx, "query"),
+    queries: optionalQueries(ctx),
     fields: optionalJsonArray(ctx, "fields"),
     limit: optionalNumber(ctx, "limit"),
     offset: optionalNumber(ctx, "offset"),
     authenticated_only: optionalBoolean(ctx, "authenticated-only")
   });
 }
+function assetExportInput(ctx) {
+  return compactInput({
+    project_id: ctx.num("project-id"),
+    queries: optionalQueries(ctx),
+    fields: optionalJsonArray(ctx, "fields"),
+    authenticated_only: optionalBoolean(ctx, "authenticated-only")
+  });
+}
 function memberInput(ctx, kind, inline) {
   return compactInput({
     project_id: ctx.num("project-id"),
@@ -4306,13 +4962,13 @@ function memberInput(ctx, kind, inline) {
     tag_name: kind === "tag" ? ctx.str("tag-name") : void 0,
     snapshot_date: kind === "tag" ? optionalString(ctx, "snapshot-date") : void 0,
     property_names: optionalJsonArray(ctx, "property-names"),
-    fields: optionalJsonArray(ctx, "fields"),
-    query: optionalString(ctx, "query"),
-    use_cache: optionalBoolean(ctx, "use-cache"),
+    fields: inline ? optionalJsonArray(ctx, "fields") : void 0,
+    query: inline ? optionalString(ctx, "query") : void 0,
+    use_cache: inline ? optionalBoolean(ctx, "use-cache") : void 0,
+    preview_rows: inline ? optionalNumber(ctx, "preview-rows") : void 0,
     request_id: optionalString(ctx, "request-id"),
     timeout_seconds: optionalNumber(ctx, "timeout-seconds"),
-    limit: inline ? optionalNumber(ctx, "limit") : void 0,
-    format: inline ? void 0 : optionalJsonlFormat(ctx)
+    format: inline ? void 0 : optionalMemberFormat(ctx)
   });
 }
 function clusterWriteInput(ctx, create) {
@@ -4326,6 +4982,7 @@ function clusterWriteInput(ctx, create) {
     authenticated_only: optionalBoolean(ctx, "authenticated-only"),
     remark: create ? void 0 : optionalString(ctx, "remark"),
     zone_offset: optionalNumber(ctx, "zone-offset"),
+    auto_refresh_cron: create ? void 0 : optionalString(ctx, "auto-refresh-cron"),
     entity_id: create ? optionalNumber(ctx, "entity-id") : void 0
   });
 }
@@ -4340,6 +4997,7 @@ function tagWriteInput(ctx, create) {
     authenticated_only: optionalBoolean(ctx, "authenticated-only"),
     remark: create ? void 0 : optionalString(ctx, "remark"),
     zone_offset: optionalNumber(ctx, "zone-offset"),
+    auto_refresh_cron: create ? void 0 : optionalString(ctx, "auto-refresh-cron"),
     entity_id: create ? optionalNumber(ctx, "entity-id") : void 0
   });
 }
@@ -4377,9 +5035,9 @@ function historyTagDataInput(ctx, inline) {
     project_id: ctx.num("project-id"),
     tag_name: ctx.str("tag-name"),
     view: ctx.json("view"),
+    preview_rows: inline ? optionalNumber(ctx, "preview-rows") : void 0,
     request_id: optionalString(ctx, "request-id"),
     timeout_seconds: optionalNumber(ctx, "timeout-seconds"),
-    limit: inline ? optionalNumber(ctx, "limit") : void 0,
     format: inline ? void 0 : optionalJsonlFormat(ctx)
   });
 }
@@ -4391,13 +5049,13 @@ function historyTagDataDrilldownInput(ctx, inline) {
     group_col: ctx.str("group-col"),
     view: ctx.json("view"),
     property_names: optionalJsonArray(ctx, "property-names"),
-    fields: optionalJsonArray(ctx, "fields"),
-    query: optionalString(ctx, "query"),
-    use_cache: optionalBoolean(ctx, "use-cache"),
+    fields: inline ? optionalJsonArray(ctx, "fields") : void 0,
+    query: inline ? optionalString(ctx, "query") : void 0,
+    use_cache: inline ? optionalBoolean(ctx, "use-cache") : void 0,
+    preview_rows: inline ? optionalNumber(ctx, "preview-rows") : void 0,
     request_id: optionalString(ctx, "request-id"),
     timeout_seconds: optionalNumber(ctx, "timeout-seconds"),
-    limit: inline ? optionalNumber(ctx, "limit") : void 0,
-    format: inline ? void 0 : optionalJsonlFormat(ctx)
+    format: inline ? void 0 : optionalMemberFormat(ctx)
   });
 }
 function optionalJsonlFormat(ctx) {
@@ -4407,30 +5065,86 @@ function optionalJsonlFormat(ctx) {
   }
   return format;
 }
-var listFlags = [projectIdFlag, queryFlag, fieldsFlag, directoryLimitFlag, offsetFlag, authenticatedOnlyFlag];
-var tagListFlags = [projectIdFlag, queryFlag, tagListFieldsFlag, directoryLimitFlag, offsetFlag, authenticatedOnlyFlag];
+function optionalMemberFormat(ctx) {
+  const format = optionalString(ctx, "artifact-format");
+  if (format !== void 0 && format !== "jsonl" && format !== "csv") {
+    throw new Error("--artifact-format only supports jsonl or csv for member full-download exports");
+  }
+  return format;
+}
+var listFlags = [
+  projectIdFlag,
+  queriesFlag,
+  fieldsFlag,
+  directoryLimitFlag,
+  directoryOffsetFlag,
+  authenticatedOnlyFlag
+];
+var tagListFlags = [
+  projectIdFlag,
+  queriesFlag,
+  tagListFieldsFlag,
+  directoryLimitFlag,
+  directoryOffsetFlag,
+  authenticatedOnlyFlag
+];
+var exportFlags = [
+  projectIdFlag,
+  queriesFlag,
+  fieldsFlag,
+  authenticatedOnlyFlag,
+  catalogExportOutputFlag
+];
+var tagExportFlags = [
+  projectIdFlag,
+  queriesFlag,
+  tagListFieldsFlag,
+  authenticatedOnlyFlag,
+  catalogExportOutputFlag
+];
 var memberRunFlags = (memberFieldsFlag) => [
   projectIdFlag,
   propertyNamesFlag,
   memberFieldsFlag,
   queryFlag,
   { name: "use-cache", type: "boolean", required: false, desc: "Whether to use query cache. Default: true." },
+  memberPreviewRowsFlag,
   requestIdFlag,
-  memberLimitFlag,
   syncTimeoutSecondsFlag
 ];
-var memberExportFlags = (memberFieldsFlag) => [
+var memberExportFlags = [
   projectIdFlag,
   propertyNamesFlag,
-  memberFieldsFlag,
-  queryFlag,
-  { name: "use-cache", type: "boolean", required: false, desc: "Whether to use query cache. Default: true." },
   requestIdFlag,
-  jsonlArtifactFormatFlag,
+  memberArtifactFormatFlag,
   asyncTimeoutSecondsFlag
 ];
-var commands38 = [
-  capability("user-cluster", "list", "analysis.user_cluster.list", "List user clusters for discovery. Use offset only for stable asset browsing.", listFlags, "read", assetListInput),
+var commands40 = [
+  capability(
+    "user-cluster",
+    "list",
+    "analysis.user_cluster.list",
+    "List user clusters with bounded discovery.",
+    listFlags,
+    "read",
+    assetListInput,
+    {
+      validate: validateCatalogListFlags
+    }
+  ),
+  capability(
+    "user-cluster",
+    "export",
+    "analysis.user_cluster.export",
+    "Export the complete matching user-cluster catalog to JSONL with an integrity sidecar.",
+    exportFlags,
+    "read",
+    assetExportInput,
+    {
+      validate: validateCatalogExportFlags,
+      postProcess: catalogExportPostProcess("cluster", "items")
+    }
+  ),
   capability("user-cluster", "get", "analysis.user_cluster.get", "Get user cluster details by exact cluster_name values.", [
     projectIdFlag,
     { name: "cluster-names", type: "json", required: true, desc: "JSON array of exact cluster_name values." }
@@ -4438,14 +5152,14 @@ var commands38 = [
     project_id: ctx.num("project-id"),
     cluster_names: ctx.json("cluster-names")
   })),
-  capability("user-cluster-member", "list", "analysis.user_cluster_member.list", `Run a bounded user cluster member query. ${analysisDataRunRoutingHelp}`, [
+  capability("user-cluster-member", "list", "analysis.user_cluster_member.list", `Run a bounded user cluster member query. ${memberDataRunRoutingHelp}`, [
     clusterNameFlag,
     ...memberRunFlags(clusterMemberFieldsFlag)
   ], "read", (ctx) => memberInput(ctx, "cluster", true)),
-  capability("user-cluster-member", "export", "analysis.user_cluster_member.export", `Export user cluster members as a jsonl artifact. ${analysisDataExportRoutingHelp}`, [
+  capability("user-cluster-member", "export", "analysis.user_cluster_member.export", `Stream the native full user-cluster download as a jsonl.gz or csv.gz artifact. ${analysisDataExportRoutingHelp}`, [
     clusterNameFlag,
-    ...memberExportFlags(clusterMemberFieldsFlag)
-  ], "read", (ctx) => memberInput(ctx, "cluster", false)),
+    ...memberExportFlags
+  ], "read", (ctx) => memberInput(ctx, "cluster", false), { asyncArtifact: true }),
   capability("user-cluster", "create", "analysis.user_cluster.create", "Create a condition or SQL user cluster directly from an AI-facing definition request.", [
     projectIdFlag,
     newClusterNameFlag,
@@ -4462,7 +5176,8 @@ var commands38 = [
     optionalClusterDefinitionRequestFlag,
     authenticatedOnlyFlag,
     remarkFlag,
-    zoneOffsetFlag3
+    zoneOffsetFlag3,
+    autoRefreshCronFlag
   ], "write", (ctx) => clusterWriteInput(ctx, false)),
   idImportCapability(capability("user-cluster", "create-id", "analysis.user_cluster.create_id", "Create a cluster by mapping imported values to an analysis entity.", [
     projectIdFlag,
@@ -4496,7 +5211,31 @@ var commands38 = [
     cluster_name: ctx.str("cluster-name"),
     confirmed: optionalBoolean(ctx, "confirmed")
   })),
-  capability("user-tag", "list", "analysis.user_tag.list", "List user tags for discovery. Returned identifiers use canonical tag_name. Use offset only for stable asset browsing.", tagListFlags, "read", assetListInput),
+  capability(
+    "user-tag",
+    "list",
+    "analysis.user_tag.list",
+    "List user tags with bounded discovery. Returned identifiers use canonical tag_name.",
+    tagListFlags,
+    "read",
+    assetListInput,
+    {
+      validate: validateCatalogListFlags
+    }
+  ),
+  capability(
+    "user-tag",
+    "export",
+    "analysis.user_tag.export",
+    "Export the complete matching user-tag catalog to JSONL with an integrity sidecar.",
+    tagExportFlags,
+    "read",
+    assetExportInput,
+    {
+      validate: validateCatalogExportFlags,
+      postProcess: catalogExportPostProcess("tag", "items")
+    }
+  ),
   capability("user-tag", "get", "analysis.user_tag.get", "Get user tag details by exact tag_name values.", [
     projectIdFlag,
     { name: "tag-names", type: "json", required: true, desc: "JSON array of exact tag_name values." }
@@ -4504,16 +5243,16 @@ var commands38 = [
     project_id: ctx.num("project-id"),
     tag_names: ctx.json("tag-names")
   })),
-  capability("user-tag-member", "list", "analysis.user_tag_member.list", `Run a bounded user tag member query. ${analysisDataRunRoutingHelp}`, [
+  capability("user-tag-member", "list", "analysis.user_tag_member.list", `Run a bounded user tag member query. ${memberDataRunRoutingHelp}`, [
     tagNameFlag,
     snapshotDateFlag,
     ...memberRunFlags(tagMemberFieldsFlag)
   ], "read", (ctx) => memberInput(ctx, "tag", true)),
-  capability("user-tag-member", "export", "analysis.user_tag_member.export", `Export user tag members as a jsonl artifact. ${analysisDataExportRoutingHelp}`, [
+  capability("user-tag-member", "export", "analysis.user_tag_member.export", `Stream the native full user-tag download as a jsonl.gz or csv.gz artifact. ${analysisDataExportRoutingHelp}`, [
     tagNameFlag,
     snapshotDateFlag,
-    ...memberExportFlags(tagMemberFieldsFlag)
-  ], "read", (ctx) => memberInput(ctx, "tag", false)),
+    ...memberExportFlags
+  ], "read", (ctx) => memberInput(ctx, "tag", false), { asyncArtifact: true }),
   capability("user-tag", "create", "analysis.user_tag.create", "Create a user tag directly from an AI-facing definition request.", [
     projectIdFlag,
     newTagNameFlag,
@@ -4530,7 +5269,8 @@ var commands38 = [
     optionalTagDefinitionRequestFlag,
     authenticatedOnlyFlag,
     remarkFlag,
-    zoneOffsetFlag3
+    zoneOffsetFlag3,
+    autoRefreshCronFlag
   ], "write", (ctx) => tagWriteInput(ctx, false)),
   capability("user-tag", "refresh", "analysis.user_tag.refresh", "Refresh a user tag by exact tag_name.", [
     projectIdFlag,
@@ -4606,8 +5346,8 @@ var commands38 = [
     projectIdFlag,
     tagNameFlag,
     historyViewFlag,
+    previewRowsFlag,
     requestIdFlag,
-    limitFlag,
     syncTimeoutSecondsFlag
   ], "read", (ctx) => historyTagDataInput(ctx, true)),
   capability("history-tag-data", "export", "analysis.history_tag_data.export", `Export history tag statistics as a jsonl artifact. ${analysisDataExportRoutingHelp}`, [
@@ -4617,7 +5357,7 @@ var commands38 = [
     requestIdFlag,
     jsonlArtifactFormatFlag,
     asyncTimeoutSecondsFlag
-  ], "read", (ctx) => historyTagDataInput(ctx, false)),
+  ], "read", (ctx) => historyTagDataInput(ctx, false), { asyncArtifact: true }),
   capability("history-tag-data-drilldown", "run", "analysis.history_tag_data_drilldown.run", `Run a bounded drilldown user query for one history tag statistic value. ${analysisDataRunRoutingHelp}`, [
     tagNameFlag,
     { ...snapshotDateFlag, required: true, desc: "History tag snapshot date, yyyy-MM-dd." },
@@ -4625,15 +5365,15 @@ var commands38 = [
     historyViewFlag,
     ...memberRunFlags(tagMemberFieldsFlag)
   ], "read", (ctx) => historyTagDataDrilldownInput(ctx, true)),
-  capability("history-tag-data-drilldown", "export", "analysis.history_tag_data_drilldown.export", `Export drilldown users for one history tag statistic value as a jsonl artifact. ${analysisDataExportRoutingHelp}`, [
+  capability("history-tag-data-drilldown", "export", "analysis.history_tag_data_drilldown.export", `Stream the native full history-tag drilldown download as a jsonl.gz or csv.gz artifact. ${analysisDataExportRoutingHelp}`, [
     tagNameFlag,
     { ...snapshotDateFlag, required: true, desc: "History tag snapshot date, yyyy-MM-dd." },
     groupColFlag,
     historyViewFlag,
-    ...memberExportFlags(tagMemberFieldsFlag)
-  ], "read", (ctx) => historyTagDataDrilldownInput(ctx, false))
+    ...memberExportFlags
+  ], "read", (ctx) => historyTagDataDrilldownInput(ctx, false), { asyncArtifact: true })
 ];
-var user_default = commands38;
+var user_default = commands40;
 
 // src/commands/te-analysis/query-cluster/list.ts
 var queryClusterList = createAnalysisCapabilityCommand({
@@ -4647,8 +5387,8 @@ var queryClusterList = createAnalysisCapabilityCommand({
 });
 
 // src/commands/te-analysis/query-cluster/index.ts
-var commands39 = [queryClusterList];
-var query_cluster_default = commands39;
+var commands41 = [queryClusterList];
+var query_cluster_default = commands41;
 
 // src/commands/te-analysis/sql-table/columns.ts
 var sqlTableColumns = createAnalysisCapabilityCommand({
@@ -4680,11 +5420,12 @@ var sqlTableList = createAnalysisCapabilityCommand({
   command: "list",
   capabilityId: "analysis.sql_table.list",
   description: "List server-authoritative SQL table references queryable by the current user in a project.",
-  flags: [projectIdFlag, queryFlag, directoryLimitFlag, offsetFlag, sqlTableUsageFlag],
+  flags: [projectIdFlag, queriesFlag, directoryLimitFlag, directoryOffsetFlag, sqlTableUsageFlag],
   risk: "read",
+  validate: validateQueriesFlag,
   buildInput: (ctx) => compactInput({
     project_id: ctx.num("project-id"),
-    query: optionalString(ctx, "query"),
+    queries: optionalQueries(ctx),
     limit: optionalNumber(ctx, "limit"),
     offset: optionalNumber(ctx, "offset"),
     usage: optionalString(ctx, "usage")
@@ -4692,8 +5433,8 @@ var sqlTableList = createAnalysisCapabilityCommand({
 });
 
 // src/commands/te-analysis/sql-table/index.ts
-var commands40 = [sqlTableList, sqlTableColumns];
-var sql_table_default = commands40;
+var commands42 = [sqlTableList, sqlTableColumns];
+var sql_table_default = commands42;
 
 // src/commands/te-analysis/entity/id-import-options.ts
 var entityIdImportOptions = createAnalysisCapabilityCommand({
@@ -4718,8 +5459,8 @@ var entityIdImportOptions = createAnalysisCapabilityCommand({
 });
 
 // src/commands/te-analysis/entity/index.ts
-var commands41 = [entityIdImportOptions];
-var entity_default = commands41;
+var commands43 = [entityIdImportOptions];
+var entity_default = commands43;
 
 // src/commands/te-analysis/input-file/inspect.ts
 var inputFileInspect = {
@@ -4802,8 +5543,8 @@ var inputFileUpload = {
 };
 
 // src/commands/te-analysis/input-file/index.ts
-var commands42 = [inputFileUpload, inputFileInspect, inputFilePurposeList];
-var input_file_default = commands42;
+var commands44 = [inputFileUpload, inputFileInspect, inputFilePurposeList];
+var input_file_default = commands44;
 
 // src/commands/te-analysis/project/access-detail/get.ts
 var projectAccessDetailGet = createAnalysisCapabilityCommand({
@@ -4821,10 +5562,10 @@ var projectAccessDetailGet = createAnalysisCapabilityCommand({
 });
 
 // src/commands/te-analysis/project/access-detail/index.ts
-var commands43 = [
+var commands45 = [
   projectAccessDetailGet
 ];
-var access_detail_default = commands43;
+var access_detail_default = commands45;
 
 // src/commands/te-analysis/project/data-power/delete.ts
 var projectDataPowerDelete = createAnalysisCapabilityCommand({
@@ -4896,13 +5637,13 @@ var projectDataPowerUpsert = createAnalysisCapabilityCommand({
 });
 
 // src/commands/te-analysis/project/data-power/index.ts
-var commands44 = [
+var commands46 = [
   projectDataPowerDelete,
   projectDataPowerGet,
   projectDataPowerList,
   projectDataPowerUpsert
 ];
-var data_power_default = commands44;
+var data_power_default = commands46;
 
 // src/commands/te-analysis/project/entity/create.ts
 var projectEntityCreate = createAnalysisCapabilityCommand({
@@ -5013,14 +5754,14 @@ var projectEntityUpdate = createAnalysisCapabilityCommand({
 });
 
 // src/commands/te-analysis/project/entity/index.ts
-var commands45 = [
+var commands47 = [
   projectEntityCreate,
   projectEntityDelete,
   projectEntityGet,
   projectEntityList,
   projectEntityUpdate
 ];
-var entity_default2 = commands45;
+var entity_default2 = commands47;
 
 // src/commands/te-analysis/project/entity-event/list.ts
 var projectEntityEventList = createAnalysisCapabilityCommand({
@@ -5040,10 +5781,10 @@ var projectEntityEventList = createAnalysisCapabilityCommand({
 });
 
 // src/commands/te-analysis/project/entity-event/index.ts
-var commands46 = [
+var commands48 = [
   projectEntityEventList
 ];
-var entity_event_default = commands46;
+var entity_event_default = commands48;
 
 // src/commands/te-analysis/project/function/list.ts
 var projectFunctionList = createAnalysisCapabilityCommand({
@@ -5063,10 +5804,10 @@ var projectFunctionList = createAnalysisCapabilityCommand({
 });
 
 // src/commands/te-analysis/project/function/index.ts
-var commands47 = [
+var commands49 = [
   projectFunctionList
 ];
-var function_default = commands47;
+var function_default = commands49;
 
 // src/commands/te-analysis/project/info/create.ts
 var projectInfoCreate = createAnalysisCapabilityCommand({
@@ -5161,14 +5902,14 @@ var projectInfoUpdate = createAnalysisCapabilityCommand({
 });
 
 // src/commands/te-analysis/project/info/index.ts
-var commands48 = [
+var commands50 = [
   projectInfoCreate,
   projectInfoDelete,
   projectInfoGet,
   projectInfoList,
   projectInfoUpdate
 ];
-var info_default = commands48;
+var info_default = commands50;
 
 // src/commands/te-analysis/project/mark-time/create.ts
 var projectMarkTimeCreate = createAnalysisCapabilityCommand({
@@ -5262,13 +6003,13 @@ var projectMarkTimeUpdate = createAnalysisCapabilityCommand({
 });
 
 // src/commands/te-analysis/project/mark-time/index.ts
-var commands49 = [
+var commands51 = [
   projectMarkTimeCreate,
   projectMarkTimeDelete,
   projectMarkTimeList,
   projectMarkTimeUpdate
 ];
-var mark_time_default = commands49;
+var mark_time_default = commands51;
 
 // src/commands/te-analysis/project/member/add.ts
 var projectMemberAdd = createAnalysisCapabilityCommand({
@@ -5379,7 +6120,7 @@ var projectMemberUpdate = createAnalysisCapabilityCommand({
 });
 
 // src/commands/te-analysis/project/member/index.ts
-var commands50 = [
+var commands52 = [
   projectMemberAdd,
   projectMemberBatchUpdate,
   projectMemberImport,
@@ -5387,7 +6128,7 @@ var commands50 = [
   projectMemberRemove,
   projectMemberUpdate
 ];
-var member_default = commands50;
+var member_default = commands52;
 
 // src/commands/te-analysis/project/member-candidate/list.ts
 var projectMemberCandidateList = createAnalysisCapabilityCommand({
@@ -5409,16 +6150,17 @@ var projectMemberCandidateList = createAnalysisCapabilityCommand({
 });
 
 // src/commands/te-analysis/project/member-candidate/index.ts
-var commands51 = [
+var commands53 = [
   projectMemberCandidateList
 ];
-var member_candidate_default = commands51;
+var member_candidate_default = commands53;
 
 // src/commands/te-analysis/project/member-handover/export.ts
 var projectMemberHandoverExport = createAnalysisCapabilityCommand({
   resource: "project member-handover",
   command: "export",
   capabilityId: "project.member_handover.export",
+  asyncArtifact: true,
   description: "Run batch project member asset handover and export the generated detail file as a CLI artifact.",
   flags: [
     projectIdFlag,
@@ -5452,11 +6194,11 @@ var projectMemberHandoverRun = createAnalysisCapabilityCommand({
 });
 
 // src/commands/te-analysis/project/member-handover/index.ts
-var commands52 = [
+var commands54 = [
   projectMemberHandoverExport,
   projectMemberHandoverRun
 ];
-var member_handover_default = commands52;
+var member_handover_default = commands54;
 
 // src/commands/te-analysis/project/member-receiver/list.ts
 var projectMemberReceiverList = createAnalysisCapabilityCommand({
@@ -5474,10 +6216,10 @@ var projectMemberReceiverList = createAnalysisCapabilityCommand({
 });
 
 // src/commands/te-analysis/project/member-receiver/index.ts
-var commands53 = [
+var commands55 = [
   projectMemberReceiverList
 ];
-var member_receiver_default = commands53;
+var member_receiver_default = commands55;
 
 // src/commands/te-analysis/project/owner/update.ts
 var projectOwnerUpdate = createAnalysisCapabilityCommand({
@@ -5503,10 +6245,10 @@ var projectOwnerUpdate = createAnalysisCapabilityCommand({
 });
 
 // src/commands/te-analysis/project/owner/index.ts
-var commands54 = [
+var commands56 = [
   projectOwnerUpdate
 ];
-var owner_default = commands54;
+var owner_default = commands56;
 
 // src/commands/te-analysis/project/permission-binding/list.ts
 var projectPermissionBindingList = createAnalysisCapabilityCommand({
@@ -5528,10 +6270,10 @@ var projectPermissionBindingList = createAnalysisCapabilityCommand({
 });
 
 // src/commands/te-analysis/project/permission-binding/index.ts
-var commands55 = [
+var commands57 = [
   projectPermissionBindingList
 ];
-var permission_binding_default = commands55;
+var permission_binding_default = commands57;
 
 // src/commands/te-analysis/project/receive-status/update.ts
 var projectReceiveStatusUpdate = createAnalysisCapabilityCommand({
@@ -5552,10 +6294,10 @@ var projectReceiveStatusUpdate = createAnalysisCapabilityCommand({
 });
 
 // src/commands/te-analysis/project/receive-status/index.ts
-var commands56 = [
+var commands58 = [
   projectReceiveStatusUpdate
 ];
-var receive_status_default = commands56;
+var receive_status_default = commands58;
 
 // src/commands/te-analysis/project/role/delete.ts
 var projectRoleDelete = createAnalysisCapabilityCommand({
@@ -5631,13 +6373,13 @@ var projectRoleUpsert = createAnalysisCapabilityCommand({
 });
 
 // src/commands/te-analysis/project/role/index.ts
-var commands57 = [
+var commands59 = [
   projectRoleDelete,
   projectRoleGet,
   projectRoleList,
   projectRoleUpsert
 ];
-var role_default = commands57;
+var role_default = commands59;
 
 // src/commands/te-analysis/project/role-function/list.ts
 var projectRoleFunctionList = createAnalysisCapabilityCommand({
@@ -5663,10 +6405,10 @@ var projectRoleFunctionList = createAnalysisCapabilityCommand({
 });
 
 // src/commands/te-analysis/project/role-function/index.ts
-var commands58 = [
+var commands60 = [
   projectRoleFunctionList
 ];
-var role_function_default = commands58;
+var role_function_default = commands60;
 
 // src/commands/te-analysis/project/role-user/list.ts
 var projectRoleUserList = createAnalysisCapabilityCommand({
@@ -5686,10 +6428,10 @@ var projectRoleUserList = createAnalysisCapabilityCommand({
 });
 
 // src/commands/te-analysis/project/role-user/index.ts
-var commands59 = [
+var commands61 = [
   projectRoleUserList
 ];
-var role_user_default = commands59;
+var role_user_default = commands61;
 
 // src/commands/te-analysis/project/timezone/get.ts
 var projectTimezoneGet = createAnalysisCapabilityCommand({
@@ -5741,12 +6483,12 @@ var projectTimezoneUpdate = createAnalysisCapabilityCommand({
 });
 
 // src/commands/te-analysis/project/timezone/index.ts
-var commands60 = [
+var commands62 = [
   projectTimezoneGet,
   projectTimezoneOverview,
   projectTimezoneUpdate
 ];
-var timezone_default = commands60;
+var timezone_default = commands62;
 
 // src/commands/te-analysis/project/user-id-items/update.ts
 var projectUserIdItemsUpdate = createAnalysisCapabilityCommand({
@@ -5766,13 +6508,13 @@ var projectUserIdItemsUpdate = createAnalysisCapabilityCommand({
 });
 
 // src/commands/te-analysis/project/user-id-items/index.ts
-var commands61 = [
+var commands63 = [
   projectUserIdItemsUpdate
 ];
-var user_id_items_default = commands61;
+var user_id_items_default = commands63;
 
 // src/commands/te-analysis/project/index.ts
-var commands62 = [
+var commands64 = [
   ...access_detail_default,
   ...data_power_default,
   ...entity_default2,
@@ -5793,15 +6535,17 @@ var commands62 = [
   ...timezone_default,
   ...user_id_items_default
 ];
-var project_default = commands62;
+var project_default = commands64;
 
 // src/commands/te-analysis/tracking/shared.ts
 function createTrackingCapabilityCommand(config) {
-  return createCapabilityCommand({
-    ...config,
+  const { asyncArtifact, ...coreConfig } = config;
+  const command = createCapabilityCommand({
+    ...coreConfig,
     cliService: "tracking",
     gatewayDomain: "analysis"
   });
+  return asyncArtifact ? withAsyncArtifactLifecycle(command) : command;
 }
 var eventsFlag = {
   name: "events",
@@ -6044,6 +6788,7 @@ var trackingPlanExport = createTrackingCapabilityCommand({
   resource: "plan",
   command: "export",
   capabilityId: "tracking.plan.export",
+  asyncArtifact: true,
   description: "Export the tracking plan as an artifact.",
   flags: [projectIdFlag, requestIdFlag, asyncTimeoutSecondsFlag],
   risk: "read",
@@ -6321,6 +7066,7 @@ var LIST_CAPABILITIES = {
 };
 var EDIT_CAPABILITY = "metadata.super_metadata.batch_edit";
 var MAX_BATCH_SIZE = 200;
+var DIRECTORY_PAGE_SIZE = 200;
 var trackingPlanSyncDisplayNames = {
   service: "tracking",
   resource: "plan",
@@ -6376,40 +7122,40 @@ var trackingPlanSyncDisplayNames = {
     const draftPath = ctx.str("draft");
     const draft = await readDraft(draftPath);
     const [eventResult, eventPropertyResult, userPropertyResult] = await Promise.all([
-      executeCapability(
+      fetchAllDirectoryItems(
         ctx.host(),
-        GATEWAY_DOMAIN,
         LIST_CAPABILITIES.events,
         {
           project_id: projectId,
           fields: ["event_name", "event_desc"]
-        }
+        },
+        "events"
       ),
-      executeCapability(
+      fetchAllDirectoryItems(
         ctx.host(),
-        GATEWAY_DOMAIN,
         LIST_CAPABILITIES.eventProperties,
         {
           project_id: projectId,
           table_type: "event",
           fields: ["prop_name", "prop_desc"]
-        }
+        },
+        "properties"
       ),
-      executeCapability(
+      fetchAllDirectoryItems(
         ctx.host(),
-        GATEWAY_DOMAIN,
         LIST_CAPABILITIES.userProperties,
         {
           project_id: projectId,
           table_type: "user",
           fields: ["prop_name", "prop_desc"]
-        }
+        },
+        "properties"
       )
     ]);
     const plan = buildDisplayNameSyncPlan(draft, {
-      events: eventResult?.events,
-      eventProperties: eventPropertyResult?.properties,
-      userProperties: userPropertyResult?.properties
+      events: eventResult,
+      eventProperties: eventPropertyResult,
+      userProperties: userPropertyResult
     });
     const updateResults = {};
     for (const group of Object.values(plan)) {
@@ -6447,6 +7193,35 @@ var trackingPlanSyncDisplayNames = {
     };
   }
 };
+async function fetchAllDirectoryItems(host, capabilityId, input, arrayField) {
+  const items = [];
+  let offset = 0;
+  const visitedOffsets = /* @__PURE__ */ new Set();
+  while (true) {
+    if (visitedOffsets.has(offset)) {
+      throw new Error(`${capabilityId} returned a repeated next_offset: ${offset}`);
+    }
+    visitedOffsets.add(offset);
+    const result = await executeCapability(host, GATEWAY_DOMAIN, capabilityId, {
+      ...input,
+      limit: DIRECTORY_PAGE_SIZE,
+      offset
+    });
+    const page = result?.[arrayField];
+    if (!Array.isArray(page)) {
+      throw new Error(`${capabilityId} response is missing ${arrayField}`);
+    }
+    items.push(...page);
+    if (result?.has_more !== true) {
+      return items;
+    }
+    const nextOffset = result?.next_offset;
+    if (!Number.isInteger(nextOffset) || nextOffset <= offset) {
+      throw new Error(`${capabilityId} returned an invalid next_offset: ${String(nextOffset)}`);
+    }
+    offset = nextOffset;
+  }
+}
 async function readDraft(filePath) {
   let value;
   try {
@@ -6491,7 +7266,7 @@ function counts(plan, value) {
 }
 
 // src/commands/te-analysis/tracking/plan/index.ts
-var commands63 = [
+var commands65 = [
   trackingPlanGet,
   trackingPlanSaveItems,
   trackingPlanDeleteItems,
@@ -6501,7 +7276,7 @@ var commands63 = [
   trackingPlanSyncFromMeta,
   trackingPlanSyncDisplayNames
 ];
-var plan_default = commands63;
+var plan_default = commands65;
 
 // src/commands/te-analysis/tracking/sdk-sample/generate.ts
 var trackingSdkSampleGenerate = createTrackingCapabilityCommand({
@@ -6515,10 +7290,10 @@ var trackingSdkSampleGenerate = createTrackingCapabilityCommand({
 });
 
 // src/commands/te-analysis/tracking/sdk-sample/index.ts
-var commands64 = [
+var commands66 = [
   trackingSdkSampleGenerate
 ];
-var sdk_sample_default = commands64;
+var sdk_sample_default = commands66;
 
 // src/commands/te-analysis/tracking/plan-change-log/list.ts
 var trackingPlanChangeLogList = createTrackingCapabilityCommand({
@@ -6536,6 +7311,7 @@ var trackingPlanChangeLogExport = createTrackingCapabilityCommand({
   resource: "plan-change-log",
   command: "export",
   capabilityId: "tracking.plan_change_log.export",
+  asyncArtifact: true,
   description: "Export one tracking plan change log.",
   flags: [projectIdFlag, logIdFlag, requestIdFlag, asyncTimeoutSecondsFlag],
   risk: "read",
@@ -6543,11 +7319,11 @@ var trackingPlanChangeLogExport = createTrackingCapabilityCommand({
 });
 
 // src/commands/te-analysis/tracking/plan-change-log/index.ts
-var commands65 = [
+var commands67 = [
   trackingPlanChangeLogList,
   trackingPlanChangeLogExport
 ];
-var plan_change_log_default = commands65;
+var plan_change_log_default = commands67;
 
 // src/commands/te-analysis/tracking/check/run.ts
 var trackingCheckRun = createTrackingCapabilityCommand({
@@ -6613,6 +7389,7 @@ var trackingCheckExport = createTrackingCapabilityCommand({
   resource: "check",
   command: "export",
   capabilityId: "tracking.check.export",
+  asyncArtifact: true,
   description: "Export one tracking validation result.",
   flags: [projectIdFlag, uuidFlag, requestIdFlag, asyncTimeoutSecondsFlag],
   risk: "read",
@@ -6620,7 +7397,7 @@ var trackingCheckExport = createTrackingCapabilityCommand({
 });
 
 // src/commands/te-analysis/tracking/check/index.ts
-var commands66 = [
+var commands68 = [
   trackingCheckRun,
   trackingCheckList,
   trackingCheckGet,
@@ -6628,7 +7405,7 @@ var commands66 = [
   trackingCheckDelete,
   trackingCheckExport
 ];
-var check_default = commands66;
+var check_default = commands68;
 
 // src/commands/te-analysis/tracking/ingest/summary.ts
 var trackingIngestSummary = createTrackingCapabilityCommand({
@@ -6642,10 +7419,10 @@ var trackingIngestSummary = createTrackingCapabilityCommand({
 });
 
 // src/commands/te-analysis/tracking/ingest/index.ts
-var commands67 = [
+var commands69 = [
   trackingIngestSummary
 ];
-var ingest_default = commands67;
+var ingest_default = commands69;
 
 // src/commands/te-analysis/tracking/ingest-error/list.ts
 var trackingIngestErrorList = createTrackingCapabilityCommand({
@@ -6659,10 +7436,10 @@ var trackingIngestErrorList = createTrackingCapabilityCommand({
 });
 
 // src/commands/te-analysis/tracking/ingest-error/index.ts
-var commands68 = [
+var commands70 = [
   trackingIngestErrorList
 ];
-var ingest_error_default = commands68;
+var ingest_error_default = commands70;
 
 // src/commands/te-analysis/tracking/live-data/list.ts
 var trackingLiveDataList = createTrackingCapabilityCommand({
@@ -6680,6 +7457,7 @@ var trackingLiveDataExport = createTrackingCapabilityCommand({
   resource: "live-data",
   command: "export",
   capabilityId: "tracking.live_data.export",
+  asyncArtifact: true,
   description: "Export recent tracking live data.",
   flags: [projectIdFlag, dataTypeFlag, requestIdFlag, asyncTimeoutSecondsFlag],
   risk: "read",
@@ -6687,11 +7465,11 @@ var trackingLiveDataExport = createTrackingCapabilityCommand({
 });
 
 // src/commands/te-analysis/tracking/live-data/index.ts
-var commands69 = [
+var commands71 = [
   trackingLiveDataList,
   trackingLiveDataExport
 ];
-var live_data_default = commands69;
+var live_data_default = commands71;
 
 // src/commands/te-analysis/tracking/event-blacklist/list.ts
 var trackingEventBlacklistList = createTrackingCapabilityCommand({
@@ -6727,12 +7505,12 @@ var trackingEventBlacklistUpdate = createTrackingCapabilityCommand({
 });
 
 // src/commands/te-analysis/tracking/event-blacklist/index.ts
-var commands70 = [
+var commands72 = [
   trackingEventBlacklistList,
   trackingEventBlacklistAdd,
   trackingEventBlacklistUpdate
 ];
-var event_blacklist_default = commands70;
+var event_blacklist_default = commands72;
 
 // src/commands/te-analysis/tracking/debug-device/add.ts
 var trackingDebugDeviceAdd = createTrackingCapabilityCommand({
@@ -6775,12 +7553,12 @@ var trackingDebugDeviceSelect = createTrackingCapabilityCommand({
 });
 
 // src/commands/te-analysis/tracking/debug-device/index.ts
-var commands71 = [
+var commands73 = [
   trackingDebugDeviceList,
   trackingDebugDeviceAdd,
   trackingDebugDeviceSelect
 ];
-var debug_device_default = commands71;
+var debug_device_default = commands73;
 
 // src/commands/te-analysis/tracking/debug-data/list.ts
 var debugStartTimeFlag = {
@@ -6839,11 +7617,11 @@ function isRecord2(value) {
 }
 
 // src/commands/te-analysis/tracking/debug-data/index.ts
-var commands72 = [trackingDebugDataList];
-var debug_data_default = commands72;
+var commands74 = [trackingDebugDataList];
+var debug_data_default = commands74;
 
 // src/commands/te-analysis/tracking/index.ts
-var commands73 = [
+var commands75 = [
   ...plan_default,
   ...sdk_sample_default,
   ...plan_change_log_default,
@@ -6855,7 +7633,7 @@ var commands73 = [
   ...debug_device_default,
   ...debug_data_default
 ];
-var tracking_default = commands73;
+var tracking_default = commands75;
 
 // src/commands/te-analysis/alert/shared.ts
 var alertIdFlag = {
@@ -6870,14 +7648,6 @@ var definitionRequestFlag = {
   required: true,
   desc: "Structured alert definition request JSON object using snake_case field names."
 };
-var limitFlag2 = {
-  name: "limit",
-  type: "number",
-  required: false,
-  desc: "Page size. Default: 50, max: 200.",
-  min: 1,
-  max: 200
-};
 var startTimeFlag2 = {
   name: "start-time",
   type: "string",
@@ -6903,9 +7673,10 @@ var analysisAlertList = createAnalysisCapabilityCommand({
   command: "list",
   capabilityId: "analysis.alert.list",
   description: "List project alerts.",
-  flags: [projectIdFlag, queryFlag, limitFlag2, offsetFlag],
+  flags: [projectIdFlag, queriesFlag, directoryLimitFlag, directoryOffsetFlag],
   risk: "read",
-  buildInput: (ctx) => compactInput({ ...projectInput3(ctx), query: optionalString(ctx, "query"), limit: optionalNumber(ctx, "limit"), offset: optionalNumber(ctx, "offset") })
+  validate: validateQueriesFlag,
+  buildInput: (ctx) => compactInput({ ...projectInput3(ctx), queries: optionalQueries(ctx), limit: optionalNumber(ctx, "limit"), offset: optionalNumber(ctx, "offset") })
 });
 
 // src/commands/te-analysis/alert/get.ts
@@ -6975,7 +7746,7 @@ var analysisAlertStop = createAnalysisCapabilityCommand({
 });
 
 // src/commands/te-analysis/alert/index.ts
-var commands74 = [
+var commands76 = [
   analysisAlertList,
   analysisAlertGet,
   analysisAlertCreate,
@@ -6984,7 +7755,7 @@ var commands74 = [
   analysisAlertStart,
   analysisAlertStop
 ];
-var alert_default = commands74;
+var alert_default = commands76;
 
 // src/commands/te-analysis/alert-detail/list.ts
 var analysisAlertDetailList = createAnalysisCapabilityCommand({
@@ -6998,10 +7769,10 @@ var analysisAlertDetailList = createAnalysisCapabilityCommand({
 });
 
 // src/commands/te-analysis/alert-detail/index.ts
-var commands75 = [
+var commands77 = [
   analysisAlertDetailList
 ];
-var alert_detail_default = commands75;
+var alert_detail_default = commands77;
 
 // src/commands/te-analysis/alert-job/list.ts
 var analysisAlertJobList = createAnalysisCapabilityCommand({
@@ -7015,10 +7786,10 @@ var analysisAlertJobList = createAnalysisCapabilityCommand({
 });
 
 // src/commands/te-analysis/alert-job/index.ts
-var commands76 = [
+var commands78 = [
   analysisAlertJobList
 ];
-var alert_job_default = commands76;
+var alert_job_default = commands78;
 
 // src/commands/te-analysis/alert-notice-config/list.ts
 var analysisAlertNoticeConfigList = createAnalysisCapabilityCommand({
@@ -7032,10 +7803,10 @@ var analysisAlertNoticeConfigList = createAnalysisCapabilityCommand({
 });
 
 // src/commands/te-analysis/alert-notice-config/index.ts
-var commands77 = [
+var commands79 = [
   analysisAlertNoticeConfigList
 ];
-var alert_notice_config_default = commands77;
+var alert_notice_config_default = commands79;
 
 // src/commands/te-analysis/system/shared.ts
 import { readFileSync, statSync as statSync2 } from "fs";
@@ -7079,6 +7850,7 @@ function defineSystemCommand(spec) {
     resource: `system ${spec.resource}`,
     command: spec.command,
     capabilityId: spec.capabilityId,
+    asyncArtifact: spec.asyncArtifact,
     description: spec.description,
     flags: [
       ...fields.map(fieldFlag),
@@ -7790,6 +8562,7 @@ var systemMonitoringCommands = [
     resource: "query-task",
     command: "export",
     capabilityId: "system.query_task.export",
+    asyncArtifact: true,
     description: "Export query tasks; run query-task options first to discover filter codes.",
     risk: "read",
     fields: [
@@ -8061,6 +8834,7 @@ var systemUsageCommands = [
     resource: "usage-trend",
     command: "export",
     capabilityId: "system.usage_trend.export",
+    asyncArtifact: true,
     description: "Export a bounded usage trend as a cancellable run-scoped gzip JSONL artifact.",
     risk: "read",
     fields: [
@@ -8096,14 +8870,14 @@ var systemUsageCommands = [
 ];
 
 // src/commands/te-analysis/system/index.ts
-var commands78 = [
+var commands80 = [
   ...systemUsageCommands,
   ...systemIdentityCommands,
   ...systemSecurityCommands,
   ...systemMonitoringCommands,
   ...systemConfigurationCommands
 ];
-var system_default = commands78;
+var system_default = commands80;
 
 // src/commands/te-analysis/index.ts
 registerCapabilityGatewayRoute("analysis", { gatewayDomain: "analysis" });
@@ -8122,6 +8896,7 @@ var baseCommands = [
   ...dashboard_report_default,
   ...dashboard_report_data_default,
   ...query_default,
+  ...query_context_default,
   ...run_default,
   ...artifact_default,
   ...adhoc_default,
@@ -8152,8 +8927,8 @@ var baseCommands = [
   ...alert_notice_config_default,
   ...system_default
 ];
-var commands79 = [...baseCommands];
-var te_analysis_default = commands79;
+var commands81 = [...baseCommands];
+var te_analysis_default = commands81;
 export {
   baseCommands,
   te_analysis_default as default