@thinkingai/ae-cli 6.1.28 → 6.1.30

package/dist/{te-community-QN3WMPNT.js → te-community-R7B6QYOO.js}

@@ -1,24 +1,40 @@
 import { createRequire as __createRequire } from 'node:module'; const require = __createRequire(import.meta.url);
 import {
-  registerCapabilityGatewayRoute
+  createCapabilityCommand
+} from "./chunk-Y3AM6LIO.js";
+import {
+  registerCapabilityGatewayRoute,
+  resolveGatewayDomain
 } from "./chunk-KPQY44JQ.js";
+import {
+  unwrapOutputData,
+  withOutputMetadata
+} from "./chunk-YULUBP3R.js";
+import {
+  CapabilityGatewayError,
+  buildCapabilityGatewayUrl,
+  requestCapabilityGatewayWithEnvelope
+} from "./chunk-HRUOV6EQ.js";
 import {
   internalCallSourceHeaders
 } from "./chunk-Y74WTIKJ.js";
+import "./chunk-CG773QXN.js";
 import {
   SecureStoreAuthError,
   getCliToken
-} from "./chunk-P7KL7IOH.js";
+} from "./chunk-SOSFRU3O.js";
 import {
   getActiveHost,
-  safeJsonParse
-} from "./chunk-LMCYSVVA.js";
+  parseJsonRequest,
+  safeJsonParse,
+  stringifyJsonRequest
+} from "./chunk-4PSTYEG5.js";
 import {
   CliValidationError,
   PermissionError,
   externalCliTokenRequestOptions,
   logger
-} from "./chunk-ZW4VMY5H.js";
+} from "./chunk-Z3Q2AEIN.js";
 
 // src/core/mcp.ts
 async function permissionDetails(resp) {
@@ -96,7 +112,7 @@ async function mcpRequest(url, method, params = {}, hostOverride) {
   const resp = await fetch(url, {
     method: "POST",
     headers,
-    body: JSON.stringify(body),
+    body: stringifyJsonRequest(body),
     ...externalCliTokenRequestOptions(url)
   });
   if (!resp.ok) {
@@ -202,13 +218,13 @@ var getChannelInfo = {
   command: "+get_channel_info",
   description: "Valid channel list for a community space (channel id and name).",
   flags: [
-    { name: "space-id", type: "number", required: true, desc: "Identifier of the community space. SpaceId" },
-    { name: "game-id", type: "number", required: true, desc: "Identifier of the community space. SpaceId" }
+    { name: "space-id", type: "int64", required: true, min: 1, desc: "Community space ID. Discover it with: ae-cli community spaces list" },
+    { name: "game-id", type: "int64", required: false, min: 1, desc: "Deprecated compatibility alias; defaults to --space-id and must match it." }
   ],
   risk: "read",
   execute: async (ctx) => {
-    const spaceId = ctx.num("space-id");
-    const gameId = ctx.num("game-id");
+    const spaceId = ctx.int64("space-id");
+    const gameId = ctx.optionalInt64("game-id") ?? spaceId;
     const host = ctx.host();
     const param = { gameId };
     const args = { spaceId, param };
@@ -218,14 +234,219 @@ var getChannelInfo = {
   }
 };
 
+// src/commands/te-community/support.ts
+var INTEGER_ENUMS = {
+  "+get_comment_tag_analysis:resource-type": [0, 1],
+  "+get_post_detail:resource-type": [0, 1],
+  "+get_post_detail:danmu-order-by": [0, 1],
+  "+get_post_detail:reply-order-by": [0, 1],
+  "+get_livestream_detail:order-by": [0, 1],
+  "+get_hot_topics:order-by": [0, 1],
+  "+get_risk_content:order-by": [0],
+  "+search_posts:search-mode": [0, 1, 2],
+  "+search_posts:order-by": [0, 1, 2, 3, 4]
+};
+var INTEGER_LIST_ENUMS = {
+  "+get_livestream_detail:activity-types": [0, 1, 2, 3],
+  "+search_posts:resource-type": [0, 1],
+  "+search_posts:sentiment-types": [0, 1, 2]
+};
+function validateCommunityCommand(ctx, command) {
+  const gameId = ctx.optionalInt64("game-id");
+  const spaceId = command.flags.some((flag) => flag.name === "space-id") ? ctx.int64("space-id") : void 0;
+  if (spaceId !== void 0 && gameId !== void 0 && gameId !== spaceId) {
+    throw validationError(
+      "--game-id must match --space-id",
+      "Omit --game-id; it is a deprecated compatibility alias and defaults to --space-id."
+    );
+  }
+  validateTemporalFlag(ctx, command, "date", "date");
+  validateTemporalFlag(ctx, command, "start-time", "date-time");
+  validateTemporalFlag(ctx, command, "end-time", "date-time");
+  validateTemporalFlag(ctx, command, "anchor-time", "minute");
+  validateTemporalFlag(ctx, command, "year", "year");
+  validateRange(ctx, command);
+  validateInt64Csv(ctx, command, "channel-id-list");
+  validateInt64Csv(ctx, command, "risk-codes");
+  if (command.flags.some((flag) => flag.name === "tag-filters") && ctx.str("tag-filters").trim()) {
+    validateTagFilters(ctx.json("tag-filters"));
+  }
+  for (const [key, choices] of Object.entries(INTEGER_ENUMS)) {
+    const [commandName, flagName] = key.split(":");
+    if (command.command === commandName) validateIntegerEnum(ctx, command, flagName, choices);
+  }
+  for (const [key, choices] of Object.entries(INTEGER_LIST_ENUMS)) {
+    const [commandName, flagName] = key.split(":");
+    if (command.command === commandName) validateIntegerCsv(ctx, command, flagName, choices);
+  }
+}
+function stringCsv(ctx, name) {
+  const raw = ctx.str(name).trim();
+  if (!raw) return void 0;
+  const values = raw.split(",").map((value) => value.trim()).filter(Boolean);
+  return values.length > 0 ? values : void 0;
+}
+function tagFilters(ctx) {
+  const raw = ctx.str("tag-filters").trim();
+  if (!raw) return void 0;
+  const value = ctx.json("tag-filters");
+  validateTagFilters(value);
+  return value;
+}
+function validateTemporalFlag(ctx, command, name, format) {
+  if (!command.flags.some((flag) => flag.name === name)) return;
+  const value = ctx.str(name).trim();
+  if (!value) return;
+  if (format === "year") {
+    if (!/^\d{4}$/.test(value)) {
+      throw validationError(`--${name} must use yyyy format`);
+    }
+    return;
+  }
+  if (format === "minute") {
+    if (!parseDateTime(value, true)) {
+      throw validationError(`--${name} must use yyyy-MM-dd HH:mm format`);
+    }
+    return;
+  }
+  if (format === "date") {
+    if (!parseDate(value)) {
+      throw validationError(`--${name} must be a valid date in yyyy-MM-dd format`);
+    }
+    return;
+  }
+  if (!parseDate(value) && !parseDateTime(value, false)) {
+    throw validationError(
+      `--${name} must be a valid date or timestamp`,
+      "Use yyyy-MM-dd, yyyy-MM-dd HH:mm, or yyyy-MM-dd HH:mm:ss."
+    );
+  }
+}
+function validateRange(ctx, command) {
+  if (!command.flags.some((flag) => flag.name === "start-time") || !command.flags.some((flag) => flag.name === "end-time")) return;
+  const start = temporalValue(ctx.str("start-time"));
+  const end = temporalValue(ctx.str("end-time"));
+  if (start !== void 0 && end !== void 0 && end < start) {
+    throw validationError("--end-time must not be earlier than --start-time");
+  }
+}
+function validateInt64Csv(ctx, command, name) {
+  if (!command.flags.some((flag) => flag.name === name)) return;
+  const raw = ctx.str(name).trim();
+  if (!raw) return;
+  const values = raw.split(",");
+  const max = (1n << 63n) - 1n;
+  for (const value of values) {
+    const item = value.trim();
+    if (!/^[1-9]\d*$/.test(item) || BigInt(item) > max) {
+      throw validationError(`--${name} must be a comma-separated list of positive int64 values`);
+    }
+  }
+}
+function validateIntegerEnum(ctx, command, name, choices) {
+  if (!command.flags.some((flag) => flag.name === name)) return;
+  const raw = ctx.str(name).trim();
+  if (!raw) return;
+  const value = Number(raw);
+  if (!Number.isInteger(value) || !choices.includes(value)) {
+    throw validationError(`--${name} must be one of: ${choices.join(", ")}`);
+  }
+}
+function validateIntegerCsv(ctx, command, name, choices) {
+  if (!command.flags.some((flag) => flag.name === name)) return;
+  const raw = ctx.str(name).trim();
+  if (!raw) return;
+  const values = raw.split(",").map((value) => Number(value.trim()));
+  if (values.some((value) => !Number.isInteger(value) || !choices.includes(value))) {
+    throw validationError(
+      `--${name} must be a comma-separated list containing only: ${choices.join(", ")}`
+    );
+  }
+}
+function validateTagFilters(value) {
+  if (!Array.isArray(value)) {
+    throw validationError("--tag-filters must be a JSON array");
+  }
+  const required = ["tagName", "tagCode", "inferenceType", "calcuSymbol"];
+  value.forEach((item, index) => {
+    if (item === null || typeof item !== "object" || Array.isArray(item)) {
+      throw validationError(`--tag-filters item ${index + 1} must be an object`);
+    }
+    const record2 = item;
+    for (const field2 of required) {
+      if (typeof record2[field2] !== "string" || !record2[field2].trim()) {
+        throw validationError(`--tag-filters item ${index + 1} requires non-empty ${field2}`);
+      }
+    }
+    const inferenceType = String(record2.inferenceType);
+    const calcuSymbol = String(record2.calcuSymbol);
+    if (inferenceType !== "label" && inferenceType !== "score") {
+      throw validationError(
+        `--tag-filters item ${index + 1} inferenceType must be label or score`,
+        "Use inferenceType from +get_corpus_tags; extract tags are not filterable by search_posts."
+      );
+    }
+    const allowedSymbols = inferenceType === "label" ? ["C04", "C05"] : ["C00", "C01", "C02", "C020", "C03", "C030", "C04", "C05", "C06"];
+    if (!allowedSymbols.includes(calcuSymbol)) {
+      throw validationError(
+        `--tag-filters item ${index + 1} calcuSymbol must be one of: ${allowedSymbols.join(", ")}`
+      );
+    }
+    if (inferenceType === "score" && !["C04", "C05"].includes(calcuSymbol)) {
+      if (!Array.isArray(record2.ftv)) {
+        throw validationError(
+          `--tag-filters item ${index + 1} ftv must be an array for score comparison ${calcuSymbol}`
+        );
+      }
+      const requiredValues = calcuSymbol === "C06" ? 2 : 1;
+      if (record2.ftv.length < requiredValues) {
+        throw validationError(
+          `--tag-filters item ${index + 1} ftv requires at least ${requiredValues} value${requiredValues === 1 ? "" : "s"}`
+        );
+      }
+    }
+  });
+}
+function parseDate(value) {
+  const match = /^(\d{4})-(\d{2})-(\d{2})$/.exec(value);
+  if (!match) return void 0;
+  return validatedUtc(Number(match[1]), Number(match[2]), Number(match[3]), 0, 0, 0);
+}
+function parseDateTime(value, minuteOnly) {
+  const pattern = minuteOnly ? /^(\d{4})-(\d{2})-(\d{2}) (\d{2}):(\d{2})$/ : /^(\d{4})-(\d{2})-(\d{2}) (\d{2}):(\d{2})(?::(\d{2}))?$/;
+  const match = pattern.exec(value);
+  if (!match) return void 0;
+  return validatedUtc(
+    Number(match[1]),
+    Number(match[2]),
+    Number(match[3]),
+    Number(match[4]),
+    Number(match[5]),
+    Number(match[6] ?? 0)
+  );
+}
+function validatedUtc(year, month, day, hour, minute, second) {
+  const value = new Date(Date.UTC(year, month - 1, day, hour, minute, second));
+  if (value.getUTCFullYear() !== year || value.getUTCMonth() !== month - 1 || value.getUTCDate() !== day || value.getUTCHours() !== hour || value.getUTCMinutes() !== minute || value.getUTCSeconds() !== second) return void 0;
+  return value.getTime();
+}
+function temporalValue(value) {
+  const trimmed = value.trim();
+  if (!trimmed) return void 0;
+  return parseDate(trimmed) ?? parseDateTime(trimmed, false);
+}
+function validationError(message, hint) {
+  return new CliValidationError(message, hint ? { hint } : void 0);
+}
+
 // src/commands/te-community/search_posts.ts
 var searchPosts = {
   service: "community",
   command: "+search_posts",
   description: "Search social posts/videos/feeds in a community space.",
   flags: [
-    { name: "space-id", type: "number", required: true, desc: "Identifier of the community space. SpaceId" },
-    { name: "game-id", type: "number", required: true, desc: "Identifier of the community space. SpaceId" },
+    { name: "space-id", type: "int64", required: true, min: 1, desc: "Community space ID. Discover it with: ae-cli community spaces list" },
+    { name: "game-id", type: "int64", required: false, min: 1, desc: "Deprecated compatibility alias; defaults to --space-id and must match it." },
     { name: "channel-id-list", type: "string", required: false, desc: "Channel IDs from +get_channel_info (channelId). Comma-separated." },
     { name: "keywords", type: "string", required: false, desc: "Keyword filter list. Comma-separated." },
     { name: "start-time", type: "string", required: true, desc: "Content publish time lower bound. Format: yyyy-MM-dd." },
@@ -235,40 +456,46 @@ var searchPosts = {
     { name: "search-mode", type: "number", required: false, desc: 'Search mode: 0 tokenized (default), 1 exact substring (e.g. \\"#tag\\" matches only posts containing that full string), 2 author name.' },
     { name: "search-word", type: "string", required: false, desc: "Full-text query; used together with searchMode." },
     { name: "sentiment-types", type: "string", required: false, desc: "Sentiment filter: 0 negative, 1 positive, 2 neutral. Comma-separated." },
+    { name: "topic-id-list", type: "string", required: false, desc: "Topic IDs from +get_hot_topics (topicId). Comma-separated." },
+    { name: "tag-filters", type: "json", required: false, desc: "Corpus tag filter JSON array using tagName, tagCode, inferenceType, calcuSymbol, and optional ftv." },
     { name: "order-by", type: "number", required: false, desc: "Sort: 0 publish time desc, 1 weight desc, 2 publish time asc, 3 reply count desc, 4 heat desc." },
     { name: "page-num", type: "number", required: false, desc: "Page number, starting at 1." },
     { name: "page-size", type: "number", required: false, desc: "Page size. Max 10000." }
   ],
   risk: "read",
   execute: async (ctx) => {
-    const spaceId = ctx.num("space-id");
-    const gameId = ctx.num("game-id");
+    const spaceId = ctx.int64("space-id");
+    const gameId = ctx.optionalInt64("game-id") ?? spaceId;
     const startTime = ctx.str("start-time");
     const endTime = ctx.str("end-time");
     const host = ctx.host();
     const param = { gameId, startTime, endTime };
     const channelIdList = ctx.str("channel-id-list");
-    if (channelIdList) param.channelIdList = channelIdList.split(",").map(Number);
+    if (channelIdList) param.channelIdList = channelIdList.split(",").map((value) => BigInt(value.trim()));
     const keywords = ctx.str("keywords");
     if (keywords) param.keywords = keywords.split(",");
-    const official = ctx.bool("official");
+    const official = ctx.optionalBool("official");
     if (official !== void 0) param.official = official;
     const resourceType = ctx.str("resource-type");
     if (resourceType) param.resourceType = resourceType.split(",").map(Number);
-    const searchMode = ctx.num("search-mode");
+    const searchMode = ctx.optionalNum("search-mode");
     if (searchMode !== void 0) param.searchMode = searchMode;
     const searchWord = ctx.str("search-word");
     if (searchWord) param.searchWord = searchWord;
     const sentimentTypes = ctx.str("sentiment-types");
     if (sentimentTypes) param.sentimentTypes = sentimentTypes.split(",").map(Number);
-    const orderBy = ctx.num("order-by");
-    const pageNum = ctx.num("page-num");
-    const pageSize = ctx.num("page-size");
-    if (orderBy !== void 0 || pageNum || pageSize) {
+    const topicIdList = stringCsv(ctx, "topic-id-list");
+    if (topicIdList) param.topicIdList = topicIdList;
+    const parsedTagFilters = tagFilters(ctx);
+    if (parsedTagFilters) param.tagFilters = parsedTagFilters;
+    const orderBy = ctx.optionalNum("order-by");
+    const pageNum = ctx.optionalNum("page-num");
+    const pageSize = ctx.optionalNum("page-size");
+    if (orderBy !== void 0 || pageNum !== void 0 || pageSize !== void 0) {
       param.pagerHeader = {};
       if (orderBy !== void 0) param.pagerHeader.orderBy = orderBy;
-      if (pageNum) param.pagerHeader.pageNum = pageNum;
-      if (pageSize) param.pagerHeader.pageSize = pageSize;
+      if (pageNum !== void 0) param.pagerHeader.pageNum = pageNum;
+      if (pageSize !== void 0) param.pagerHeader.pageSize = pageSize;
     }
     const args = { spaceId, param };
     const mcpUrl = resolveMcpUrl(ctx.mcpUrl(), host, "community_content");
@@ -283,9 +510,9 @@ var getPostDetail = {
   command: "+get_post_detail",
   description: "Full detail for one post/video: body, media, subtitles, danmu, sentiment, keywords, topics, tag values, and comment pager.",
   flags: [
-    { name: "space-id", type: "number", required: true, desc: "Identifier of the community space. SpaceId" },
-    { name: "game-id", type: "number", required: true, desc: "Identifier of the community space. SpaceId" },
-    { name: "channel-id", type: "number", required: true, desc: "Channel ID." },
+    { name: "space-id", type: "int64", required: true, min: 1, desc: "Community space ID. Discover it with: ae-cli community spaces list" },
+    { name: "game-id", type: "int64", required: false, min: 1, desc: "Deprecated compatibility alias; defaults to --space-id and must match it." },
+    { name: "channel-id", type: "int64", required: true, min: 1, desc: "Channel ID." },
     { name: "uuid", type: "string", required: true, desc: "Content UUID (unique id)." },
     { name: "resource-type", type: "number", required: true, desc: "Resource type: 0 post, 1 video." },
     { name: "danmu-order-by", type: "number", required: false, desc: "Sort for danmu: 0 video timestamp desc, 1 publish time desc." },
@@ -297,30 +524,30 @@ var getPostDetail = {
   ],
   risk: "read",
   execute: async (ctx) => {
-    const spaceId = ctx.num("space-id");
-    const gameId = ctx.num("game-id");
-    const channelId = ctx.num("channel-id");
+    const spaceId = ctx.int64("space-id");
+    const gameId = ctx.optionalInt64("game-id") ?? spaceId;
+    const channelId = ctx.int64("channel-id");
     const uuid = ctx.str("uuid");
     const resourceType = ctx.num("resource-type");
     const host = ctx.host();
     const param = { gameId, channelId, uuid, resourceType };
-    const danmuOrderBy = ctx.num("danmu-order-by");
-    const danmuPageNum = ctx.num("danmu-page-num");
-    const danmuPageSize = ctx.num("danmu-page-size");
-    if (danmuOrderBy !== void 0 || danmuPageNum || danmuPageSize) {
+    const danmuOrderBy = ctx.optionalNum("danmu-order-by");
+    const danmuPageNum = ctx.optionalNum("danmu-page-num");
+    const danmuPageSize = ctx.optionalNum("danmu-page-size");
+    if (danmuOrderBy !== void 0 || danmuPageNum !== void 0 || danmuPageSize !== void 0) {
       param.danmuPagerHeader = {};
       if (danmuOrderBy !== void 0) param.danmuPagerHeader.orderBy = danmuOrderBy;
-      if (danmuPageNum) param.danmuPagerHeader.pageNum = danmuPageNum;
-      if (danmuPageSize) param.danmuPagerHeader.pageSize = danmuPageSize;
+      if (danmuPageNum !== void 0) param.danmuPagerHeader.pageNum = danmuPageNum;
+      if (danmuPageSize !== void 0) param.danmuPagerHeader.pageSize = danmuPageSize;
     }
-    const replyOrderBy = ctx.num("reply-order-by");
-    const replyPageNum = ctx.num("reply-page-num");
-    const replyPageSize = ctx.num("reply-page-size");
-    if (replyOrderBy !== void 0 || replyPageNum || replyPageSize) {
+    const replyOrderBy = ctx.optionalNum("reply-order-by");
+    const replyPageNum = ctx.optionalNum("reply-page-num");
+    const replyPageSize = ctx.optionalNum("reply-page-size");
+    if (replyOrderBy !== void 0 || replyPageNum !== void 0 || replyPageSize !== void 0) {
       param.replyPagerHeader = {};
       if (replyOrderBy !== void 0) param.replyPagerHeader.orderBy = replyOrderBy;
-      if (replyPageNum) param.replyPagerHeader.pageNum = replyPageNum;
-      if (replyPageSize) param.replyPagerHeader.pageSize = replyPageSize;
+      if (replyPageNum !== void 0) param.replyPagerHeader.pageNum = replyPageNum;
+      if (replyPageSize !== void 0) param.replyPagerHeader.pageSize = replyPageSize;
     }
     const args = { spaceId, param };
     const mcpUrl = resolveMcpUrl(ctx.mcpUrl(), host, "community_content");
@@ -335,22 +562,22 @@ var getOverviewMetrics = {
   command: "+get_overview_metrics",
   description: "Overall community metrics in a date range: post/reply counts, sentiment counts, per-channel breakdown.",
   flags: [
-    { name: "space-id", type: "number", required: true, desc: "Identifier of the community space. SpaceId" },
-    { name: "game-id", type: "number", required: true, desc: "Identifier of the community space. SpaceId" },
+    { name: "space-id", type: "int64", required: true, min: 1, desc: "Community space ID. Discover it with: ae-cli community spaces list" },
+    { name: "game-id", type: "int64", required: false, min: 1, desc: "Deprecated compatibility alias; defaults to --space-id and must match it." },
     { name: "channel-id-list", type: "string", required: false, desc: "Channel IDs from +get_channel_info (channelId)." },
     { name: "start-time", type: "string", required: true, desc: "Statistics range start (inclusive). Format: yyyy-MM-dd." },
     { name: "end-time", type: "string", required: true, desc: "Statistics range end (inclusive). Format: yyyy-MM-dd." }
   ],
   risk: "read",
   execute: async (ctx) => {
-    const spaceId = ctx.num("space-id");
-    const gameId = ctx.num("game-id");
+    const spaceId = ctx.int64("space-id");
+    const gameId = ctx.optionalInt64("game-id") ?? spaceId;
     const startTime = ctx.str("start-time");
     const endTime = ctx.str("end-time");
     const host = ctx.host();
     const param = { gameId, startTime, endTime };
     const channelIdList = ctx.str("channel-id-list");
-    if (channelIdList) param.channelIdList = channelIdList.split(",").map(Number);
+    if (channelIdList) param.channelIdList = channelIdList.split(",").map((value) => BigInt(value.trim()));
     const args = { spaceId, param };
     const mcpUrl = resolveMcpUrl(ctx.mcpUrl(), host, "community_analysis");
     const result = await callMcpTool(mcpUrl, "get_overview_metrics", args, host);
@@ -364,8 +591,8 @@ var getSentimentOverview = {
   command: "+get_sentiment_overview",
   description: "Sentiment distribution and hot-keyword overview: top keywords per sentiment with trends, plus overall keyword ranking.",
   flags: [
-    { name: "space-id", type: "number", required: true, desc: "Identifier of the community space. SpaceId" },
-    { name: "game-id", type: "number", required: true, desc: "Identifier of the community space. SpaceId" },
+    { name: "space-id", type: "int64", required: true, min: 1, desc: "Community space ID. Discover it with: ae-cli community spaces list" },
+    { name: "game-id", type: "int64", required: false, min: 1, desc: "Deprecated compatibility alias; defaults to --space-id and must match it." },
     { name: "channel-id-list", type: "string", required: false, desc: "Channel IDs from +get_channel_info (channelId)." },
     { name: "start-time", type: "string", required: true, desc: "Statistics range start (inclusive). Format: yyyy-MM-dd." },
     { name: "end-time", type: "string", required: true, desc: "Statistics range end (inclusive). Format: yyyy-MM-dd." },
@@ -374,18 +601,18 @@ var getSentimentOverview = {
   ],
   risk: "read",
   execute: async (ctx) => {
-    const spaceId = ctx.num("space-id");
-    const gameId = ctx.num("game-id");
+    const spaceId = ctx.int64("space-id");
+    const gameId = ctx.optionalInt64("game-id") ?? spaceId;
     const startTime = ctx.str("start-time");
     const endTime = ctx.str("end-time");
     const host = ctx.host();
     const param = { gameId, startTime, endTime };
     const channelIdList = ctx.str("channel-id-list");
-    if (channelIdList) param.channelIdList = channelIdList.split(",").map(Number);
-    const isMerged = ctx.bool("is-merged");
+    if (channelIdList) param.channelIdList = channelIdList.split(",").map((value) => BigInt(value.trim()));
+    const isMerged = ctx.optionalBool("is-merged");
     if (isMerged !== void 0) param.isMerged = isMerged;
-    const limit = ctx.num("limit");
-    if (limit) param.limit = limit;
+    const limit = ctx.optionalNum("limit");
+    if (limit !== void 0) param.limit = limit;
     const args = { spaceId, param };
     const mcpUrl = resolveMcpUrl(ctx.mcpUrl(), host, "community_analysis");
     const result = await callMcpTool(mcpUrl, "get_sentiment_overview", args, host);
@@ -399,8 +626,8 @@ var getTagTrends = {
   command: "+get_tag_trends",
   description: "Daily tag trends: given tagCode and date range, returns counts and time series per tag value.",
   flags: [
-    { name: "space-id", type: "number", required: true, desc: "Identifier of the community space. SpaceId" },
-    { name: "game-id", type: "number", required: true, desc: "Identifier of the community space. SpaceId" },
+    { name: "space-id", type: "int64", required: true, min: 1, desc: "Community space ID. Discover it with: ae-cli community spaces list" },
+    { name: "game-id", type: "int64", required: false, min: 1, desc: "Deprecated compatibility alias; defaults to --space-id and must match it." },
     { name: "tag-code", type: "string", required: true, desc: "Tag code (tagCode) from +get_corpus_tags." },
     { name: "channel-id-list", type: "string", required: false, desc: "Channel IDs from +get_channel_info." },
     { name: "start-time", type: "string", required: false, desc: "Statistics range start (inclusive). Format: yyyy-MM-dd." },
@@ -408,13 +635,13 @@ var getTagTrends = {
   ],
   risk: "read",
   execute: async (ctx) => {
-    const spaceId = ctx.num("space-id");
-    const gameId = ctx.num("game-id");
+    const spaceId = ctx.int64("space-id");
+    const gameId = ctx.optionalInt64("game-id") ?? spaceId;
     const tagCode = ctx.str("tag-code");
     const host = ctx.host();
     const param = { gameId, tagCode };
     const channelIdList = ctx.str("channel-id-list");
-    if (channelIdList) param.channelIdList = channelIdList.split(",").map(Number);
+    if (channelIdList) param.channelIdList = channelIdList.split(",").map((value) => BigInt(value.trim()));
     const startTime = ctx.str("start-time");
     if (startTime) param.startTime = startTime;
     const endTime = ctx.str("end-time");
@@ -432,14 +659,14 @@ var getDailySummary = {
   command: "+get_daily_summary",
   description: "Daily community summary for a given date: hot topic rankings and highlighted opinions (positive/negative).",
   flags: [
-    { name: "space-id", type: "number", required: true, desc: "Identifier of the community space. SpaceId" },
-    { name: "game-id", type: "number", required: true, desc: "Identifier of the community space. SpaceId" },
+    { name: "space-id", type: "int64", required: true, min: 1, desc: "Community space ID. Discover it with: ae-cli community spaces list" },
+    { name: "game-id", type: "int64", required: false, min: 1, desc: "Deprecated compatibility alias; defaults to --space-id and must match it." },
     { name: "date", type: "string", required: true, desc: "Summary date. Format: yyyy-MM-dd." }
   ],
   risk: "read",
   execute: async (ctx) => {
-    const spaceId = ctx.num("space-id");
-    const gameId = ctx.num("game-id");
+    const spaceId = ctx.int64("space-id");
+    const gameId = ctx.optionalInt64("game-id") ?? spaceId;
     const date = ctx.str("date");
     const host = ctx.host();
     const param = { gameId, date };
@@ -456,23 +683,23 @@ var getHotTopics = {
   command: "+get_hot_topics",
   description: "Hot topics leaderboard over a time range.",
   flags: [
-    { name: "space-id", type: "number", required: true, desc: "Identifier of the community space. SpaceId" },
-    { name: "game-id", type: "number", required: true, desc: "Identifier of the community space. SpaceId" },
+    { name: "space-id", type: "int64", required: true, min: 1, desc: "Community space ID. Discover it with: ae-cli community spaces list" },
+    { name: "game-id", type: "int64", required: false, min: 1, desc: "Deprecated compatibility alias; defaults to --space-id and must match it." },
     { name: "start-time", type: "string", required: false, desc: "Topic statistics range start (inclusive). Format: yyyy-MM-dd." },
     { name: "end-time", type: "string", required: false, desc: "Topic statistics range end (inclusive). Format: yyyy-MM-dd." },
     { name: "order-by", type: "number", required: false, desc: "Sort: 0 by topic heat desc, 1 by topic start time desc." }
   ],
   risk: "read",
   execute: async (ctx) => {
-    const spaceId = ctx.num("space-id");
-    const gameId = ctx.num("game-id");
+    const spaceId = ctx.int64("space-id");
+    const gameId = ctx.optionalInt64("game-id") ?? spaceId;
     const host = ctx.host();
     const param = { gameId };
     const startTime = ctx.str("start-time");
     if (startTime) param.startTime = startTime;
     const endTime = ctx.str("end-time");
     if (endTime) param.endTime = endTime;
-    const orderBy = ctx.num("order-by");
+    const orderBy = ctx.optionalNum("order-by");
     if (orderBy !== void 0) param.orderBy = orderBy;
     const args = { spaceId, param };
     const mcpUrl = resolveMcpUrl(ctx.mcpUrl(), host, "community_hot");
@@ -487,16 +714,16 @@ var getTopicDetail = {
   command: "+get_topic_detail",
   description: "Deep stats for one topic in a range: content/reply totals, sentiment, per-channel daily trends, hot keywords.",
   flags: [
-    { name: "space-id", type: "number", required: true, desc: "Identifier of the community space. SpaceId" },
-    { name: "game-id", type: "number", required: true, desc: "Identifier of the community space. SpaceId" },
+    { name: "space-id", type: "int64", required: true, min: 1, desc: "Community space ID. Discover it with: ae-cli community spaces list" },
+    { name: "game-id", type: "int64", required: false, min: 1, desc: "Deprecated compatibility alias; defaults to --space-id and must match it." },
     { name: "topic-id", type: "string", required: true, desc: "Topic ID from +get_hot_topics (topicId)." },
     { name: "start-time", type: "string", required: true, desc: "Statistics start date. Format: yyyy-MM-dd. Prefer topic startTime from +get_hot_topics." },
     { name: "end-time", type: "string", required: true, desc: "Statistics end date. Format: yyyy-MM-dd. Prefer topic endTime from +get_hot_topics." }
   ],
   risk: "read",
   execute: async (ctx) => {
-    const spaceId = ctx.num("space-id");
-    const gameId = ctx.num("game-id");
+    const spaceId = ctx.int64("space-id");
+    const gameId = ctx.optionalInt64("game-id") ?? spaceId;
     const topicId = ctx.str("topic-id");
     const startTime = ctx.str("start-time");
     const endTime = ctx.str("end-time");
@@ -515,15 +742,15 @@ var getLivestreamOverview = {
   command: "+get_livestream_overview",
   description: "Livestream overview trends: active rooms, session count, interactions, and streamed duration.",
   flags: [
-    { name: "space-id", type: "number", required: true, desc: "Identifier of the community space. SpaceId" },
-    { name: "game-id", type: "number", required: true, desc: "Identifier of the community space. SpaceId" },
+    { name: "space-id", type: "int64", required: true, min: 1, desc: "Community space ID. Discover it with: ae-cli community spaces list" },
+    { name: "game-id", type: "int64", required: false, min: 1, desc: "Deprecated compatibility alias; defaults to --space-id and must match it." },
     { name: "start-time", type: "string", required: false, desc: "Statistics range start (inclusive). Format: yyyy-MM-dd." },
     { name: "end-time", type: "string", required: false, desc: "Statistics range end (inclusive). Format: yyyy-MM-dd." }
   ],
   risk: "read",
   execute: async (ctx) => {
-    const spaceId = ctx.num("space-id");
-    const gameId = ctx.num("game-id");
+    const spaceId = ctx.int64("space-id");
+    const gameId = ctx.optionalInt64("game-id") ?? spaceId;
     const host = ctx.host();
     const param = { gameId };
     const startTime = ctx.str("start-time");
@@ -543,20 +770,20 @@ var getLivestreamRooms = {
   command: "+get_livestream_rooms",
   description: "Search live rooms by time range and channels; returns room list with stats.",
   flags: [
-    { name: "space-id", type: "number", required: true, desc: "Identifier of the community space. SpaceId" },
-    { name: "game-id", type: "number", required: true, desc: "Identifier of the community space. SpaceId" },
+    { name: "space-id", type: "int64", required: true, min: 1, desc: "Community space ID. Discover it with: ae-cli community spaces list" },
+    { name: "game-id", type: "int64", required: false, min: 1, desc: "Deprecated compatibility alias; defaults to --space-id and must match it." },
     { name: "channel-id-list", type: "string", required: false, desc: "Channel ID list." },
     { name: "start-time", type: "string", required: false, desc: "Statistics range start (inclusive). Format: yyyy-MM-dd." },
     { name: "end-time", type: "string", required: false, desc: "Statistics range end (inclusive). Format: yyyy-MM-dd." }
   ],
   risk: "read",
   execute: async (ctx) => {
-    const spaceId = ctx.num("space-id");
-    const gameId = ctx.num("game-id");
+    const spaceId = ctx.int64("space-id");
+    const gameId = ctx.optionalInt64("game-id") ?? spaceId;
     const host = ctx.host();
     const param = { gameId };
     const channelIdList = ctx.str("channel-id-list");
-    if (channelIdList) param.channelIdList = channelIdList.split(",").map(Number);
+    if (channelIdList) param.channelIdList = channelIdList.split(",").map((value) => BigInt(value.trim()));
     const startTime = ctx.str("start-time");
     if (startTime) param.startTime = startTime;
     const endTime = ctx.str("end-time");
@@ -574,17 +801,17 @@ var getLivestreamRoomMetrics = {
   command: "+get_livestream_room_metrics",
   description: "Core metrics and yearly calendar for one room: overview KPIs plus daily streamed-duration calendar.",
   flags: [
-    { name: "space-id", type: "number", required: true, desc: "Identifier of the community space. SpaceId" },
-    { name: "game-id", type: "number", required: true, desc: "Identifier of the community space. SpaceId" },
-    { name: "channel-id", type: "number", required: true, desc: "Channel ID from +get_livestream_rooms." },
+    { name: "space-id", type: "int64", required: true, min: 1, desc: "Community space ID. Discover it with: ae-cli community spaces list" },
+    { name: "game-id", type: "int64", required: false, min: 1, desc: "Deprecated compatibility alias; defaults to --space-id and must match it." },
+    { name: "channel-id", type: "int64", required: true, min: 1, desc: "Channel ID from +get_livestream_rooms." },
     { name: "room-id", type: "string", required: true, desc: "Live room ID (roomId) from +get_livestream_rooms." },
     { name: "year", type: "string", required: false, desc: "Calendar year (yyyy)." }
   ],
   risk: "read",
   execute: async (ctx) => {
-    const spaceId = ctx.num("space-id");
-    const gameId = ctx.num("game-id");
-    const channelId = ctx.num("channel-id");
+    const spaceId = ctx.int64("space-id");
+    const gameId = ctx.optionalInt64("game-id") ?? spaceId;
+    const channelId = ctx.int64("channel-id");
     const roomId = ctx.str("room-id");
     const host = ctx.host();
     const param = { gameId, channelId, roomId };
@@ -603,20 +830,20 @@ var getLivestreamList = {
   command: "+get_livestream_list",
   description: "List live sessions for a room in a time range (stream records).",
   flags: [
-    { name: "space-id", type: "number", required: true, desc: "Identifier of the community space. SpaceId" },
-    { name: "game-id", type: "number", required: true, desc: "Identifier of the community space. SpaceId" },
-    { name: "channel-id", type: "number", required: false, desc: "Channel ID from +get_livestream_rooms." },
+    { name: "space-id", type: "int64", required: true, min: 1, desc: "Community space ID. Discover it with: ae-cli community spaces list" },
+    { name: "game-id", type: "int64", required: false, min: 1, desc: "Deprecated compatibility alias; defaults to --space-id and must match it." },
+    { name: "channel-id", type: "int64", required: false, min: 1, desc: "Channel ID from +get_livestream_rooms." },
     { name: "room-id", type: "string", required: false, desc: "Live room ID (roomId) from +get_livestream_rooms." },
     { name: "start-time", type: "string", required: false, desc: "Statistics range start (inclusive). Format: yyyy-MM-dd." },
     { name: "end-time", type: "string", required: false, desc: "Statistics range end (inclusive). Format: yyyy-MM-dd." }
   ],
   risk: "read",
   execute: async (ctx) => {
-    const spaceId = ctx.num("space-id");
-    const gameId = ctx.num("game-id");
+    const spaceId = ctx.int64("space-id");
+    const gameId = ctx.optionalInt64("game-id") ?? spaceId;
     const host = ctx.host();
     const param = { gameId };
-    const channelId = ctx.num("channel-id");
+    const channelId = ctx.int64("channel-id");
     if (channelId) param.channelId = channelId;
     const roomId = ctx.str("room-id");
     if (roomId) param.roomId = roomId;
@@ -637,8 +864,8 @@ var getLivestreamDetail = {
   command: "+get_livestream_detail",
   description: "One live session detail: interaction leaderboards and paginated interaction feed.",
   flags: [
-    { name: "space-id", type: "number", required: true, desc: "Identifier of the community space. SpaceId" },
-    { name: "game-id", type: "number", required: true, desc: "Identifier of the community space. SpaceId" },
+    { name: "space-id", type: "int64", required: true, min: 1, desc: "Community space ID. Discover it with: ae-cli community spaces list" },
+    { name: "game-id", type: "int64", required: false, min: 1, desc: "Deprecated compatibility alias; defaults to --space-id and must match it." },
     { name: "stream-id", type: "string", required: true, desc: "Live session ID (streamId) from +get_livestream_list." },
     { name: "activity-types", type: "string", required: false, desc: "Activity type codes to filter details: 0 danmu, 1 gift, 2 superchat, 3 premium. Comma-separated." },
     { name: "anchor-time", type: "string", required: false, desc: "Anchor time for interactions. Format: yyyy-MM-dd HH:mm." },
@@ -649,8 +876,8 @@ var getLivestreamDetail = {
   ],
   risk: "read",
   execute: async (ctx) => {
-    const spaceId = ctx.num("space-id");
-    const gameId = ctx.num("game-id");
+    const spaceId = ctx.int64("space-id");
+    const gameId = ctx.optionalInt64("game-id") ?? spaceId;
     const streamId = ctx.str("stream-id");
     const host = ctx.host();
     const param = { gameId, streamId };
@@ -660,14 +887,14 @@ var getLivestreamDetail = {
     if (anchorTime) param.anchorTime = anchorTime;
     const searchWord = ctx.str("search-word");
     if (searchWord) param.searchWord = searchWord;
-    const orderBy = ctx.num("order-by");
-    const pageNum = ctx.num("page-num");
-    const pageSize = ctx.num("page-size");
-    if (orderBy !== void 0 || pageNum || pageSize) {
+    const orderBy = ctx.optionalNum("order-by");
+    const pageNum = ctx.optionalNum("page-num");
+    const pageSize = ctx.optionalNum("page-size");
+    if (orderBy !== void 0 || pageNum !== void 0 || pageSize !== void 0) {
       param.pagerHeader = {};
       if (orderBy !== void 0) param.pagerHeader.orderBy = orderBy;
-      if (pageNum) param.pagerHeader.pageNum = pageNum;
-      if (pageSize) param.pagerHeader.pageSize = pageSize;
+      if (pageNum !== void 0) param.pagerHeader.pageNum = pageNum;
+      if (pageSize !== void 0) param.pagerHeader.pageSize = pageSize;
     }
     const args = { spaceId, param };
     const mcpUrl = resolveMcpUrl(ctx.mcpUrl(), host, "community_content");
@@ -682,14 +909,14 @@ var getLivestreamAnalysis = {
   command: "+get_livestream_analysis",
   description: "AI-generated live session analysis report: highlight moments (time slices with metrics and AI insights) and sentiment opinions.",
   flags: [
-    { name: "space-id", type: "number", required: true, desc: "Identifier of the community space. SpaceId" },
-    { name: "game-id", type: "number", required: true, desc: "Identifier of the community space. SpaceId" },
+    { name: "space-id", type: "int64", required: true, min: 1, desc: "Community space ID. Discover it with: ae-cli community spaces list" },
+    { name: "game-id", type: "int64", required: false, min: 1, desc: "Deprecated compatibility alias; defaults to --space-id and must match it." },
     { name: "stream-id", type: "string", required: true, desc: "Live session ID (streamId) from +get_livestream_list." }
   ],
   risk: "read",
   execute: async (ctx) => {
-    const spaceId = ctx.num("space-id");
-    const gameId = ctx.num("game-id");
+    const spaceId = ctx.int64("space-id");
+    const gameId = ctx.optionalInt64("game-id") ?? spaceId;
     const streamId = ctx.str("stream-id");
     const host = ctx.host();
     const param = { gameId, streamId };
@@ -706,18 +933,18 @@ var getCommentsSummary = {
   command: "+get_comments_summary",
   description: "Comment analytics summary for a post: sentiment mix and time trends. Aggregate stats only\u2014no raw comment list.",
   flags: [
-    { name: "space-id", type: "number", required: true, desc: "Identifier of the community space. SpaceId" },
-    { name: "game-id", type: "number", required: true, desc: "Identifier of the community space. SpaceId" },
-    { name: "channel-id", type: "number", required: true, desc: "Channel ID from search_posts results." },
+    { name: "space-id", type: "int64", required: true, min: 1, desc: "Community space ID. Discover it with: ae-cli community spaces list" },
+    { name: "game-id", type: "int64", required: false, min: 1, desc: "Deprecated compatibility alias; defaults to --space-id and must match it." },
+    { name: "channel-id", type: "int64", required: true, min: 1, desc: "Channel ID from search_posts results." },
     { name: "uuid", type: "string", required: true, desc: "Content UUID from search_posts results." },
     { name: "start-time", type: "string", required: false, desc: "Comment publish time lower bound; defaults to this post's publishTime from search_posts/get_post_detail." },
     { name: "end-time", type: "string", required: false, desc: "Comment publish time upper bound. Format: yyyy-MM-dd." }
   ],
   risk: "read",
   execute: async (ctx) => {
-    const spaceId = ctx.num("space-id");
-    const gameId = ctx.num("game-id");
-    const channelId = ctx.num("channel-id");
+    const spaceId = ctx.int64("space-id");
+    const gameId = ctx.optionalInt64("game-id") ?? spaceId;
+    const channelId = ctx.int64("channel-id");
     const uuid = ctx.str("uuid");
     const host = ctx.host();
     const param = { gameId, channelId, uuid };
@@ -738,9 +965,9 @@ var getCommentTagAnalysis = {
   command: "+get_comment_tag_analysis",
   description: "Comment tag analysis: for a tagCode, counts and trends per tag value over time.",
   flags: [
-    { name: "space-id", type: "number", required: true, desc: "Identifier of the community space. SpaceId" },
-    { name: "game-id", type: "number", required: true, desc: "Identifier of the community space. SpaceId" },
-    { name: "channel-id", type: "number", required: true, desc: "Channel ID from search_posts results." },
+    { name: "space-id", type: "int64", required: true, min: 1, desc: "Community space ID. Discover it with: ae-cli community spaces list" },
+    { name: "game-id", type: "int64", required: false, min: 1, desc: "Deprecated compatibility alias; defaults to --space-id and must match it." },
+    { name: "channel-id", type: "int64", required: true, min: 1, desc: "Channel ID from search_posts results." },
     { name: "uuid", type: "string", required: true, desc: "Content UUID from search_posts results." },
     { name: "resource-type", type: "number", required: true, desc: "Resource type: 0 post, 1 video." },
     { name: "tag-code", type: "string", required: true, desc: "Tag code (tagCode) from +get_corpus_tags." },
@@ -749,9 +976,9 @@ var getCommentTagAnalysis = {
   ],
   risk: "read",
   execute: async (ctx) => {
-    const spaceId = ctx.num("space-id");
-    const gameId = ctx.num("game-id");
-    const channelId = ctx.num("channel-id");
+    const spaceId = ctx.int64("space-id");
+    const gameId = ctx.optionalInt64("game-id") ?? spaceId;
+    const channelId = ctx.int64("channel-id");
     const uuid = ctx.str("uuid");
     const resourceType = ctx.num("resource-type");
     const tagCode = ctx.str("tag-code");
@@ -774,13 +1001,13 @@ var getCorpusTags = {
   command: "+get_corpus_tags",
   description: "List corpus tags (tagId, tagCode, tagName, inferenceType) to pick tagCode for filters.",
   flags: [
-    { name: "space-id", type: "number", required: true, desc: "Identifier of the community space. SpaceId" },
-    { name: "game-id", type: "number", required: true, desc: "Identifier of the community space. SpaceId" }
+    { name: "space-id", type: "int64", required: true, min: 1, desc: "Community space ID. Discover it with: ae-cli community spaces list" },
+    { name: "game-id", type: "int64", required: false, min: 1, desc: "Deprecated compatibility alias; defaults to --space-id and must match it." }
   ],
   risk: "read",
   execute: async (ctx) => {
-    const spaceId = ctx.num("space-id");
-    const gameId = ctx.num("game-id");
+    const spaceId = ctx.int64("space-id");
+    const gameId = ctx.optionalInt64("game-id") ?? spaceId;
     const host = ctx.host();
     const param = { gameId };
     const args = { spaceId, param };
@@ -796,8 +1023,8 @@ var getRiskContent = {
   command: "+get_risk_content",
   description: "List content flagged as risk/moderation items; filter by risk type and time.",
   flags: [
-    { name: "space-id", type: "number", required: true, desc: "Identifier of the community space. SpaceId" },
-    { name: "game-id", type: "number", required: true, desc: "Identifier of the community space. SpaceId" },
+    { name: "space-id", type: "int64", required: true, min: 1, desc: "Community space ID. Discover it with: ae-cli community spaces list" },
+    { name: "game-id", type: "int64", required: false, min: 1, desc: "Deprecated compatibility alias; defaults to --space-id and must match it." },
     { name: "start-time", type: "string", required: true, desc: "Risk content publish time lower bound. Format: yyyy-MM-dd." },
     { name: "end-time", type: "string", required: true, desc: "Risk content publish time upper bound. Format: yyyy-MM-dd." },
     { name: "risk-codes", type: "string", required: false, desc: "Risk type code list." },
@@ -809,26 +1036,26 @@ var getRiskContent = {
   ],
   risk: "read",
   execute: async (ctx) => {
-    const spaceId = ctx.num("space-id");
-    const gameId = ctx.num("game-id");
+    const spaceId = ctx.int64("space-id");
+    const gameId = ctx.optionalInt64("game-id") ?? spaceId;
     const startTime = ctx.str("start-time");
     const endTime = ctx.str("end-time");
     const host = ctx.host();
     const param = { gameId, startTime, endTime };
     const riskCodes = ctx.str("risk-codes");
-    if (riskCodes) param.riskCodes = riskCodes.split(",").map(Number);
+    if (riskCodes) param.riskCodes = riskCodes.split(",").map((value) => BigInt(value.trim()));
     const searchWord = ctx.str("search-word");
     if (searchWord) param.searchWord = searchWord;
-    const includeTrends = ctx.bool("include-trends");
+    const includeTrends = ctx.optionalBool("include-trends");
     if (includeTrends !== void 0) param.includeTrends = includeTrends;
-    const orderBy = ctx.num("order-by");
-    const pageNum = ctx.num("page-num");
-    const pageSize = ctx.num("page-size");
-    if (orderBy !== void 0 || pageNum || pageSize) {
+    const orderBy = ctx.optionalNum("order-by");
+    const pageNum = ctx.optionalNum("page-num");
+    const pageSize = ctx.optionalNum("page-size");
+    if (orderBy !== void 0 || pageNum !== void 0 || pageSize !== void 0) {
       param.pagerHeader = {};
       if (orderBy !== void 0) param.pagerHeader.orderBy = orderBy;
-      if (pageNum) param.pagerHeader.pageNum = pageNum;
-      if (pageSize) param.pagerHeader.pageSize = pageSize;
+      if (pageNum !== void 0) param.pagerHeader.pageNum = pageNum;
+      if (pageSize !== void 0) param.pagerHeader.pageSize = pageSize;
     }
     const args = { spaceId, param };
     const mcpUrl = resolveMcpUrl(ctx.mcpUrl(), host, "community_content");
@@ -929,36 +1156,36 @@ var StatsCollector = class {
     convertedIntegerFields: 0,
     fields: {}
   };
-  truncated(field) {
+  truncated(field2) {
     this.value.truncatedFields += 1;
-    this.increment(field);
+    this.increment(field2);
   }
-  defaulted(field) {
+  defaulted(field2) {
     this.value.defaultedFields += 1;
-    this.increment(field);
+    this.increment(field2);
   }
-  convertedInteger(field) {
+  convertedInteger(field2) {
     this.value.convertedIntegerFields += 1;
-    this.increment(field);
+    this.increment(field2);
   }
-  increment(field) {
-    this.value.fields[field] = (this.value.fields[field] ?? 0) + 1;
+  increment(field2) {
+    this.value.fields[field2] = (this.value.fields[field2] ?? 0) + 1;
   }
 };
-function validationError(code, message, location = {}) {
+function validationError2(code, message, location = {}) {
   throw new CommunityDataValidationError(code, message, location);
 }
 function isObject(value) {
   return value !== null && typeof value === "object" && !Array.isArray(value);
 }
-function hasOwn(object, field) {
-  return Object.prototype.hasOwnProperty.call(object, field);
+function hasOwn(object, field2) {
+  return Object.prototype.hasOwnProperty.call(object, field2);
 }
-function fieldLocation(context, field) {
-  return { ...context.location, field };
+function fieldLocation(context, field2) {
+  return { ...context.location, field: field2 };
 }
-function statField(context, field) {
-  return `${context.type}.${field}`;
+function statField(context, field2) {
+  return `${context.type}.${field2}`;
 }
 function parseInteger(value, location, options = {}) {
   let integer;
@@ -967,7 +1194,7 @@ function parseInteger(value, location, options = {}) {
     integer = value;
   } else if (typeof value === "number") {
     if (!Number.isSafeInteger(value)) {
-      validationError(
+      validationError2(
         "community_invalid_integer",
         "The field must be a lossless integer number or a canonical decimal string.",
         location
@@ -976,7 +1203,7 @@ function parseInteger(value, location, options = {}) {
     integer = BigInt(value);
   } else if (typeof value === "string") {
     if (!CANONICAL_INTEGER.test(value) || value === "-0") {
-      validationError(
+      validationError2(
         "community_invalid_integer",
         "The field must be a lossless integer number or a canonical decimal string.",
         location
@@ -985,7 +1212,7 @@ function parseInteger(value, location, options = {}) {
     integer = BigInt(value);
     converted = true;
   } else {
-    validationError(
+    validationError2(
       "community_invalid_integer",
       "The field must be a lossless integer number or a canonical decimal string.",
       location
@@ -994,49 +1221,49 @@ function parseInteger(value, location, options = {}) {
   const minimum = options.min ?? INT64_MIN;
   const maximum = options.max ?? INT64_MAX;
   if (integer < minimum || integer > maximum) {
-    validationError("community_integer_out_of_range", "The field is outside its supported integer range.", location);
+    validationError2("community_integer_out_of_range", "The field is outside its supported integer range.", location);
   }
   if (options.positive && integer <= 0n) {
-    validationError("community_integer_out_of_range", "The field must be a positive integer.", location);
+    validationError2("community_integer_out_of_range", "The field must be a positive integer.", location);
   }
   if (options.nonnegative && integer < 0n) {
-    validationError("community_integer_out_of_range", "The field must be a nonnegative integer.", location);
+    validationError2("community_integer_out_of_range", "The field must be a nonnegative integer.", location);
   }
   return { value: integer, converted };
 }
-function parsePositiveId(value, field) {
-  return parseInteger(value, { field }, { positive: true }).value;
+function parsePositiveId(value, field2) {
+  return parseInteger(value, { field: field2 }, { positive: true }).value;
 }
-function normalizeIntegerField(input, output, field, context, options = {}) {
-  if (!hasOwn(input, field) || input[field] === null) {
+function normalizeIntegerField(input, output, field2, context, options = {}) {
+  if (!hasOwn(input, field2) || input[field2] === null) {
     if (options.required) {
-      validationError("community_required_field", "A required field is missing.", fieldLocation(context, field));
+      validationError2("community_required_field", "A required field is missing.", fieldLocation(context, field2));
     }
-    delete output[field];
+    delete output[field2];
     return void 0;
   }
-  const parsed = parseInteger(input[field], fieldLocation(context, field), options);
-  output[field] = parsed.value;
+  const parsed = parseInteger(input[field2], fieldLocation(context, field2), options);
+  output[field2] = parsed.value;
   if (parsed.converted) {
-    context.stats.convertedInteger(statField(context, field));
+    context.stats.convertedInteger(statField(context, field2));
   }
   return parsed.value;
 }
-function normalizeSmallIntegerField(input, output, field, context, options = {}) {
-  const integer = normalizeIntegerField(input, output, field, context, options);
+function normalizeSmallIntegerField(input, output, field2, context, options = {}) {
+  const integer = normalizeIntegerField(input, output, field2, context, options);
   if (integer === void 0) return void 0;
   const result = Number(integer);
-  output[field] = result;
+  output[field2] = result;
   return result;
 }
-function parseDateTime(value, location, requireTime = false) {
+function parseDateTime2(value, location, requireTime = false) {
   const match = /^(\d{4})-(\d{2})-(\d{2})(?: (\d{2}):(\d{2})(?::(\d{2})(?:\.(\d{3}))?)?)?$/.exec(value);
   if (!match) {
-    validationError("community_invalid_datetime", "The field must use a supported Iris date-time format.", location);
+    validationError2("community_invalid_datetime", "The field must use a supported Iris date-time format.", location);
   }
   const hasTime = match[4] !== void 0;
   if (requireTime && !hasTime) {
-    validationError("community_invalid_datetime", "The field must include a time component.", location);
+    validationError2("community_invalid_datetime", "The field must include a time component.", location);
   }
   const parts = {
     year: Number(match[1]),
@@ -1049,33 +1276,33 @@ function parseDateTime(value, location, requireTime = false) {
     hasTime
   };
   if (parts.year === 0 || parts.month < 1 || parts.month > 12 || parts.hour > 23 || parts.minute > 59 || parts.second > 59) {
-    validationError("community_invalid_datetime", "The field must use a supported Iris date-time format.", location);
+    validationError2("community_invalid_datetime", "The field must use a supported Iris date-time format.", location);
   }
   const calendarCheck = /* @__PURE__ */ new Date(0);
   calendarCheck.setUTCFullYear(parts.year, parts.month - 1, parts.day);
   calendarCheck.setUTCHours(parts.hour, parts.minute, parts.second, parts.millisecond);
   if (calendarCheck.getUTCFullYear() !== parts.year || calendarCheck.getUTCMonth() !== parts.month - 1 || calendarCheck.getUTCDate() !== parts.day || calendarCheck.getUTCHours() !== parts.hour || calendarCheck.getUTCMinutes() !== parts.minute || calendarCheck.getUTCSeconds() !== parts.second || calendarCheck.getUTCMilliseconds() !== parts.millisecond) {
-    validationError("community_invalid_datetime", "The field must use a supported Iris date-time format.", location);
+    validationError2("community_invalid_datetime", "The field must use a supported Iris date-time format.", location);
   }
   return parts;
 }
-function normalizeTextField(input, output, field, context, options = {}) {
-  const path = options.path ?? field;
-  if (!hasOwn(input, field) || input[field] === null) {
+function normalizeTextField(input, output, field2, context, options = {}) {
+  const path = options.path ?? field2;
+  if (!hasOwn(input, field2) || input[field2] === null) {
     if (options.required) {
-      validationError("community_required_field", "A required field is missing.", fieldLocation(context, path));
+      validationError2("community_required_field", "A required field is missing.", fieldLocation(context, path));
     }
-    delete output[field];
+    delete output[field2];
     return void 0;
   }
-  const value = input[field];
+  const value = input[field2];
   if (typeof value !== "string") {
-    validationError("community_invalid_text", "The field must be a JSON string.", fieldLocation(context, path));
+    validationError2("community_invalid_text", "The field must be a JSON string.", fieldLocation(context, path));
   }
   let normalized = value;
   if (options.maxLength !== void 0 && normalized.length > options.maxLength) {
     if (!options.truncate) {
-      validationError(
+      validationError2(
         "community_text_too_long",
         `The field must not exceed ${options.maxLength} UTF-16 code units.`,
         fieldLocation(context, path)
@@ -1085,9 +1312,9 @@ function normalizeTextField(input, output, field, context, options = {}) {
     context.stats.truncated(statField(context, path));
   }
   if (options.dateTime) {
-    parseDateTime(normalized, fieldLocation(context, path), options.requireTime);
+    parseDateTime2(normalized, fieldLocation(context, path), options.requireTime);
   }
-  output[field] = normalized;
+  output[field2] = normalized;
   return normalized;
 }
 function parseEncodedObject(value) {
@@ -1100,21 +1327,21 @@ function parseEncodedObject(value) {
     return void 0;
   }
 }
-function normalizeFallbackObjectField(input, output, field, context) {
-  const object = hasOwn(input, field) && input[field] !== null ? parseEncodedObject(input[field]) : void 0;
+function normalizeFallbackObjectField(input, output, field2, context) {
+  const object = hasOwn(input, field2) && input[field2] !== null ? parseEncodedObject(input[field2]) : void 0;
   if (object === void 0) {
     const fallback = {};
-    output[field] = fallback;
-    context.stats.defaulted(statField(context, field));
+    output[field2] = fallback;
+    context.stats.defaulted(statField(context, field2));
     return fallback;
   }
-  output[field] = object;
+  output[field2] = object;
   return object;
 }
-function normalizeRequiredObjectValue(value, context, field) {
+function normalizeRequiredObjectValue(value, context, field2) {
   const object = parseEncodedObject(value);
   if (object === void 0) {
-    validationError("community_invalid_object", "The field must be a JSON object.", fieldLocation(context, field));
+    validationError2("community_invalid_object", "The field must be a JSON object.", fieldLocation(context, field2));
   }
   return object;
 }
@@ -1128,11 +1355,11 @@ function normalizeSubtitle(input, output, context) {
     try {
       value = parseCommunityJson(value);
     } catch {
-      validationError("community_invalid_array", "The field must be an array of JSON objects.", fieldLocation(context, "subtitle"));
+      validationError2("community_invalid_array", "The field must be an array of JSON objects.", fieldLocation(context, "subtitle"));
     }
   }
   if (!Array.isArray(value) || value.some((element) => !isObject(element))) {
-    validationError("community_invalid_array", "The field must be an array of JSON objects.", fieldLocation(context, "subtitle"));
+    validationError2("community_invalid_array", "The field must be an array of JSON objects.", fieldLocation(context, "subtitle"));
   }
   output.subtitle = value;
 }
@@ -1145,23 +1372,23 @@ function normalizeMetrics(value, contentType, context, fieldPrefix) {
   const metrics = normalizeRequiredObjectValue(value, context, fieldPrefix);
   const names = Object.keys(metrics);
   if (names.length === 0) {
-    validationError("community_empty_metrics", "The metrics object must not be empty.", fieldLocation(context, fieldPrefix));
+    validationError2("community_empty_metrics", "The metrics object must not be empty.", fieldLocation(context, fieldPrefix));
   }
   const allowed = metricNamesForContentType(contentType);
   const normalized = { ...metrics };
   for (const name of names) {
-    const field = `${fieldPrefix}.${name}`;
+    const field2 = `${fieldPrefix}.${name}`;
     if (!allowed.has(name)) {
-      validationError(
+      validationError2(
         "community_invalid_metric",
         "The metric name is not allowed for the selected content type.",
-        fieldLocation(context, field)
+        fieldLocation(context, field2)
       );
     }
-    const parsed = parseInteger(metrics[name], fieldLocation(context, field), { nonnegative: true });
+    const parsed = parseInteger(metrics[name], fieldLocation(context, field2), { nonnegative: true });
     normalized[name] = parsed.value;
     if (parsed.converted) {
-      context.stats.convertedInteger(statField(context, field));
+      context.stats.convertedInteger(statField(context, field2));
     }
   }
   return normalized;
@@ -1179,7 +1406,7 @@ function normalizeInteractionSidecar(input, output, context, contentType) {
     path: "interaction.collect_time"
   });
   if (!hasOwn(interaction, "metrics") || interaction.metrics === null) {
-    validationError("community_required_field", "A required field is missing.", fieldLocation(context, "interaction.metrics"));
+    validationError2("community_required_field", "A required field is missing.", fieldLocation(context, "interaction.metrics"));
   }
   normalized.metrics = normalizeMetrics(interaction.metrics, contentType, context, "interaction.metrics");
   output.interaction = normalized;
@@ -1213,7 +1440,7 @@ function normalizeRootFields(input, output, context) {
   normalizeTextField(input, output, "root_id", context, { required: true, maxLength: 32, truncate: true });
   const rootType = normalizeTextField(input, output, "root_type", context, { required: true });
   if (!ROOT_TYPES.has(rootType)) {
-    validationError("community_invalid_enum", "The field contains an unsupported enum value.", fieldLocation(context, "root_type"));
+    validationError2("community_invalid_enum", "The field contains an unsupported enum value.", fieldLocation(context, "root_type"));
   }
 }
 function normalizeReply(input, context) {
@@ -1273,11 +1500,11 @@ function zonedDateTimeToEpochMilliseconds(parts, zoneId) {
   return estimate;
 }
 function validateStreamId(roomId, streamStartTime, context) {
-  const parts = parseDateTime(streamStartTime, fieldLocation(context, "stream_start_time"), true);
+  const parts = parseDateTime2(streamStartTime, fieldLocation(context, "stream_start_time"), true);
   const timestamp = zonedDateTimeToEpochMilliseconds(parts, context.zoneId);
   const streamId = `${context.channelId}_${roomId}_${timestamp}`;
   if (streamId.length > 64) {
-    validationError(
+    validationError2(
       "community_derived_id_too_long",
       "The derived stream identifier exceeds its supported length.",
       fieldLocation(context, "stream_start_time")
@@ -1315,9 +1542,9 @@ function normalizeLiveRoom(input, context) {
   for (const metric of ["online", "heat", "noble_count", "guardian_count", "diamond_fan_count", "dfans_count"]) {
     normalizeIntegerField(input, output, metric, context, { nonnegative: true });
   }
-  const guardianAliases = ["guardian_count", "diamond_fan_count", "dfans_count"].filter((field) => hasOwn(input, field) && input[field] !== null);
+  const guardianAliases = ["guardian_count", "diamond_fan_count", "dfans_count"].filter((field2) => hasOwn(input, field2) && input[field2] !== null);
   if (guardianAliases.length > 1) {
-    validationError(
+    validationError2(
       "community_conflicting_fields",
       "Only one guardian metric alias may be supplied.",
       fieldLocation(context, guardianAliases[1])
@@ -1336,16 +1563,16 @@ function normalizeLiveRoom(input, context) {
     "diamond_fan_count",
     "dfans_count"
   ];
-  const hasStreamDetails = streamDependentFields.some((field) => hasOwn(input, field) && input[field] !== null);
+  const hasStreamDetails = streamDependentFields.some((field2) => hasOwn(input, field2) && input[field2] !== null);
   if (hasStreamDetails && streamStartTime === void 0) {
-    validationError(
+    validationError2(
       "community_required_field",
       "A stream start time is required when stream details or metrics are supplied.",
       fieldLocation(context, "stream_start_time")
     );
   }
   if (uuid * 5n + 4n > INT64_MAX) {
-    validationError(
+    validationError2(
       "community_derived_id_overflow",
       "A derived live metric identifier would exceed signed int64.",
       fieldLocation(context, "uuid")
@@ -1361,14 +1588,14 @@ function normalizeLiveInteraction(input, context) {
   normalizeIntegerField(input, output, "uuid", context, { required: true, nonnegative: true });
   const activityType = normalizeTextField(input, output, "activity_type", context, { required: true });
   if (!ACTIVITY_TYPES.has(activityType)) {
-    validationError("community_invalid_enum", "The field contains an unsupported enum value.", fieldLocation(context, "activity_type"));
+    validationError2("community_invalid_enum", "The field contains an unsupported enum value.", fieldLocation(context, "activity_type"));
   }
   normalizeTextField(input, output, "activity_content", context, { required: true, maxLength: 1024, truncate: true });
   normalizeTextField(input, output, "user_id", context, { maxLength: 80, truncate: true });
   normalizeTextField(input, output, "user_name", context, { maxLength: 80, truncate: true });
   const userExtra = normalizeFallbackObjectField(input, output, "user_extra", context);
   if (stringifyCommunityJson(userExtra).length > 1024) {
-    validationError(
+    validationError2(
       "community_object_too_long",
       "The compact user_extra object must not exceed 1024 UTF-16 code units.",
       fieldLocation(context, "user_extra")
@@ -1409,14 +1636,14 @@ function normalizeInteraction(input, context) {
   });
   normalizeTextField(input, output, "collect_time", context, { required: true, dateTime: true });
   if (!hasOwn(input, "metrics") || input.metrics === null) {
-    validationError("community_required_field", "A required field is missing.", fieldLocation(context, "metrics"));
+    validationError2("community_required_field", "A required field is missing.", fieldLocation(context, "metrics"));
   }
   output.metrics = normalizeMetrics(input.metrics, contentType, context, "metrics");
   return output;
 }
 function normalizeRecord(input, context) {
   if (!isObject(input)) {
-    validationError("community_invalid_record", "Each data record must be a JSON object.", context.location);
+    validationError2("community_invalid_record", "Each data record must be a JSON object.", context.location);
   }
   switch (context.type) {
     case "post":
@@ -1439,7 +1666,7 @@ function normalizeRecord(input, context) {
 }
 function parseDataType(value, segment) {
   if (typeof value !== "string" || !ALL_DATA_TYPES.has(value)) {
-    validationError(
+    validationError2(
       "community_invalid_data_type",
       "The segment data_type must be one of the eight supported community data types.",
       { segment, field: "data_type" }
@@ -1449,20 +1676,20 @@ function parseDataType(value, segment) {
 }
 function normalizeSegment(input, segment, channelId, zoneId, stats) {
   if (!isObject(input)) {
-    validationError("community_invalid_segment", "Each payload segment must be a JSON object.", { segment });
+    validationError2("community_invalid_segment", "Each payload segment must be a JSON object.", { segment });
   }
   if (!hasOwn(input, "data_type")) {
-    validationError("community_required_field", "A required field is missing.", { segment, field: "data_type" });
+    validationError2("community_required_field", "A required field is missing.", { segment, field: "data_type" });
   }
   if (!hasOwn(input, "data") || input.data === null) {
-    validationError("community_required_field", "A required field is missing.", { segment, field: "data" });
+    validationError2("community_required_field", "A required field is missing.", { segment, field: "data" });
   }
   const dataType = parseDataType(input.data_type, segment);
   const records = Array.isArray(input.data) ? input.data : [input.data];
   if (records.length === 0) {
-    validationError("community_empty_data", "A segment data array must not be empty.", { segment, field: "data" });
+    validationError2("community_empty_data", "A segment data array must not be empty.", { segment, field: "data" });
   }
-  const normalized = records.map((record, index) => normalizeRecord(record, {
+  const normalized = records.map((record2, index) => normalizeRecord(record2, {
     type: dataType,
     channelId,
     zoneId,
@@ -1473,12 +1700,12 @@ function normalizeSegment(input, segment, channelId, zoneId, stats) {
 }
 function validateZoneId(value) {
   if (typeof value !== "string" || value.length === 0) {
-    validationError("community_invalid_zone_id", "zone_id must be a valid IANA time zone name.", { field: "zone_id" });
+    validationError2("community_invalid_zone_id", "zone_id must be a valid IANA time zone name.", { field: "zone_id" });
   }
   try {
     new Intl.DateTimeFormat("en-US", { timeZone: value }).format(0);
   } catch {
-    validationError("community_invalid_zone_id", "zone_id must be a valid IANA time zone name.", { field: "zone_id" });
+    validationError2("community_invalid_zone_id", "zone_id must be a valid IANA time zone name.", { field: "zone_id" });
   }
   return value;
 }
@@ -1490,7 +1717,7 @@ function normalizeCommunityReportInput(input) {
   const hasDataMode = input.dataType !== void 0 || input.data !== void 0;
   const hasPayloadMode = input.payload !== void 0;
   if (hasDataMode === hasPayloadMode) {
-    validationError(
+    validationError2(
       "community_input_mode",
       "Use exactly one input mode: data_type with data, or payload.",
       { field: "data/payload" }
@@ -1499,7 +1726,7 @@ function normalizeCommunityReportInput(input) {
   let rawSegments;
   if (hasDataMode) {
     if (input.dataType === void 0 || input.data === void 0) {
-      validationError(
+      validationError2(
         "community_input_mode",
         "The data_type and data fields must be supplied together.",
         { field: input.dataType === void 0 ? "data_type" : "data" }
@@ -1509,7 +1736,7 @@ function normalizeCommunityReportInput(input) {
   } else {
     rawSegments = Array.isArray(input.payload) ? input.payload : [input.payload];
     if (rawSegments.length === 0) {
-      validationError("community_empty_payload", "The payload array must not be empty.", { field: "payload" });
+      validationError2("community_empty_payload", "The payload array must not be empty.", { field: "payload" });
     }
   }
   const stats = new StatsCollector();
@@ -1686,7 +1913,7 @@ function resolveCommunityReportEndpoint(flagValue, environment = process.env) {
   }
   return endpoint.toString();
 }
-function readCommunityReportInput(raw, field) {
+function readCommunityReportInput(raw, field2) {
   const trimmed = raw.trim();
   let text;
   try {
@@ -1704,8 +1931,8 @@ function readCommunityReportInput(raw, field) {
       "Unable to read the community JSON input.",
       {
         code: "community_input_read_failed",
-        hint: `Pass --${field} as inline JSON, an existing path, @path, or - for stdin.`,
-        location: { field }
+        hint: `Pass --${field2} as inline JSON, an existing path, @path, or - for stdin.`,
+        location: { field: field2 }
       }
     );
   }
@@ -1718,7 +1945,7 @@ function readCommunityReportInput(raw, field) {
         {
           code: error.code,
           hint: SCHEMA_VALIDATION_HINT,
-          location: { field }
+          location: { field: field2 }
         }
       );
     }
@@ -1801,6 +2028,258 @@ function formatNormalization(stats) {
   };
 }
 
+// src/commands/te-community/spaces-list.ts
+var spacesList = createCapabilityCommand({
+  cliService: "community",
+  resource: "spaces",
+  command: "list",
+  capabilityId: "community.space.list",
+  description: "List community spaces available to the current user.",
+  flags: [],
+  risk: "read",
+  buildInput: () => ({})
+});
+var communitySpacesList = {
+  ...spacesList,
+  async execute(ctx) {
+    const result = await spacesList.execute(ctx);
+    const data = unwrapOutputData(result);
+    return Array.isArray(data) ? withOutputMetadata(result, { returned_count: data.length }) : result;
+  }
+};
+
+// src/commands/te-community/sources-list.ts
+var communitySourcesList = createCapabilityCommand({
+  cliService: "community",
+  resource: "sources",
+  command: "list",
+  capabilityId: "community.source.list",
+  description: "List configured community ingestion sources and their channel/source IDs.",
+  flags: [
+    {
+      name: "space-id",
+      type: "int64",
+      required: true,
+      min: 1,
+      desc: "Community space ID returned by `ae-cli community spaces list`."
+    }
+  ],
+  risk: "read",
+  buildInput: (ctx) => ({
+    game_id: ctx.int64("space-id")
+  })
+});
+
+// src/commands/te-community/evidence-fetch.ts
+import { createHash } from "crypto";
+import { readFileSync as readFileSync2 } from "fs";
+var CAPABILITY = "community.content.post_detail";
+var MAX_ITEMS = 20;
+var INT64_MAX2 = 9223372036854775807n;
+function invalid(message) {
+  throw new CliValidationError(message, { hint: 'Use --input @file.json with {"items":[{"channel_id":"<ID>","uuid":"<UUID>","resource_type":0}]}.' });
+}
+function record(value) {
+  return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+function int64(value) {
+  if (typeof value === "number" && !Number.isSafeInteger(value)) invalid("Evidence IDs must be exact integers; use quoted int64 IDs.");
+  if (!["string", "number", "bigint"].includes(typeof value) || !/^[1-9]\d*$/.test(String(value))) invalid("Evidence channel_id must be a positive int64.");
+  if (BigInt(String(value)) > INT64_MAX2) invalid("Evidence channel_id exceeds signed int64.");
+  return String(value);
+}
+function prepare(ctx) {
+  let input;
+  try {
+    const raw = ctx.str("input").trim();
+    input = parseJsonRequest(raw === "-" ? readFileSync2(0, "utf8") : raw.startsWith("@") ? readFileSync2(raw.slice(1), "utf8") : raw);
+  } catch {
+    invalid("Cannot read evidence input as JSON.");
+  }
+  if (!record(input) || Object.keys(input).some((k) => k !== "items") || !Array.isArray(input.items) || input.items.length < 1 || input.items.length > MAX_ITEMS) invalid("Evidence input must contain only items, with 1 to 20 entries.");
+  const locators = input.items.map((value) => {
+    if (!record(value) || Object.keys(value).some((k) => !["channel_id", "uuid", "resource_type"].includes(k))) invalid("Each evidence item must contain only channel_id, uuid, and resource_type.");
+    const channelId = int64(value.channel_id);
+    if (typeof value.uuid !== "string" || !value.uuid.trim() || value.uuid.length > 512 || /[\u0000-\u001f\u007f]/.test(value.uuid)) invalid("Evidence uuid must be a non-empty opaque ID of at most 512 characters without control characters.");
+    if (value.resource_type !== 0 && value.resource_type !== 1) invalid("Evidence resource_type must be 0 (post) or 1 (video).");
+    return { channel_id: channelId, uuid: value.uuid, resource_type: value.resource_type };
+  });
+  const spaceId = ctx.int64("space-id");
+  if (spaceId < 1n || spaceId > INT64_MAX2) invalid("Evidence space-id must be a positive int64.");
+  const maxChars = ctx.optionalNum("max-chars") ?? 1e5;
+  if (!Number.isInteger(maxChars) || maxChars < 1 || maxChars > 1e6) invalid("--max-chars must be an integer between 1 and 1000000.");
+  const unique = [...new Map(locators.map((item) => [JSON.stringify(item), item])).values()];
+  return { spaceId, requested: locators.length, locators: unique, maxChars };
+}
+function request(spaceId, item) {
+  return {
+    game_id: spaceId,
+    channel_id: BigInt(item.channel_id),
+    uuid: item.uuid,
+    resource_type: item.resource_type,
+    reply_pager_header: { page_num: 1, page_size: 1 },
+    danmu_pager_header: { page_num: 1, page_size: 1 }
+  };
+}
+function identity(host, spaceId, item) {
+  return `community:${createHash("sha256").update(JSON.stringify([host.replace(/\/+$/, ""), String(spaceId), item.channel_id, item.resource_type, item.uuid])).digest("hex")}`;
+}
+function field(data, snake, camel = snake) {
+  return data[snake] ?? data[camel];
+}
+function matches(data, item) {
+  if (!record(data)) return false;
+  const type = field(data, "resource_type", "resourceType");
+  return String(field(data, "channel_id", "channelId")) === item.channel_id && data.uuid === item.uuid && (type === item.resource_type || type === (item.resource_type === 0 ? "POST" : "VIDEO"));
+}
+function evidenceText(data, remaining) {
+  const text = {};
+  const textFields = {};
+  let used = 0;
+  let truncated = false;
+  for (const name of ["title", "content", "description", "subtitle"]) {
+    const value = data[name];
+    const parts = typeof value === "string" ? [value] : Array.isArray(value) && value.every((v) => typeof v === "string") ? value : null;
+    if (parts === null) {
+      text[name] = null;
+      textFields[name] = { status: value == null ? "missing" : "unsupported_format" };
+      continue;
+    }
+    let original = 0;
+    let returned = 0;
+    const clipped = [];
+    for (const part of parts) {
+      const chars = Array.from(part);
+      original += chars.length;
+      const kept = chars.slice(0, Math.max(0, remaining - used));
+      returned += kept.length;
+      used += kept.length;
+      if (kept.length || chars.length === 0) clipped.push(kept.join(""));
+    }
+    text[name] = typeof value === "string" ? clipped[0] ?? "" : clipped;
+    const cut = returned < original;
+    truncated ||= cut;
+    textFields[name] = { status: cut ? "truncated" : "available", original_chars: original, returned_chars: returned };
+  }
+  return { text, textFields, used, truncated };
+}
+function safeSource(data) {
+  const value = field(data, "red_note_url", "redNoteUrl");
+  if (typeof value !== "string" || value.length > 4096) return null;
+  try {
+    return ["https:", "http:"].includes(new URL(value).protocol) ? value : null;
+  } catch {
+    return null;
+  }
+}
+function safeError(error) {
+  const code = (value, fallback) => typeof value === "string" && /^[A-Za-z0-9_-]{1,80}$/.test(value) ? value : fallback;
+  if (error instanceof SecureStoreAuthError) return { type: "auth", code: "AUTH_REQUIRED", message: "Authentication is required to read evidence." };
+  if (error instanceof PermissionError) return { type: "permission", code: code(error.code, "PERMISSION_DENIED"), message: "Access to this evidence was denied." };
+  if (error instanceof CapabilityGatewayError) {
+    const type = error.httpStatus === 401 ? "auth" : error.httpStatus === 403 ? "permission" : "api";
+    return { type, code: code(error.code, "CAPABILITY_FAILED"), message: "Evidence could not be read from the capability service." };
+  }
+  return { type: "api", code: "REQUEST_FAILED", message: "Evidence request failed." };
+}
+var communityEvidenceFetch = {
+  service: "community",
+  resource: "evidence",
+  command: "fetch",
+  description: "Read up to 20 unique post/video sources with verified IDs, complete text, and explicit partial-result status.",
+  flags: [
+    { name: "space-id", type: "int64", required: true, min: 1, desc: "Community space ID from spaces list." },
+    { name: "input", type: "string", required: true, sensitive: true, desc: "JSON object, @file.json, or - for stdin; items contain channel_id, uuid, resource_type." },
+    { name: "max-chars", type: "number", min: 1, max: 1e6, desc: "Combined returned text budget in Unicode code points (default 100000)." }
+  ],
+  risk: "read",
+  dryRun: (ctx) => {
+    const plan = prepare(ctx);
+    return {
+      method: "POST",
+      url: buildCapabilityGatewayUrl(ctx.host(), resolveGatewayDomain("community", "community"), `capabilities/${CAPABILITY}/execute`),
+      body: {
+        preview_only: true,
+        requested: plan.requested,
+        unique: plan.locators.length,
+        max_chars: plan.maxChars,
+        inputs: plan.locators.map((item) => ({ ...request(plan.spaceId, item), game_id: String(plan.spaceId), channel_id: item.channel_id }))
+      }
+    };
+  },
+  execute: async (ctx) => {
+    const plan = prepare(ctx);
+    const gatewayDomain = resolveGatewayDomain("community", "community");
+    const items = [];
+    let returnedChars = 0;
+    let accessStopped = false;
+    for (const item of plan.locators) {
+      const base = { evidence_id: identity(ctx.host(), plan.spaceId, item), locator: { space_id: String(plan.spaceId), ...item } };
+      if (returnedChars >= plan.maxChars || accessStopped) {
+        items.push({ ...base, status: "not_fetched", reason: accessStopped ? "access_denied" : "text_budget_exhausted" });
+        continue;
+      }
+      try {
+        const response = await requestCapabilityGatewayWithEnvelope(ctx.host(), gatewayDomain, `capabilities/${CAPABILITY}/execute`, "POST", { input: request(plan.spaceId, item) });
+        if (response.data == null) {
+          items.push({ ...base, status: "missing", reason: "no_detail_returned" });
+          continue;
+        }
+        if (!matches(response.data, item)) {
+          items.push({ ...base, status: "invalid_response", reason: "evidence_identity_mismatch" });
+          continue;
+        }
+        const excerpt = evidenceText(response.data, plan.maxChars - returnedChars);
+        returnedChars += excerpt.used;
+        items.push({
+          ...base,
+          status: "ok",
+          text: excerpt.text,
+          author: { user_id: field(response.data, "user_id", "userId") ?? null, user_name: field(response.data, "user_name", "userName") ?? null },
+          publish_time: field(response.data, "publish_time", "publishTime") ?? null,
+          last_update_time: field(response.data, "last_update_time", "lastUpdateTime") ?? null,
+          source_url: safeSource(response.data),
+          quality: {
+            identity_verified: true,
+            text_truncated: excerpt.truncated,
+            source_completeness: "unknown",
+            text_fields: excerpt.textFields,
+            related_comments_included: false,
+            related_media_included: false
+          },
+          ...response.meta ? { meta: response.meta } : {}
+        });
+      } catch (error) {
+        const failure = safeError(error);
+        accessStopped = failure.type === "auth" || failure.type === "permission";
+        items.push({ ...base, status: "error", error: failure });
+      }
+    }
+    return {
+      contract_version: "community-evidence-v1",
+      capability_id: CAPABILITY,
+      host: ctx.host(),
+      space_id: String(plan.spaceId),
+      requested: plan.requested,
+      unique: items.length,
+      items,
+      quality: {
+        dataset_complete: false,
+        batch_complete: items.every((item) => item.status === "ok" && !item.quality.text_truncated),
+        returned_chars: returnedChars,
+        max_chars: plan.maxChars,
+        snapshot: false
+      }
+    };
+  }
+};
+var communityEvidenceFetchAlias = {
+  ...communityEvidenceFetch,
+  resource: void 0,
+  command: "+fetch-evidence",
+  description: "Compatibility alias for community evidence fetch."
+};
+
 // src/commands/te-community/index.ts
 registerCapabilityGatewayRoute("community", { gatewayDomain: "community" });
 registerMcpMappings({
@@ -1808,8 +2287,7 @@ registerMcpMappings({
   "community_analysis": { componentName: "community", mappingPath: "analysis" },
   "community_hot": { componentName: "community", mappingPath: "hot" }
 });
-var commands = [
-  communityDataReport,
+var communityReadCommands = [
   // Content commands
   getLivestreamList,
   getLivestreamDetail,
@@ -1833,6 +2311,20 @@ var commands = [
   getHotTopics,
   getTopicDetail
 ];
+var commands = [
+  communityDataReport,
+  communityEvidenceFetch,
+  communityEvidenceFetchAlias,
+  communitySpacesList,
+  communitySourcesList,
+  ...communityReadCommands.map((command) => ({
+    ...command,
+    validate: (ctx) => {
+      validateCommunityCommand(ctx, command);
+      command.validate?.(ctx);
+    }
+  }))
+];
 var te_community_default = commands;
 export {
   te_community_default as default