@thinkingai/ae-cli 6.0.55 → 6.0.56

package/dist/{te-analysis-ISXKJKRT.js → te-analysis-RJB6VJC4.js}

@@ -7,12 +7,12 @@ import {
   waitForAnalysisRun,
   withAsyncArtifactLifecycle,
   withInterruptSignal
-} from "./chunk-RGYPSEYD.js";
+} from "./chunk-W2PTY5NN.js";
 import {
   createCapabilityCommand,
   definitionIntentSnapshotFlag,
   modelDefinitionIntentSnapshotFlag
-} from "./chunk-374V5R6N.js";
+} from "./chunk-3TQA5RXE.js";
 import {
   registerCapabilityGatewayRoute,
   resolveGatewayDomain
@@ -30,18 +30,18 @@ import {
   uploadInputFile,
   validateCapability,
   validateCapabilityWithEnvelope
-} from "./chunk-VZZNLV3I.js";
+} from "./chunk-MXV3PYC3.js";
 import {
   withOutputMetadata
-} from "./chunk-6VNIR4AP.js";
+} from "./chunk-ELCR235M.js";
 import "./chunk-Y74WTIKJ.js";
 import {
   getCliToken
-} from "./chunk-GHXZK54S.js";
-import "./chunk-ZL7SGNIA.js";
+} from "./chunk-P7KL7IOH.js";
+import "./chunk-LMCYSVVA.js";
 import {
   CliValidationError
-} from "./chunk-WNGFSIOB.js";
+} from "./chunk-ZW4VMY5H.js";
 
 // src/commands/te-analysis/capability-shared.ts
 var ANALYSIS_GATEWAY_CLI_SERVICES = /* @__PURE__ */ new Set(["project", "system"]);
@@ -229,7 +229,7 @@ var asyncTimeoutSecondsFlag = {
   name: "timeout-seconds",
   type: "number",
   required: false,
-  desc: "Async runtime in seconds. Default and max: 21600 (6 hours); cancel earlier with analysis query cancel --run-id <run_id>.",
+  desc: "Async runtime in seconds. Omit to use the server default (usually 21600 / 6 hours). This CLI accepts explicit values up to 21600; inspect the capability for the server default/max and use capability run for larger allowed values. Cancel with analysis query cancel --run-id <run_id>.",
   min: 1,
   max: 21600
 };
@@ -1647,7 +1647,7 @@ var recordIdFlag = { name: "record-id", type: "number", required: false, desc: "
 var governanceExportFlags = (format) => [
   requestIdFlag,
   { ...artifactFormatFlag, desc: `Artifact format: ${format}. This capability supports only ${format}.` },
-  { ...asyncTimeoutSecondsFlag, max: 7200, desc: "Async export runtime in seconds. Default: 3600, max: 7200." }
+  { ...asyncTimeoutSecondsFlag, max: 7200, desc: "Async export runtime in seconds. Omit to use the server-provided default. This CLI accepts explicit values up to 7200; inspect the capability for the server default/max and use capability run for larger allowed values." }
 ];
 var governanceExportFields = ["request_id", "format", "timeout_seconds"];
 var readers = {
@@ -3098,6 +3098,7 @@ var SUBMIT_TO_PAGE_HELP = [
   "- Scripts may assemble transport JSON and copy evidence, but page-visible ai_summary and analysis_explanation text must be Agent-written interpretation from verified evidence, not generated boilerplate.",
   "- Follow agent_review_preflight.md: independent Agent review, at most 3 corrections, then submit with unresolved-quality warnings only when already authorized. LOCAL_ONLY never submits. Business meaning and visible-text quality are Agent review responsibilities; this command enforces only transport structure and evidence references.",
   "- Follow agent_review_priorities_comparisons.md: item ai_summary includes recommendation.priority/priority_reason/evidence_refs, classified comparisons with both-side evidence, and comparison_review coverage. LOW is review urgency, not a defer decision; only POSSIBLE_CONFLICT merits a conflict badge. These assessments share the same 3-correction budget.",
+  "- Each new topic must include semantic_basis with business_question, grouping_reason, and evidence_item_ids from that topic. These are Agent-authored business interpretations; legacy packets without this optional field remain accepted.",
   "- presentation_snapshot.topics is one or more business-domain topics. Each topic must use groups[].items; do not use top-level topics[].items or raw Common work_units as the page grouping.",
   "- relations should let the page render dashboard -> report -> metadata with contains/uses edges. Use an empty relations array only when the package truly has no known parent-child evidence.",
   "- Each submitted item must keep source_link or evidence_links[].url so reviewers can jump to source evidence.",
@@ -3332,6 +3333,7 @@ function validatePresentation(presentation, itemIds) {
   const displayed = /* @__PURE__ */ new Set();
   for (const topicValue of array2(presentation.topics, "presentation_snapshot.topics")) {
     const topic = object(topicValue, "presentation_snapshot.topics[]");
+    const topicItemIds = /* @__PURE__ */ new Set();
     if ("items" in topic) {
       throw new Error("presentation_snapshot.topics[] must use groups[].items, not top-level items.");
     }
@@ -3349,6 +3351,19 @@ function validatePresentation(presentation, itemIds) {
           throw new Error("presentation_snapshot references an unknown client_item_id.");
         }
         displayed.add(item.id);
+        topicItemIds.add(item.id);
+      }
+    }
+    if (topic.semantic_basis !== void 0) {
+      const basis = object(topic.semantic_basis, "presentation_snapshot.topics[].semantic_basis");
+      for (const field of ["business_question", "grouping_reason"]) {
+        if (typeof basis[field] !== "string" || !String(basis[field]).trim()) {
+          throw new Error(`semantic_basis.${field} must explain the business meaning of this topic.`);
+        }
+      }
+      const references = array2(basis.evidence_item_ids, "semantic_basis.evidence_item_ids");
+      if (!references.length || references.some((id) => typeof id !== "string" || !topicItemIds.has(id))) {
+        throw new Error("semantic_basis.evidence_item_ids must reference items displayed in the same topic.");
       }
     }
   }
@@ -4989,11 +5004,11 @@ var dashboardReportGet = createAnalysisCapabilityCommand({
   resource: "dashboard-report",
   command: "get",
   capabilityId: "analysis.dashboard_report.get",
-  description: "Get an event report card presentation on one analysis dashboard, not the source report definition.",
+  description: "Get one analysis-board report card frame size, saved grid position, dashboard layout version, and event presentation; not the source report definition.",
   flags: [
     projectIdFlag,
     { name: "dashboard-id", type: "number", required: true, desc: "Dashboard containing the report card." },
-    { name: "report-id", type: "number", required: true, desc: "Existing event report ID on that dashboard." }
+    { name: "report-id", type: "number", required: true, desc: "Existing report ID on that dashboard. Event cards also return chart and table presentation." }
   ],
   risk: "read",
   buildInput: (ctx) => ({
@@ -5008,11 +5023,15 @@ var dashboardReportUpdate = createAnalysisCapabilityCommand({
   resource: "dashboard-report",
   command: "update",
   capabilityId: "analysis.dashboard_report.update",
-  description: "Update one event report card presentation without changing the source report definition or other dashboards.",
+  description: "Update one analysis-board report card frame size or grid position, or an event card presentation, without changing its source definition or other dashboards.",
   flags: [
     projectIdFlag,
     { name: "dashboard-id", type: "number", required: true, desc: "Dashboard containing the report card." },
-    { name: "report-id", type: "number", required: true, desc: "Existing event report ID on that dashboard." },
+    { name: "report-id", type: "number", required: true, desc: "Existing report ID on that dashboard. Chart and table settings require an event report." },
+    { name: "frame-size", type: "string", required: false, desc: "Card frame size: medium or large. Omit to preserve. Requires the current --reports-version from dashboard-report get." },
+    { name: "position-x", type: "number", required: false, desc: "Zero-based horizontal grid coordinate, 0..19 on a 20-column board. Supply with --position-y and --reports-version. Must fit the saved card width; occupied destinations are rejected." },
+    { name: "position-y", type: "number", required: false, desc: "Zero-based vertical grid coordinate, 0..10000, not pixels. Supply with --position-x and --reports-version. Requires an initialized saved board layout; the page may vertically compact gaps." },
+    { name: "reports-version", type: "number", required: false, desc: "Fresh dashboard layout version from dashboard-report get. Required for frame-size or position changes; stale versions are rejected without partial writes. This is not the source report version." },
     { name: "chart-type", type: "string", required: false, desc: "Card chart type: line, combo, bar, stacked, cumulative, pie, or table. Combo inherits existing source-report series; this command cannot edit series. A pure line card requires resetting source combo first. Gateway validates compatibility with the saved event definition." },
     { name: "table-layout", type: "string", required: false, desc: "Table layout: date, event, or group. Omit to preserve it." },
     { name: "date-outside", type: "boolean", required: false, desc: "Show dates outside the table. True requires a grouped table with a non-date layout; also choose event/group layout when inherited. Pass false to clear, omit to preserve." }
@@ -5022,8 +5041,35 @@ var dashboardReportUpdate = createAnalysisCapabilityCommand({
     const chartType = optionalString(ctx, "chart-type");
     const tableLayout = optionalString(ctx, "table-layout");
     const dateOutside = optionalBoolean(ctx, "date-outside");
-    if (chartType === void 0 && tableLayout === void 0 && dateOutside === void 0) {
-      throw new Error("At least one of --chart-type, --table-layout, or --date-outside is required.");
+    const frameSize = optionalString(ctx, "frame-size");
+    const x = optionalNumber(ctx, "position-x");
+    const y = optionalNumber(ctx, "position-y");
+    const version = optionalNumber(ctx, "reports-version");
+    if (frameSize !== void 0 && !["medium", "large"].includes(frameSize)) {
+      throw new Error("--frame-size must be medium or large.");
+    }
+    if (x === void 0 !== (y === void 0)) {
+      throw new Error("--position-x and --position-y must be supplied together.");
+    }
+    for (const [name, value] of [["position-x", x], ["position-y", y], ["reports-version", version]]) {
+      if (value !== void 0 && (!Number.isSafeInteger(value) || value < 0)) {
+        throw new Error(`--${name} must be a non-negative safe integer.`);
+      }
+    }
+    if (x !== void 0 && x >= 20) {
+      throw new Error("--position-x must be between 0 and 19 and fit the saved card width.");
+    }
+    if (y !== void 0 && y > 1e4) {
+      throw new Error("--position-y must be between 0 and 10000.");
+    }
+    if (version === Number.MAX_SAFE_INTEGER) {
+      throw new Error("--reports-version must be safely incrementable; reread the dashboard version.");
+    }
+    if ((frameSize !== void 0 || x !== void 0) && version === void 0) {
+      throw new Error("--reports-version from dashboard-report get is required for frame-size or position changes.");
+    }
+    if (chartType === void 0 && tableLayout === void 0 && dateOutside === void 0 && frameSize === void 0 && x === void 0) {
+      throw new Error("At least one of --chart-type, --table-layout, --date-outside, --frame-size, or --position-x/--position-y is required.");
     }
     if (chartType !== void 0 && !["line", "combo", "bar", "stacked", "cumulative", "pie", "table"].includes(chartType)) {
       throw new Error("--chart-type must be line, combo, bar, stacked, cumulative, pie, or table.");
@@ -5032,16 +5078,23 @@ var dashboardReportUpdate = createAnalysisCapabilityCommand({
       throw new Error("--table-layout must be date, event, or group.");
     }
   },
-  buildInput: (ctx) => ({
-    ...projectInput(ctx),
-    dashboard_id: ctx.num("dashboard-id"),
-    report_id: ctx.num("report-id"),
-    presentation: compactInput({
+  buildInput: (ctx) => {
+    const presentation = compactInput({
       chart_type: optionalString(ctx, "chart-type"),
       table_layout: optionalString(ctx, "table-layout"),
       date_outside: optionalBoolean(ctx, "date-outside")
-    })
-  })
+    });
+    const x = optionalNumber(ctx, "position-x");
+    return compactInput({
+      ...projectInput(ctx),
+      dashboard_id: ctx.num("dashboard-id"),
+      report_id: ctx.num("report-id"),
+      frame_size: optionalString(ctx, "frame-size"),
+      position: x === void 0 ? void 0 : { x, y: optionalNumber(ctx, "position-y") },
+      reports_version: optionalNumber(ctx, "reports-version"),
+      presentation: Object.keys(presentation).length === 0 ? void 0 : presentation
+    });
+  }
 });
 
 // src/commands/te-analysis/dashboard-report/index.ts
@@ -8278,6 +8331,165 @@ var commands54 = [
 ];
 var member_candidate_default = commands54;
 
+// src/commands/te-analysis/project/member-group/shared.ts
+var MAX_ID = 2147483647;
+var memberGroupProjectIdFlag = { ...projectIdFlag, min: 1, max: MAX_ID };
+var memberGroupIdFlag = {
+  name: "group-id",
+  type: "number",
+  required: true,
+  min: 1,
+  max: MAX_ID,
+  desc: "Project member-group ID from project member-group list."
+};
+var memberGroupNameFlag = {
+  name: "group-name",
+  type: "string",
+  required: true,
+  desc: "Member-group name, from 1 to 80 characters."
+};
+var memberGroupUserIdsFlag = {
+  name: "user-ids",
+  type: "json",
+  required: true,
+  desc: "JSON array of 1 to 1000 positive user IDs. Verify IDs with project member list or member-group members. Changes only these group memberships."
+};
+var memberGroupPaginationFlags = [
+  { name: "limit", type: "number", min: 1, max: 1e3, desc: "Page size, from 1 to 1000. Default: 100." },
+  { name: "offset", type: "number", min: 0, desc: "Zero-based row offset. Default: 0." }
+];
+function integer(ctx, flag, min, max = MAX_ID) {
+  const value = ctx.num(flag);
+  if (!Number.isSafeInteger(value) || value < min || value > max) {
+    throw new CliValidationError(`--${flag} must be an integer between ${min} and ${max}.`);
+  }
+  return value;
+}
+function memberGroupProjectInput(ctx) {
+  return { project_id: integer(ctx, "project-id", 1) };
+}
+function memberGroupInput(ctx) {
+  return { ...memberGroupProjectInput(ctx), group_id: integer(ctx, "group-id", 1) };
+}
+function memberGroupPaginationInput(ctx) {
+  return {
+    ...ctx.str("limit") ? { limit: integer(ctx, "limit", 1, 1e3) } : {},
+    ...ctx.str("offset") ? { offset: integer(ctx, "offset", 0) } : {}
+  };
+}
+function memberGroupNameInput(ctx) {
+  const name = ctx.str("group-name");
+  if (!name.trim() || name.length > 80) {
+    throw new CliValidationError("--group-name must contain 1 to 80 characters and must not be blank.");
+  }
+  return { group_name: name };
+}
+function memberGroupChangeInput(ctx) {
+  const input = memberGroupInput(ctx);
+  let userIds;
+  try {
+    userIds = ctx.json("user-ids");
+  } catch {
+    throw new CliValidationError("--user-ids must be a JSON array of positive user IDs.");
+  }
+  if (!Array.isArray(userIds) || userIds.length === 0 || userIds.length > 1e3 || userIds.some((id) => !Number.isSafeInteger(id) || id < 1 || id > MAX_ID)) {
+    throw new CliValidationError("--user-ids must contain 1 to 1000 positive integer user IDs.");
+  }
+  return { ...input, user_ids: userIds, yes: true };
+}
+
+// src/commands/te-analysis/project/member-group/add-members.ts
+var projectMemberGroupAddMembers = createAnalysisCapabilityCommand({
+  resource: "project member-group",
+  command: "add-members",
+  capabilityId: "project.member_group.add_members",
+  description: "Add existing project members to a member group while preserving its other members and settings.",
+  helpText: "Group membership can grant access to shared assets. Discover user IDs with project member list and review --dry-run before confirming with --yes.",
+  flags: [memberGroupProjectIdFlag, memberGroupIdFlag, memberGroupUserIdsFlag],
+  risk: "high-risk-write",
+  buildInput: memberGroupChangeInput
+});
+
+// src/commands/te-analysis/project/member-group/create.ts
+var projectMemberGroupCreate = createAnalysisCapabilityCommand({
+  resource: "project member-group",
+  command: "create",
+  capabilityId: "project.member_group.create",
+  description: "Create an empty project member group without automatic enrollment of new project members.",
+  flags: [memberGroupProjectIdFlag, memberGroupNameFlag],
+  risk: "write",
+  buildInput: (ctx) => ({ ...memberGroupProjectInput(ctx), ...memberGroupNameInput(ctx) })
+});
+
+// src/commands/te-analysis/project/member-group/delete.ts
+var projectMemberGroupDelete = createAnalysisCapabilityCommand({
+  resource: "project member-group",
+  command: "delete",
+  capabilityId: "project.member_group.delete",
+  description: "Delete a project member group while retaining its company and project members.",
+  helpText: "Deleting a member group can revoke access to shared assets. Review --dry-run before confirming with --yes.",
+  flags: [memberGroupProjectIdFlag, memberGroupIdFlag],
+  risk: "high-risk-write",
+  buildInput: (ctx) => ({ ...memberGroupInput(ctx), yes: true })
+});
+
+// src/commands/te-analysis/project/member-group/list.ts
+var projectMemberGroupList = createAnalysisCapabilityCommand({
+  resource: "project member-group",
+  command: "list",
+  capabilityId: "project.member_group.list",
+  description: "List project member groups, their default-join settings, and member counts.",
+  flags: [memberGroupProjectIdFlag, ...memberGroupPaginationFlags],
+  risk: "read",
+  buildInput: (ctx) => ({ ...memberGroupProjectInput(ctx), ...memberGroupPaginationInput(ctx) })
+});
+
+// src/commands/te-analysis/project/member-group/members.ts
+var projectMemberGroupMembers = createAnalysisCapabilityCommand({
+  resource: "project member-group",
+  command: "members",
+  capabilityId: "project.member_group.members",
+  description: "List members of one project member group with pagination.",
+  flags: [memberGroupProjectIdFlag, memberGroupIdFlag, ...memberGroupPaginationFlags],
+  risk: "read",
+  buildInput: (ctx) => ({ ...memberGroupInput(ctx), ...memberGroupPaginationInput(ctx) })
+});
+
+// src/commands/te-analysis/project/member-group/remove-members.ts
+var projectMemberGroupRemoveMembers = createAnalysisCapabilityCommand({
+  resource: "project member-group",
+  command: "remove-members",
+  capabilityId: "project.member_group.remove_members",
+  description: "Remove selected members from a member group while preserving its other members and settings.",
+  helpText: "Group membership can grant access to shared assets. This removes group memberships only; project and company accounts are retained. Review --dry-run before confirming with --yes.",
+  flags: [memberGroupProjectIdFlag, memberGroupIdFlag, memberGroupUserIdsFlag],
+  risk: "high-risk-write",
+  buildInput: memberGroupChangeInput
+});
+
+// src/commands/te-analysis/project/member-group/rename.ts
+var projectMemberGroupRename = createAnalysisCapabilityCommand({
+  resource: "project member-group",
+  command: "rename",
+  capabilityId: "project.member_group.rename",
+  description: "Rename a project member group while preserving all members and default-join settings.",
+  flags: [memberGroupProjectIdFlag, memberGroupIdFlag, memberGroupNameFlag],
+  risk: "write",
+  buildInput: (ctx) => ({ ...memberGroupInput(ctx), ...memberGroupNameInput(ctx) })
+});
+
+// src/commands/te-analysis/project/member-group/index.ts
+var commands55 = [
+  projectMemberGroupAddMembers,
+  projectMemberGroupCreate,
+  projectMemberGroupDelete,
+  projectMemberGroupList,
+  projectMemberGroupMembers,
+  projectMemberGroupRemoveMembers,
+  projectMemberGroupRename
+];
+var member_group_default = commands55;
+
 // src/commands/te-analysis/project/member-handover/export.ts
 var projectMemberHandoverExport = createAnalysisCapabilityCommand({
   resource: "project member-handover",
@@ -8317,11 +8529,11 @@ var projectMemberHandoverRun = createAnalysisCapabilityCommand({
 });
 
 // src/commands/te-analysis/project/member-handover/index.ts
-var commands55 = [
+var commands56 = [
   projectMemberHandoverExport,
   projectMemberHandoverRun
 ];
-var member_handover_default = commands55;
+var member_handover_default = commands56;
 
 // src/commands/te-analysis/project/member-receiver/list.ts
 var projectMemberReceiverList = createAnalysisCapabilityCommand({
@@ -8339,10 +8551,10 @@ var projectMemberReceiverList = createAnalysisCapabilityCommand({
 });
 
 // src/commands/te-analysis/project/member-receiver/index.ts
-var commands56 = [
+var commands57 = [
   projectMemberReceiverList
 ];
-var member_receiver_default = commands56;
+var member_receiver_default = commands57;
 
 // src/commands/te-analysis/project/owner/update.ts
 var projectOwnerUpdate = createAnalysisCapabilityCommand({
@@ -8368,10 +8580,10 @@ var projectOwnerUpdate = createAnalysisCapabilityCommand({
 });
 
 // src/commands/te-analysis/project/owner/index.ts
-var commands57 = [
+var commands58 = [
   projectOwnerUpdate
 ];
-var owner_default = commands57;
+var owner_default = commands58;
 
 // src/commands/te-analysis/project/permission-binding/list.ts
 var projectPermissionBindingList = createAnalysisCapabilityCommand({
@@ -8393,10 +8605,10 @@ var projectPermissionBindingList = createAnalysisCapabilityCommand({
 });
 
 // src/commands/te-analysis/project/permission-binding/index.ts
-var commands58 = [
+var commands59 = [
   projectPermissionBindingList
 ];
-var permission_binding_default = commands58;
+var permission_binding_default = commands59;
 
 // src/commands/te-analysis/project/receive-status/update.ts
 var projectReceiveStatusUpdate = createAnalysisCapabilityCommand({
@@ -8417,10 +8629,10 @@ var projectReceiveStatusUpdate = createAnalysisCapabilityCommand({
 });
 
 // src/commands/te-analysis/project/receive-status/index.ts
-var commands59 = [
+var commands60 = [
   projectReceiveStatusUpdate
 ];
-var receive_status_default = commands59;
+var receive_status_default = commands60;
 
 // src/commands/te-analysis/project/role/delete.ts
 var projectRoleDelete = createAnalysisCapabilityCommand({
@@ -8512,13 +8724,13 @@ var projectRoleUpsert = createAnalysisCapabilityCommand({
 });
 
 // src/commands/te-analysis/project/role/index.ts
-var commands60 = [
+var commands61 = [
   projectRoleDelete,
   projectRoleGet,
   projectRoleList,
   projectRoleUpsert
 ];
-var role_default = commands60;
+var role_default = commands61;
 
 // src/commands/te-analysis/project/role-function/list.ts
 var projectRoleFunctionList = createAnalysisCapabilityCommand({
@@ -8544,10 +8756,10 @@ var projectRoleFunctionList = createAnalysisCapabilityCommand({
 });
 
 // src/commands/te-analysis/project/role-function/index.ts
-var commands61 = [
+var commands62 = [
   projectRoleFunctionList
 ];
-var role_function_default = commands61;
+var role_function_default = commands62;
 
 // src/commands/te-analysis/project/role-user/list.ts
 var projectRoleUserList = createAnalysisCapabilityCommand({
@@ -8567,10 +8779,10 @@ var projectRoleUserList = createAnalysisCapabilityCommand({
 });
 
 // src/commands/te-analysis/project/role-user/index.ts
-var commands62 = [
+var commands63 = [
   projectRoleUserList
 ];
-var role_user_default = commands62;
+var role_user_default = commands63;
 
 // src/commands/te-analysis/project/timezone/get.ts
 var projectTimezoneGet = createAnalysisCapabilityCommand({
@@ -8708,12 +8920,12 @@ function isObject(value) {
 }
 
 // src/commands/te-analysis/project/timezone/index.ts
-var commands63 = [
+var commands64 = [
   projectTimezoneGet,
   projectTimezoneOverview,
   projectTimezoneUpdate
 ];
-var timezone_default = commands63;
+var timezone_default = commands64;
 
 // src/commands/te-analysis/project/user-id-items/update.ts
 var projectUserIdItemsUpdate = createAnalysisCapabilityCommand({
@@ -8733,13 +8945,13 @@ var projectUserIdItemsUpdate = createAnalysisCapabilityCommand({
 });
 
 // src/commands/te-analysis/project/user-id-items/index.ts
-var commands64 = [
+var commands65 = [
   projectUserIdItemsUpdate
 ];
-var user_id_items_default = commands64;
+var user_id_items_default = commands65;
 
 // src/commands/te-analysis/project/index.ts
-var commands65 = [
+var commands66 = [
   ...access_detail_default,
   ...data_power_default,
   ...entity_default2,
@@ -8749,6 +8961,7 @@ var commands65 = [
   ...mark_time_default,
   ...member_default,
   ...member_candidate_default,
+  ...member_group_default,
   ...member_handover_default,
   ...member_receiver_default,
   ...owner_default,
@@ -8760,7 +8973,7 @@ var commands65 = [
   ...timezone_default,
   ...user_id_items_default
 ];
-var project_default = commands65;
+var project_default = commands66;
 
 // src/commands/te-analysis/tracking/shared.ts
 function createTrackingCapabilityCommand(config) {
@@ -9491,7 +9704,7 @@ function counts(plan, value) {
 }
 
 // src/commands/te-analysis/tracking/plan/index.ts
-var commands66 = [
+var commands67 = [
   trackingPlanGet,
   trackingPlanSaveItems,
   trackingPlanDeleteItems,
@@ -9501,7 +9714,7 @@ var commands66 = [
   trackingPlanSyncFromMeta,
   trackingPlanSyncDisplayNames
 ];
-var plan_default = commands66;
+var plan_default = commands67;
 
 // src/commands/te-analysis/tracking/sdk-sample/generate.ts
 var trackingSdkSampleGenerate = createTrackingCapabilityCommand({
@@ -9515,10 +9728,10 @@ var trackingSdkSampleGenerate = createTrackingCapabilityCommand({
 });
 
 // src/commands/te-analysis/tracking/sdk-sample/index.ts
-var commands67 = [
+var commands68 = [
   trackingSdkSampleGenerate
 ];
-var sdk_sample_default = commands67;
+var sdk_sample_default = commands68;
 
 // src/commands/te-analysis/tracking/plan-change-log/list.ts
 var trackingPlanChangeLogList = createTrackingCapabilityCommand({
@@ -9544,11 +9757,11 @@ var trackingPlanChangeLogExport = createTrackingCapabilityCommand({
 });
 
 // src/commands/te-analysis/tracking/plan-change-log/index.ts
-var commands68 = [
+var commands69 = [
   trackingPlanChangeLogList,
   trackingPlanChangeLogExport
 ];
-var plan_change_log_default = commands68;
+var plan_change_log_default = commands69;
 
 // src/commands/te-analysis/tracking/check/run.ts
 var trackingCheckRun = createTrackingCapabilityCommand({
@@ -9622,7 +9835,7 @@ var trackingCheckExport = createTrackingCapabilityCommand({
 });
 
 // src/commands/te-analysis/tracking/check/index.ts
-var commands69 = [
+var commands70 = [
   trackingCheckRun,
   trackingCheckList,
   trackingCheckGet,
@@ -9630,7 +9843,7 @@ var commands69 = [
   trackingCheckDelete,
   trackingCheckExport
 ];
-var check_default = commands69;
+var check_default = commands70;
 
 // src/commands/te-analysis/tracking/ingest/summary.ts
 var trackingIngestSummary = createTrackingCapabilityCommand({
@@ -9644,10 +9857,10 @@ var trackingIngestSummary = createTrackingCapabilityCommand({
 });
 
 // src/commands/te-analysis/tracking/ingest/index.ts
-var commands70 = [
+var commands71 = [
   trackingIngestSummary
 ];
-var ingest_default = commands70;
+var ingest_default = commands71;
 
 // src/commands/te-analysis/tracking/ingest-error/list.ts
 var trackingIngestErrorList = createTrackingCapabilityCommand({
@@ -9661,10 +9874,10 @@ var trackingIngestErrorList = createTrackingCapabilityCommand({
 });
 
 // src/commands/te-analysis/tracking/ingest-error/index.ts
-var commands71 = [
+var commands72 = [
   trackingIngestErrorList
 ];
-var ingest_error_default = commands71;
+var ingest_error_default = commands72;
 
 // src/commands/te-analysis/tracking/live-data/list.ts
 var trackingLiveDataList = createTrackingCapabilityCommand({
@@ -9690,11 +9903,11 @@ var trackingLiveDataExport = createTrackingCapabilityCommand({
 });
 
 // src/commands/te-analysis/tracking/live-data/index.ts
-var commands72 = [
+var commands73 = [
   trackingLiveDataList,
   trackingLiveDataExport
 ];
-var live_data_default = commands72;
+var live_data_default = commands73;
 
 // src/commands/te-analysis/tracking/event-blacklist/list.ts
 var trackingEventBlacklistList = createTrackingCapabilityCommand({
@@ -9730,12 +9943,12 @@ var trackingEventBlacklistUpdate = createTrackingCapabilityCommand({
 });
 
 // src/commands/te-analysis/tracking/event-blacklist/index.ts
-var commands73 = [
+var commands74 = [
   trackingEventBlacklistList,
   trackingEventBlacklistAdd,
   trackingEventBlacklistUpdate
 ];
-var event_blacklist_default = commands73;
+var event_blacklist_default = commands74;
 
 // src/commands/te-analysis/tracking/debug-device/add.ts
 var trackingDebugDeviceAdd = createTrackingCapabilityCommand({
@@ -9778,12 +9991,12 @@ var trackingDebugDeviceSelect = createTrackingCapabilityCommand({
 });
 
 // src/commands/te-analysis/tracking/debug-device/index.ts
-var commands74 = [
+var commands75 = [
   trackingDebugDeviceList,
   trackingDebugDeviceAdd,
   trackingDebugDeviceSelect
 ];
-var debug_device_default = commands74;
+var debug_device_default = commands75;
 
 // src/commands/te-analysis/tracking/debug-data/list.ts
 var debugStartTimeFlag = {
@@ -9842,11 +10055,11 @@ function isRecord3(value) {
 }
 
 // src/commands/te-analysis/tracking/debug-data/index.ts
-var commands75 = [trackingDebugDataList];
-var debug_data_default = commands75;
+var commands76 = [trackingDebugDataList];
+var debug_data_default = commands76;
 
 // src/commands/te-analysis/tracking/index.ts
-var commands76 = [
+var commands77 = [
   ...plan_default,
   ...sdk_sample_default,
   ...plan_change_log_default,
@@ -9858,7 +10071,7 @@ var commands76 = [
   ...debug_device_default,
   ...debug_data_default
 ];
-var tracking_default = commands76;
+var tracking_default = commands77;
 
 // src/commands/te-analysis/alert/shared.ts
 var alertIdFlag = {
@@ -9971,7 +10184,7 @@ var analysisAlertStop = createAnalysisCapabilityCommand({
 });
 
 // src/commands/te-analysis/alert/index.ts
-var commands77 = [
+var commands78 = [
   analysisAlertList,
   analysisAlertGet,
   analysisAlertCreate,
@@ -9980,7 +10193,7 @@ var commands77 = [
   analysisAlertStart,
   analysisAlertStop
 ];
-var alert_default = commands77;
+var alert_default = commands78;
 
 // src/commands/te-analysis/alert-detail/list.ts
 var analysisAlertDetailList = createAnalysisCapabilityCommand({
@@ -9994,10 +10207,10 @@ var analysisAlertDetailList = createAnalysisCapabilityCommand({
 });
 
 // src/commands/te-analysis/alert-detail/index.ts
-var commands78 = [
+var commands79 = [
   analysisAlertDetailList
 ];
-var alert_detail_default = commands78;
+var alert_detail_default = commands79;
 
 // src/commands/te-analysis/alert-job/list.ts
 var analysisAlertJobList = createAnalysisCapabilityCommand({
@@ -10011,10 +10224,10 @@ var analysisAlertJobList = createAnalysisCapabilityCommand({
 });
 
 // src/commands/te-analysis/alert-job/index.ts
-var commands79 = [
+var commands80 = [
   analysisAlertJobList
 ];
-var alert_job_default = commands79;
+var alert_job_default = commands80;
 
 // src/commands/te-analysis/alert-notice-config/list.ts
 var analysisAlertNoticeConfigList = createAnalysisCapabilityCommand({
@@ -10028,10 +10241,10 @@ var analysisAlertNoticeConfigList = createAnalysisCapabilityCommand({
 });
 
 // src/commands/te-analysis/alert-notice-config/index.ts
-var commands80 = [
+var commands81 = [
   analysisAlertNoticeConfigList
 ];
-var alert_notice_config_default = commands80;
+var alert_notice_config_default = commands81;
 
 // src/commands/te-analysis/system/shared.ts
 import { readFileSync as readFileSync3, statSync as statSync3 } from "fs";
@@ -11116,14 +11329,14 @@ var systemUsageCommands = [
 ];
 
 // src/commands/te-analysis/system/index.ts
-var commands81 = [
+var commands82 = [
   ...systemUsageCommands,
   ...systemIdentityCommands,
   ...systemSecurityCommands,
   ...systemMonitoringCommands,
   ...systemConfigurationCommands
 ];
-var system_default = commands81;
+var system_default = commands82;
 
 // src/commands/te-analysis/feedback/submit.ts
 import { createHash as createHash4, randomUUID as randomUUID2 } from "crypto";
@@ -11208,6 +11421,124 @@ var analysisFeedbackSubmit = createAnalysisCapabilityCommand({
 // src/commands/te-analysis/feedback/index.ts
 var feedback_default = [analysisFeedbackSubmit];
 
+// src/commands/te-analysis/scenario/index.ts
+function text2(value, field, max) {
+  if (typeof value !== "string" || !value.trim() || value.length > max) throw new CliValidationError(`${field} must be nonblank and at most ${max} characters.`);
+  return value;
+}
+function scenarioInput(ctx, append = false) {
+  const agent = readCliAgentContext();
+  const session = text2(agent.agent_session_id ?? "", "agent_session_id", 191);
+  const questionId = text2(ctx.str("question-id") || (!append ? agent.agent_turn_id ?? "" : ""), "question-id", 191);
+  const projectId = ctx.optionalNum("project-id");
+  if (projectId !== void 0 && (!Number.isInteger(projectId) || projectId <= 0)) throw new CliValidationError("project-id must be a positive integer.");
+  const input = {
+    agent_session_id: session,
+    question_id: questionId,
+    ...projectId !== void 0 ? { project_id: projectId } : {}
+  };
+  const entryType = append ? text2(ctx.str("entry-type"), "entry-type", 32) : "answer";
+  if (!["answer", "user_feedback", "answer_revision"].includes(entryType) || append && entryType === "answer") {
+    throw new CliValidationError("entry-type must be user_feedback or answer_revision.");
+  }
+  if (append) {
+    input.entry_type = entryType;
+    input.entry_id = text2(ctx.str("entry-id") || (agent.agent_turn_id ? `${agent.agent_turn_id}:${entryType}` : ""), "entry-id", 191);
+    input.target_answer_id = text2(ctx.str("target-answer-id"), "target-answer-id", 191);
+    input.text = text2(ctx.str("text"), "text", entryType === "user_feedback" ? 4096 : 16384);
+  } else {
+    input.question = text2(ctx.str("question"), "question", 8192);
+    input.answer = text2(ctx.str("answer"), "answer", 16384);
+  }
+  if (entryType !== "user_feedback") {
+    if (append && ctx.str("user-message")) input.user_message = text2(ctx.str("user-message"), "user-message", 4096);
+    input.answer_id = text2(ctx.str("answer-id") || (agent.agent_turn_id ? `answer:${agent.agent_turn_id}` : ""), "answer-id", 191);
+    if (input.answer_id === input.target_answer_id) throw new CliValidationError("A revision requires a new answer-id; target-answer-id must preserve the previous answer.");
+    const path = ctx.json("query-path");
+    if (!Array.isArray(path) || !path.length || path.length > 64) throw new CliValidationError("query-path must contain 1..64 ordered CLI call references.");
+    for (const step of path) {
+      if (!step || typeof step !== "object" || Array.isArray(step) || Object.keys(step).some((key) => !["capability_id", "invocation_id", "client_request_id", "purpose"].includes(key)) || typeof step.capability_id !== "string" || !/^[a-z][a-z0-9_]*\.[a-z][a-z0-9_]*\.[a-z][a-z0-9_]*$/.test(step.capability_id) || ["analysis.scenario.collect", "analysis.scenario.append", "analysis.feedback.submit"].includes(step.capability_id) || step.invocation_id === void 0 && step.client_request_id === void 0) {
+        throw new CliValidationError("Each query-path step requires a capability_id and an existing invocation_id or client_request_id; only optional purpose is accepted. Do not include query inputs or results.");
+      }
+      for (const key of ["invocation_id", "client_request_id"]) if (step[key] !== void 0) text2(step[key], key, 191);
+      if (step.purpose !== void 0) text2(step.purpose, "purpose", 256);
+    }
+    if (!path.some((step) => analysisQueryCapabilities.has(step.capability_id))) throw new CliValidationError("query-path must reference at least one attempted analysis data query.");
+    if (JSON.stringify(path).length > 2e4) throw new CliValidationError("query-path must be at most 20000 characters.");
+    input.query_path = path;
+  } else if (ctx.json("query-path") !== void 0 || ctx.str("answer-id") || ctx.str("user-message")) {
+    throw new CliValidationError("user_feedback records user text and its target only; do not attach an answer or query path.");
+  }
+  return input;
+}
+var commonFlags2 = [
+  { name: "question-id", type: "string", desc: "Stable original scenario turn ID. Collect defaults to current turn; append must reuse the original ID." },
+  { name: "answer-id", type: "string", desc: "Actual answer identifier; defaults to answer:<current-turn-id>. Revisions need a new ID." },
+  { name: "query-path", type: "json", desc: "1..64 ordered references: [{capability_id,invocation_id?,client_request_id?,purpose?}]. Prefer only returned meta.invocation_id; fallback to returned gateway meta.client_request_id, never business request_id. One analysis data-query step required. Inputs/status/timing come from existing call telemetry. Never include query results." },
+  { name: "project-id", type: "number", desc: "Source analysis project. Collection is skipped if omitted or the project has not explicitly enabled scenario samples." }
+];
+function withProjectCollectionPolicy(command) {
+  return {
+    ...command,
+    execute: async (ctx) => {
+      const input = scenarioInput(ctx, command.command === "append");
+      const skipped = (reason) => withOutputMetadata({
+        accepted: false,
+        skipped: true,
+        reason,
+        question_id: input.question_id,
+        ...input.answer_id ? { answer_id: input.answer_id } : {},
+        ...input.entry_id ? { entry_id: input.entry_id } : {},
+        ...input.target_answer_id ? { target_answer_id: input.target_answer_id } : {},
+        event_name: command.command === "append" ? "cli_analysis_scenario_entry" : "cli_analysis_scenario",
+        delivery: "best_effort"
+      }, { capability_id: command.capabilityId });
+      if (input.project_id === void 0) return skipped("PROJECT_REQUIRED");
+      try {
+        const policy = await executeCapabilityWithEnvelope(ctx.host(), "analysis", "project.info.get", {
+          project_id: input.project_id
+        });
+        if (policy.data?.analysis_scenario_collection_enabled !== true) {
+          return skipped("PROJECT_COLLECTION_DISABLED");
+        }
+      } catch {
+        return skipped("PROJECT_COLLECTION_CONFIG_UNAVAILABLE");
+      }
+      return command.execute(ctx);
+    }
+  };
+}
+var scenarioCollect = withProjectCollectionPolicy(createAnalysisCapabilityCommand({
+  resource: "scenario",
+  command: "collect",
+  capabilityId: "analysis.scenario.collect",
+  risk: "write",
+  description: "Collect one whole scenario question, exact final answer and ordered CLI call references. Multiple CLI calls belong to one question_id. No self-evaluation.",
+  flags: [
+    ...commonFlags2,
+    { name: "question", type: "string", required: true, sensitive: true, desc: "Original user scenario question and confirmed clarifications; up to 8192 characters." },
+    { name: "answer", type: "string", required: true, sensitive: true, desc: "Exact answer text to deliver, not a summary. Up to 16384 characters. Deliver the same text after collection." }
+  ],
+  buildInput: (ctx) => scenarioInput(ctx)
+}));
+var scenarioAppend = withProjectCollectionPolicy(createAnalysisCapabilityCommand({
+  resource: "scenario",
+  command: "append",
+  capabilityId: "analysis.scenario.append",
+  risk: "write",
+  description: "Append verbatim user feedback or the exact substantive follow-up answer, including a recheck with unchanged conclusions, preserving earlier answers. This is not a new scenario.",
+  flags: [
+    ...commonFlags2,
+    { name: "entry-type", type: "string", required: true, desc: "user_feedback or answer_revision." },
+    { name: "target-answer-id", type: "string", required: true, desc: "Existing answer being questioned or revised. Never overwrite it." },
+    { name: "text", type: "string", required: true, sensitive: true, desc: "Verbatim user feedback (up to 4096) or exact revised answer (up to 16384); no judgment of whether feedback is right." },
+    { name: "entry-id", type: "string", desc: "Stable append ID; defaults to current-turn-id:entry-type. Preserve on retries, independent of text edits." },
+    { name: "user-message", type: "string", sensitive: true, desc: "For answer_revision only: exact triggering follow-up request, up to 4096 characters, when not already captured as user_feedback. Preserve scope changes without inventing negative feedback." }
+  ],
+  buildInput: (ctx) => scenarioInput(ctx, true)
+}));
+var scenario_default = [scenarioCollect, scenarioAppend];
+
 // src/commands/te-analysis/index.ts
 registerCapabilityGatewayRoute("analysis", { gatewayDomain: "analysis" });
 registerCapabilityGatewayRoute("project", { gatewayDomain: "analysis" });
@@ -11255,10 +11586,11 @@ var baseCommands = [
   ...alert_job_default,
   ...alert_notice_config_default,
   ...system_default,
-  ...feedback_default
+  ...feedback_default,
+  ...scenario_default
 ];
-var commands82 = [...baseCommands];
-var te_analysis_default = commands82;
+var commands83 = [...baseCommands];
+var te_analysis_default = commands83;
 export {
   baseCommands,
   te_analysis_default as default