@thinkingai/ae-cli 6.1.27 → 6.1.29

package/dist/{te-analysis-GP7DSQ7Q.js → te-analysis-USIK6ZZG.js}

@@ -7,12 +7,19 @@ import {
   waitForAnalysisRun,
   withAsyncArtifactLifecycle,
   withInterruptSignal
-} from "./chunk-AQJPNWZF.js";
+} from "./chunk-PWXDWMCW.js";
 import {
   createCapabilityCommand,
   definitionIntentSnapshotFlag,
   modelDefinitionIntentSnapshotFlag
-} from "./chunk-MWIA43UJ.js";
+} from "./chunk-VCZE3IWO.js";
+import {
+  registerCapabilityGatewayRoute,
+  resolveGatewayDomain
+} from "./chunk-KPQY44JQ.js";
+import {
+  withOutputMetadata
+} from "./chunk-QZLRHGVH.js";
 import {
   CapabilityGatewayError,
   buildCapabilityGatewayUrl,
@@ -26,22 +33,16 @@ import {
   uploadInputFile,
   validateCapability,
   validateCapabilityWithEnvelope
-} from "./chunk-VZZNLV3I.js";
-import {
-  registerCapabilityGatewayRoute,
-  resolveGatewayDomain
-} from "./chunk-KPQY44JQ.js";
-import {
-  withOutputMetadata
-} from "./chunk-6VNIR4AP.js";
+} from "./chunk-3SDHJOCR.js";
 import "./chunk-Y74WTIKJ.js";
+import "./chunk-2UW3Y463.js";
 import {
   getCliToken
-} from "./chunk-GHXZK54S.js";
-import "./chunk-ZL7SGNIA.js";
+} from "./chunk-H3K5UGYC.js";
+import "./chunk-JNVVJ273.js";
 import {
   CliValidationError
-} from "./chunk-WNGFSIOB.js";
+} from "./chunk-Z3Q2AEIN.js";
 
 // src/commands/te-analysis/capability-shared.ts
 var ANALYSIS_GATEWAY_CLI_SERVICES = /* @__PURE__ */ new Set(["project", "system"]);
@@ -229,7 +230,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 +1648,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 = {
@@ -2120,6 +2121,33 @@ var metadataCatalogList = createAnalysisMetaCapabilityCommand({
 var commands10 = [metadataCatalogList, metadataCatalogExport];
 var catalog_default = commands10;
 
+// src/commands/te-analysis/meta/governance-recommendation/run-update.ts
+var metadataGovernanceRecommendationRunUpdate = createAnalysisMetaCapabilityCommand({
+  resource: "governance-recommendation",
+  command: "run-update",
+  capabilityId: "metadata.governance_recommendation.run_update",
+  description: "Renew or finish your tracked recommendation workflow; it does not cancel Agent execution.",
+  risk: "write",
+  flags: [
+    projectIdFlag,
+    { name: "run-id", type: "string", required: true, desc: "Exact run_id returned by the tracked export." },
+    { name: "status", type: "string", required: true, desc: "HEARTBEAT, SUCCEEDED, FAILED or CANCELLED. Finish only after the actual workflow has ended." },
+    { name: "reason", type: "string", required: false, desc: "Short non-sensitive result or failure reason; never include credentials or raw logs." }
+  ],
+  buildInput: (ctx) => {
+    const status = ctx.str("status");
+    if (!["HEARTBEAT", "SUCCEEDED", "FAILED", "CANCELLED"].includes(status)) {
+      throw new Error("--status must be HEARTBEAT, SUCCEEDED, FAILED or CANCELLED.");
+    }
+    return {
+      ...projectInput(ctx),
+      run_id: ctx.str("run-id"),
+      status,
+      ...ctx.str("reason") ? { reason: ctx.str("reason") } : {}
+    };
+  }
+});
+
 // src/commands/te-analysis/meta/governance-recommendation/export.ts
 var windowDaysFlag = {
   name: "window-days",
@@ -2154,7 +2182,9 @@ var GOVERNANCE_RECOMMENDATION_EXPORT_HELP = [
   "- The Agent turns that package into a submit-to-page draft with batch ai_summary, presentation_snapshot, per-item ai_summary/reasons, copied evidence_snapshot, copied source links, and relations.",
   "- work_units are deterministic evidence containers from Common. They are not final page groups; the Agent clusters selected assets into one or more business-domain topics.",
   "- For report and SQL items, use packaged evidence_snapshot.analysis first. Call analysis-meta agent-review evidence only for explicit definition/analysis gaps or draft validation.",
-  "- For real page-review submission, start with --limit 20, filter out completed/rejected/deferred/in-flight items, and expand to --limit 50 then --limit 100 only when the remaining pending review assets or visible business domains are too few.",
+  "- Ordinary recommendations need concise reasons, a core evidence-backed report measure/calculation, business-domain/subtopic grouping, and a focused page-material review. Full definition audits, per-item comparisons and exhaustive SQL explanations are not the default; use them only for explicit audit intent or affected risk items.",
+  "- For real page-review submission, start with --limit 20, select currently uncertified assets by business value and evidence, and expand to --limit 50 then --limit 100 only when the remaining pending review assets or visible business domains are too few.",
+  "- Do not query review history to select candidates. Previously recommended, pending, rejected, or deferred proposals do not exclude a currently uncertified asset from manual recommendation.",
   "- Expansion increases business-domain coverage; it must not submit every pending asset found. Keep a daily review capacity target such as 20-50 pending assets, hard cap around 80, and select about 3-6 visible domains.",
   "- When candidates exceed the cap, rank by impact, heat, user count, dependency breadth, and under-covered domains; keep only direct context needed for selected pending assets and report overflow for later batches.",
   "- Draft only business domains with pending review assets. Completed/authenticated assets are necessary context under those visible domains, not standalone work and not a reason to display a zero-pending domain.",
@@ -2167,14 +2197,28 @@ var metadataGovernanceRecommendationExport = createAnalysisMetaCapabilityCommand
   capabilityId: "metadata.governance_recommendation.export",
   description: "Export the material package for CLI Agent asset-authentication and metric-recommendation review.",
   helpText: GOVERNANCE_RECOMMENDATION_EXPORT_HELP,
-  flags: [projectIdFlag, windowDaysFlag, limitFlag2, includeCompletedFlag],
+  flags: [
+    projectIdFlag,
+    windowDaysFlag,
+    limitFlag2,
+    includeCompletedFlag,
+    { name: "track-run", type: "boolean", required: false, desc: "Track the complete recommendation workflow through page submission or explicit run-update. Default: false for compatibility." },
+    { name: "run-id", type: "string", required: false, desc: "Continue the same tracked workflow when expanding evidence. Requires --track-run true." }
+  ],
   risk: "read",
-  buildInput: (ctx) => compactInput({
-    ...projectInput(ctx),
-    window_days: optionalNumber(ctx, "window-days"),
-    limit: optionalNumber(ctx, "limit"),
-    include_completed: optionalBoolean(ctx, "include-completed")
-  }),
+  buildInput: (ctx) => {
+    if (ctx.str("run-id") && optionalBoolean(ctx, "track-run") !== true) {
+      throw new Error("--run-id requires --track-run true.");
+    }
+    return compactInput({
+      ...projectInput(ctx),
+      window_days: optionalNumber(ctx, "window-days"),
+      limit: optionalNumber(ctx, "limit"),
+      include_completed: optionalBoolean(ctx, "include-completed"),
+      track_run: optionalBoolean(ctx, "track-run"),
+      run_id: ctx.str("run-id") || void 0
+    });
+  },
   postProcess: (result, _input, ctx) => {
     normalizeResourceUrlFields(result, resolvePublicWebHost(ctx.host()), ctx.host());
     return result;
@@ -3003,6 +3047,7 @@ var metadataGovernanceRecommendationDecisions = createAnalysisMetaCapabilityComm
 
 // src/commands/te-analysis/meta/governance-recommendation/index.ts
 var commands11 = [
+  metadataGovernanceRecommendationRunUpdate,
   metadataGovernanceRecommendationExport,
   metadataGovernanceRecommendationSubmit,
   metadataGovernanceRecommendationAutoReview,
@@ -3089,22 +3134,26 @@ var SUBMIT_TO_PAGE_HELP = [
   "- This command creates an asset certification review draft for humans. It never approves, certifies, retries, or creates metrics.",
   "- Use --input-file for real drafts. The file is JSON; --project-id and --client-request-id come from CLI flags so replays keep one stable operation key.",
   "- Build the file from review_material_package, preserving candidate assets, heat evidence, source_link/evidence_links, relations, report/AI-model definitions, target_revision, and hashes.",
-  "- For dashboard items, preserve optional space_id/space_name from the material package into evidence_snapshot.definition.config when present. Not every dashboard has a space; do not invent or require one.",
+  "- For dashboard items, preserve optional space_id/space_name only from the authoritative packaged evidence_snapshot.definition.config, together with target_revision. Never synthesize or patch definition from space display facts. For older exports missing dashboard definition/revision, fetch analysis-meta agent-review evidence first. Not every dashboard has a space; do not invent or require one.",
   "- For recurring recommendation jobs, build the draft from the latest sufficient export: start at top-20 hot dashboards, expand to top-50/top-100 only when filtering leaves too few pending review assets or visible business domains, and record the final scope in batch ai_summary.",
+  "- Do not query review history to select candidates. Select currently uncertified assets by business value and evidence, regardless of earlier recommendations or review decisions. Submission creates human review material only.",
   "- Expansion is for coverage, not unlimited workload. Target about 20-50 pending assets per daily batch, cap around 80, and balance roughly 3-6 visible domains with per-domain quotas before adding context.",
   "- If more pending candidates exist, submit the ranked slice and record overflow counts/domains in batch ai_summary for later batches.",
   "- presentation_snapshot should display only business-domain topics that contain pending review assets. Authenticated/completed assets may appear as context under those topics, but must not create standalone zero-pending topics.",
   "- Do not author long page-visible AI summaries for hidden topics or pure authenticated context. Copy evidence, links, signals, and relations for context; spend Agent interpretation on visible domains and pending review assets.",
   "- 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.",
+  "- Ordinary recommendations use concise item reasons and core report meaning. Follow agent_review_preflight.md for one focused independent review of every business topic/subtopic and identified risks, plus whole-packet programmatic evidence checks. Do not repeat a full definition audit or polish copy through routine correction rounds. Full audits require explicit audit intent; LOCAL_ONLY never submits.",
+  "- Priorities are optional for ordinary recommendations. Load agent_review_priorities_comparisons.md only for a priority request, concrete comparison/conflict clues, or a full audit. Do not require comparisons or comparison_review for unexamined ordinary items; absence never proves no conflict. Supplied comparisons retain both-side evidence and classification; only POSSIBLE_CONFLICT merits a conflict badge.",
+  "- Each new topic and second-level business subtopic must include semantic_basis with business_question, grouping_reason, and evidence_item_ids from that topic or group respectively. These are Agent-authored interpretations; legacy packets without these optional fields remain accepted.",
+  "- Follow the Business Topics and Subtopics contract in agent_review_submit_to_page.md: business domain -> business subtopic -> dashboards -> reports -> metadata. Group dashboards answering the same subtopic question together; never create one group per source dashboard by iteration or just rename those groups. Single-dashboard groups need a definition-based reason, not a minimum-count workaround.",
   "- 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.",
   "- item.ai_summary.summary is the per-item recommendation reason. It must cite concrete item evidence, not generic review boilerplate. batch ai_summary.summary is only the batch overview.",
   "- When submitting manual_review_handoff leftovers, copy manual_review_handoff.auto_review_trace into source_metadata.auto_review_trace so page audit records include the assets already certified automatically.",
-  "- For reports and SQL reports, item.ai_summary.analysis_explanation must explain reviewer-readable calculations or measures from packaged evidence_snapshot.analysis. A purpose-only summary is incomplete and is rejected locally before dispatch.",
-  "- Reviewer-visible text should follow the project-KB source style: one business Chinese Agent summary that explains purpose, calculation caliber, filters, time scope, boundaries, and concrete reviewer questions. Keep raw SQL, parser labels, temporary aliases, parameter placeholders, hashes, and evidence paths in evidence_snapshot only; independent Agent preflight flags visible implementation terms as quality findings.",
+  "- For ordinary reports, one concise, factual core measure or calculation with resolvable evidence_snapshot.analysis refs is sufficient. Preserve packaged analysis and target_revision; do not require exhaustive SQL projection explanations. A purpose-only summary is incomplete and is rejected locally before dispatch.",
+  "- Write concise business Chinese describing purpose, recommendation basis, core meaning and known material risks; metadata dependencies need only their role and specific risks. Keep raw SQL and implementation details in evidence_snapshot. Complete field-by-field explanations remain available for explicitly requested full audits.",
+  "- Run local structure/evidence checks once, then submit once and read detail once. Remote --validate or --dry-run remains available for uncertain inputs or new contracts, not a routine extra step. Authorization, source links, identity, and core report evidence checks remain enforced.",
   "- The command output includes review_page_url when review_url is present. Return review_page_url to the user; do not prepend the Common/API host to review_url yourself.",
   "",
   "Input-file JSON shape:",
@@ -3124,8 +3173,9 @@ var SUBMIT_TO_PAGE_HELP = [
   '      "name": "<business-domain-name>",',
   '      "groups": [{',
   '        "id": "<second-level-group-id>",',
-  '        "name": "<second-level group or source dashboard>",',
-  '        "items": [{ "id": "<client_item_id>" }]',
+  '        "name": "<business-subtopic-name>",',
+  '        "semantic_basis": { "business_question": "<specific business question>", "grouping_reason": "<shared meaning and boundary from sibling subtopics>", "evidence_item_ids": ["<supporting item id in this group>"] },',
+  '        "items": [{ "id": "<dashboard item id>" }, { "id": "<another related dashboard item id>" }, { "id": "<report item id>" }]',
   "      }]",
   "    }],",
   '    "relations": [{ "parent": "<dashboard item id>", "child": "<report item id>", "type": "contains" }, { "parent": "<report item id>", "child": "<metadata item id>", "type": "uses" }],',
@@ -3332,11 +3382,13 @@ 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.");
     }
     for (const groupValue of array2(topic.groups, "presentation_snapshot.topics[].groups")) {
       const group = object(groupValue, "presentation_snapshot.topics[].groups[]");
+      const groupItemIds = /* @__PURE__ */ new Set();
       if (typeof group.id !== "string" || !group.id.trim() || typeof group.name !== "string" || !group.name.trim()) {
         throw new Error("presentation_snapshot.topics[].groups[] requires nonempty string id and name.");
       }
@@ -3349,6 +3401,32 @@ function validatePresentation(presentation, itemIds) {
           throw new Error("presentation_snapshot references an unknown client_item_id.");
         }
         displayed.add(item.id);
+        topicItemIds.add(item.id);
+        groupItemIds.add(item.id);
+      }
+      if (group.semantic_basis !== void 0) {
+        const basis = object(group.semantic_basis, "presentation_snapshot.topics[].groups[].semantic_basis");
+        for (const field of ["business_question", "grouping_reason"]) {
+          if (typeof basis[field] !== "string" || !basis[field].trim()) {
+            throw new Error(`group.semantic_basis.${field} must explain the business meaning of this subtopic.`);
+          }
+        }
+        const references = array2(basis.evidence_item_ids, "group.semantic_basis.evidence_item_ids");
+        if (!references.length || references.some((id) => typeof id !== "string" || !groupItemIds.has(id))) {
+          throw new Error("group.semantic_basis.evidence_item_ids must reference items displayed in the same group.");
+        }
+      }
+    }
+    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.");
       }
     }
   }
@@ -4990,11 +5068,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) => ({
@@ -5009,11 +5087,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." }
@@ -5023,8 +5105,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.");
@@ -5033,16 +5142,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
@@ -8327,6 +8443,165 @@ var commands55 = [
 ];
 var member_candidate_default = commands55;
 
+// 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 commands56 = [
+  projectMemberGroupAddMembers,
+  projectMemberGroupCreate,
+  projectMemberGroupDelete,
+  projectMemberGroupList,
+  projectMemberGroupMembers,
+  projectMemberGroupRemoveMembers,
+  projectMemberGroupRename
+];
+var member_group_default = commands56;
+
 // src/commands/te-analysis/project/member-handover/export.ts
 var projectMemberHandoverExport = createAnalysisCapabilityCommand({
   resource: "project member-handover",
@@ -8366,11 +8641,11 @@ var projectMemberHandoverRun = createAnalysisCapabilityCommand({
 });
 
 // src/commands/te-analysis/project/member-handover/index.ts
-var commands56 = [
+var commands57 = [
   projectMemberHandoverExport,
   projectMemberHandoverRun
 ];
-var member_handover_default = commands56;
+var member_handover_default = commands57;
 
 // src/commands/te-analysis/project/member-receiver/list.ts
 var projectMemberReceiverList = createAnalysisCapabilityCommand({
@@ -8388,10 +8663,10 @@ var projectMemberReceiverList = createAnalysisCapabilityCommand({
 });
 
 // src/commands/te-analysis/project/member-receiver/index.ts
-var commands57 = [
+var commands58 = [
   projectMemberReceiverList
 ];
-var member_receiver_default = commands57;
+var member_receiver_default = commands58;
 
 // src/commands/te-analysis/project/owner/update.ts
 var projectOwnerUpdate = createAnalysisCapabilityCommand({
@@ -8417,10 +8692,10 @@ var projectOwnerUpdate = createAnalysisCapabilityCommand({
 });
 
 // src/commands/te-analysis/project/owner/index.ts
-var commands58 = [
+var commands59 = [
   projectOwnerUpdate
 ];
-var owner_default = commands58;
+var owner_default = commands59;
 
 // src/commands/te-analysis/project/permission-binding/list.ts
 var projectPermissionBindingList = createAnalysisCapabilityCommand({
@@ -8442,10 +8717,10 @@ var projectPermissionBindingList = createAnalysisCapabilityCommand({
 });
 
 // src/commands/te-analysis/project/permission-binding/index.ts
-var commands59 = [
+var commands60 = [
   projectPermissionBindingList
 ];
-var permission_binding_default = commands59;
+var permission_binding_default = commands60;
 
 // src/commands/te-analysis/project/receive-status/update.ts
 var projectReceiveStatusUpdate = createAnalysisCapabilityCommand({
@@ -8466,10 +8741,10 @@ var projectReceiveStatusUpdate = createAnalysisCapabilityCommand({
 });
 
 // src/commands/te-analysis/project/receive-status/index.ts
-var commands60 = [
+var commands61 = [
   projectReceiveStatusUpdate
 ];
-var receive_status_default = commands60;
+var receive_status_default = commands61;
 
 // src/commands/te-analysis/project/role/delete.ts
 var projectRoleDelete = createAnalysisCapabilityCommand({
@@ -8561,13 +8836,13 @@ var projectRoleUpsert = createAnalysisCapabilityCommand({
 });
 
 // src/commands/te-analysis/project/role/index.ts
-var commands61 = [
+var commands62 = [
   projectRoleDelete,
   projectRoleGet,
   projectRoleList,
   projectRoleUpsert
 ];
-var role_default = commands61;
+var role_default = commands62;
 
 // src/commands/te-analysis/project/role-function/list.ts
 var projectRoleFunctionList = createAnalysisCapabilityCommand({
@@ -8593,10 +8868,10 @@ var projectRoleFunctionList = createAnalysisCapabilityCommand({
 });
 
 // src/commands/te-analysis/project/role-function/index.ts
-var commands62 = [
+var commands63 = [
   projectRoleFunctionList
 ];
-var role_function_default = commands62;
+var role_function_default = commands63;
 
 // src/commands/te-analysis/project/role-user/list.ts
 var projectRoleUserList = createAnalysisCapabilityCommand({
@@ -8616,10 +8891,10 @@ var projectRoleUserList = createAnalysisCapabilityCommand({
 });
 
 // src/commands/te-analysis/project/role-user/index.ts
-var commands63 = [
+var commands64 = [
   projectRoleUserList
 ];
-var role_user_default = commands63;
+var role_user_default = commands64;
 
 // src/commands/te-analysis/project/timezone/get.ts
 var projectTimezoneGet = createAnalysisCapabilityCommand({
@@ -8757,12 +9032,12 @@ function isObject(value) {
 }
 
 // src/commands/te-analysis/project/timezone/index.ts
-var commands64 = [
+var commands65 = [
   projectTimezoneGet,
   projectTimezoneOverview,
   projectTimezoneUpdate
 ];
-var timezone_default = commands64;
+var timezone_default = commands65;
 
 // src/commands/te-analysis/project/user-id-items/update.ts
 var projectUserIdItemsUpdate = createAnalysisCapabilityCommand({
@@ -8782,13 +9057,13 @@ var projectUserIdItemsUpdate = createAnalysisCapabilityCommand({
 });
 
 // src/commands/te-analysis/project/user-id-items/index.ts
-var commands65 = [
+var commands66 = [
   projectUserIdItemsUpdate
 ];
-var user_id_items_default = commands65;
+var user_id_items_default = commands66;
 
 // src/commands/te-analysis/project/index.ts
-var commands66 = [
+var commands67 = [
   ...access_detail_default,
   ...data_power_default,
   ...entity_default2,
@@ -8798,6 +9073,7 @@ var commands66 = [
   ...mark_time_default,
   ...member_default,
   ...member_candidate_default,
+  ...member_group_default,
   ...member_handover_default,
   ...member_receiver_default,
   ...owner_default,
@@ -8809,7 +9085,7 @@ var commands66 = [
   ...timezone_default,
   ...user_id_items_default
 ];
-var project_default = commands66;
+var project_default = commands67;
 
 // src/commands/te-analysis/tracking/shared.ts
 function createTrackingCapabilityCommand(config) {
@@ -9540,7 +9816,7 @@ function counts(plan, value) {
 }
 
 // src/commands/te-analysis/tracking/plan/index.ts
-var commands67 = [
+var commands68 = [
   trackingPlanGet,
   trackingPlanSaveItems,
   trackingPlanDeleteItems,
@@ -9550,7 +9826,7 @@ var commands67 = [
   trackingPlanSyncFromMeta,
   trackingPlanSyncDisplayNames
 ];
-var plan_default = commands67;
+var plan_default = commands68;
 
 // src/commands/te-analysis/tracking/sdk-sample/generate.ts
 var trackingSdkSampleGenerate = createTrackingCapabilityCommand({
@@ -9564,10 +9840,10 @@ var trackingSdkSampleGenerate = createTrackingCapabilityCommand({
 });
 
 // src/commands/te-analysis/tracking/sdk-sample/index.ts
-var commands68 = [
+var commands69 = [
   trackingSdkSampleGenerate
 ];
-var sdk_sample_default = commands68;
+var sdk_sample_default = commands69;
 
 // src/commands/te-analysis/tracking/plan-change-log/list.ts
 var trackingPlanChangeLogList = createTrackingCapabilityCommand({
@@ -9593,11 +9869,11 @@ var trackingPlanChangeLogExport = createTrackingCapabilityCommand({
 });
 
 // src/commands/te-analysis/tracking/plan-change-log/index.ts
-var commands69 = [
+var commands70 = [
   trackingPlanChangeLogList,
   trackingPlanChangeLogExport
 ];
-var plan_change_log_default = commands69;
+var plan_change_log_default = commands70;
 
 // src/commands/te-analysis/tracking/check/run.ts
 var trackingCheckRun = createTrackingCapabilityCommand({
@@ -9671,7 +9947,7 @@ var trackingCheckExport = createTrackingCapabilityCommand({
 });
 
 // src/commands/te-analysis/tracking/check/index.ts
-var commands70 = [
+var commands71 = [
   trackingCheckRun,
   trackingCheckList,
   trackingCheckGet,
@@ -9679,7 +9955,7 @@ var commands70 = [
   trackingCheckDelete,
   trackingCheckExport
 ];
-var check_default = commands70;
+var check_default = commands71;
 
 // src/commands/te-analysis/tracking/ingest/summary.ts
 var trackingIngestSummary = createTrackingCapabilityCommand({
@@ -9693,10 +9969,10 @@ var trackingIngestSummary = createTrackingCapabilityCommand({
 });
 
 // src/commands/te-analysis/tracking/ingest/index.ts
-var commands71 = [
+var commands72 = [
   trackingIngestSummary
 ];
-var ingest_default = commands71;
+var ingest_default = commands72;
 
 // src/commands/te-analysis/tracking/ingest-error/list.ts
 var trackingIngestErrorList = createTrackingCapabilityCommand({
@@ -9710,10 +9986,10 @@ var trackingIngestErrorList = createTrackingCapabilityCommand({
 });
 
 // src/commands/te-analysis/tracking/ingest-error/index.ts
-var commands72 = [
+var commands73 = [
   trackingIngestErrorList
 ];
-var ingest_error_default = commands72;
+var ingest_error_default = commands73;
 
 // src/commands/te-analysis/tracking/live-data/list.ts
 var trackingLiveDataList = createTrackingCapabilityCommand({
@@ -9739,11 +10015,11 @@ var trackingLiveDataExport = createTrackingCapabilityCommand({
 });
 
 // src/commands/te-analysis/tracking/live-data/index.ts
-var commands73 = [
+var commands74 = [
   trackingLiveDataList,
   trackingLiveDataExport
 ];
-var live_data_default = commands73;
+var live_data_default = commands74;
 
 // src/commands/te-analysis/tracking/event-blacklist/list.ts
 var trackingEventBlacklistList = createTrackingCapabilityCommand({
@@ -9779,12 +10055,12 @@ var trackingEventBlacklistUpdate = createTrackingCapabilityCommand({
 });
 
 // src/commands/te-analysis/tracking/event-blacklist/index.ts
-var commands74 = [
+var commands75 = [
   trackingEventBlacklistList,
   trackingEventBlacklistAdd,
   trackingEventBlacklistUpdate
 ];
-var event_blacklist_default = commands74;
+var event_blacklist_default = commands75;
 
 // src/commands/te-analysis/tracking/debug-device/add.ts
 var trackingDebugDeviceAdd = createTrackingCapabilityCommand({
@@ -9827,12 +10103,12 @@ var trackingDebugDeviceSelect = createTrackingCapabilityCommand({
 });
 
 // src/commands/te-analysis/tracking/debug-device/index.ts
-var commands75 = [
+var commands76 = [
   trackingDebugDeviceList,
   trackingDebugDeviceAdd,
   trackingDebugDeviceSelect
 ];
-var debug_device_default = commands75;
+var debug_device_default = commands76;
 
 // src/commands/te-analysis/tracking/debug-data/list.ts
 var debugStartTimeFlag = {
@@ -9891,11 +10167,11 @@ function isRecord3(value) {
 }
 
 // src/commands/te-analysis/tracking/debug-data/index.ts
-var commands76 = [trackingDebugDataList];
-var debug_data_default = commands76;
+var commands77 = [trackingDebugDataList];
+var debug_data_default = commands77;
 
 // src/commands/te-analysis/tracking/index.ts
-var commands77 = [
+var commands78 = [
   ...plan_default,
   ...sdk_sample_default,
   ...plan_change_log_default,
@@ -9907,7 +10183,7 @@ var commands77 = [
   ...debug_device_default,
   ...debug_data_default
 ];
-var tracking_default = commands77;
+var tracking_default = commands78;
 
 // src/commands/te-analysis/alert/shared.ts
 var alertIdFlag = {
@@ -10020,7 +10296,7 @@ var analysisAlertStop = createAnalysisCapabilityCommand({
 });
 
 // src/commands/te-analysis/alert/index.ts
-var commands78 = [
+var commands79 = [
   analysisAlertList,
   analysisAlertGet,
   analysisAlertCreate,
@@ -10029,7 +10305,7 @@ var commands78 = [
   analysisAlertStart,
   analysisAlertStop
 ];
-var alert_default = commands78;
+var alert_default = commands79;
 
 // src/commands/te-analysis/alert-detail/list.ts
 var analysisAlertDetailList = createAnalysisCapabilityCommand({
@@ -10043,10 +10319,10 @@ var analysisAlertDetailList = createAnalysisCapabilityCommand({
 });
 
 // src/commands/te-analysis/alert-detail/index.ts
-var commands79 = [
+var commands80 = [
   analysisAlertDetailList
 ];
-var alert_detail_default = commands79;
+var alert_detail_default = commands80;
 
 // src/commands/te-analysis/alert-job/list.ts
 var analysisAlertJobList = createAnalysisCapabilityCommand({
@@ -10060,10 +10336,10 @@ var analysisAlertJobList = createAnalysisCapabilityCommand({
 });
 
 // src/commands/te-analysis/alert-job/index.ts
-var commands80 = [
+var commands81 = [
   analysisAlertJobList
 ];
-var alert_job_default = commands80;
+var alert_job_default = commands81;
 
 // src/commands/te-analysis/alert-notice-config/list.ts
 var analysisAlertNoticeConfigList = createAnalysisCapabilityCommand({
@@ -10077,10 +10353,10 @@ var analysisAlertNoticeConfigList = createAnalysisCapabilityCommand({
 });
 
 // src/commands/te-analysis/alert-notice-config/index.ts
-var commands81 = [
+var commands82 = [
   analysisAlertNoticeConfigList
 ];
-var alert_notice_config_default = commands81;
+var alert_notice_config_default = commands82;
 
 // src/commands/te-analysis/system/shared.ts
 import { readFileSync as readFileSync3, statSync as statSync3 } from "fs";
@@ -11165,14 +11441,14 @@ var systemUsageCommands = [
 ];
 
 // src/commands/te-analysis/system/index.ts
-var commands82 = [
+var commands83 = [
   ...systemUsageCommands,
   ...systemIdentityCommands,
   ...systemSecurityCommands,
   ...systemMonitoringCommands,
   ...systemConfigurationCommands
 ];
-var system_default = commands82;
+var system_default = commands83;
 
 // src/commands/te-analysis/feedback/submit.ts
 import { createHash as createHash4, randomUUID as randomUUID2 } from "crypto";
@@ -11257,6 +11533,213 @@ 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;
+    const started = ctx.str("start-time");
+    if (started) input.duration_ms = scenarioDuration(started);
+  } else if (ctx.json("query-path") !== void 0 || ctx.str("answer-id") || ctx.str("user-message") || ctx.str("start-time")) {
+    throw new CliValidationError("user_feedback records user text and its target only; do not attach an answer or query path.");
+  }
+  return input;
+}
+function scenarioTransportInput(ctx, append = false) {
+  const input = scenarioInput(ctx, append);
+  const field = append ? "text" : "answer";
+  const original = input[field];
+  const bytes = Buffer.from(original, "utf8");
+  if (bytes.toString("utf8") !== original) {
+    throw new CliValidationError(`${field} must contain valid Unicode text.`);
+  }
+  return { ...input, [field]: bytes.toString("base64"), content_encoding: "base64" };
+}
+var commonFlags2 = [
+  { name: "start-time", type: "string", desc: "Exact start_time returned by scenario begin for this answer. CLI computes one question-to-answer duration; omit if not captured." },
+  { 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) => scenarioTransportInput(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) => scenarioTransportInput(ctx, true)
+}));
+function scenarioDuration(start, now = Date.now()) {
+  const millis = Date.parse(start);
+  if (!/^\d{4}-\d{2}-\d{2}T.*(?:Z|[+-]\d{2}:\d{2})$/.test(start) || !Number.isFinite(millis) || !(/* @__PURE__ */ new Date(`${start.slice(0, 10)}T00:00:00Z`)).toISOString().startsWith(start.slice(0, 10)) || millis > now || now - millis > 7776e6) {
+    throw new CliValidationError("start-time must be a real ISO-8601 timestamp within the last 90 days, copied from scenario begin.");
+  }
+  return now - millis;
+}
+var scenarioBegin = {
+  service: "analysis",
+  resource: "scenario",
+  command: "begin",
+  risk: "read",
+  usesAeHost: false,
+  description: "Capture the start of this question locally. No network request or file write. Reuse start_time when collecting the ready answer.",
+  flags: [],
+  execute: async () => ({ start_time: (/* @__PURE__ */ new Date()).toISOString() })
+};
+function scenarioListInput(ctx) {
+  const input = {};
+  for (const [flag, min, max, fallback] of [
+    ["project-id", 1, 2147483647, void 0],
+    ["days", 1, 90, 7],
+    ["limit", 1, 50, 20],
+    ["offset", 0, 2147483647, 0]
+  ]) {
+    const value = ctx.str(flag) === "" ? fallback : Number(ctx.str(flag));
+    if (value === void 0 || !Number.isInteger(value) || value < min || value > max) {
+      throw new CliValidationError(`${flag} must be an integer between ${min} and ${max}.`);
+    }
+    input[flag.replaceAll("-", "_")] = value;
+  }
+  const end = ctx.str("end-time");
+  if (end) {
+    if (!/^\d{4}-\d{2}-\d{2}T.*(?:Z|[+-]\d{2}:\d{2})$/.test(end) || !Number.isFinite(Date.parse(end)) || !(/* @__PURE__ */ new Date(`${end.slice(0, 10)}T00:00:00Z`)).toISOString().startsWith(end.slice(0, 10))) {
+      throw new CliValidationError("end-time must be an ISO-8601 timestamp with a timezone.");
+    }
+    input.end_time = end;
+  }
+  return input;
+}
+var scenarioList = createAnalysisCapabilityCommand({
+  resource: "scenario",
+  command: "list",
+  capabilityId: "analysis.scenario.list",
+  risk: "read",
+  description: "Read archived scenario questions with optional answer duration, exact answers, feedback and revisions. Follow the scenario review Skill for semantic deduplication and badcase assessment.",
+  flags: [
+    { name: "project-id", type: "number", required: true, desc: "Project to review. Requires project configuration permission to read collected content." },
+    { name: "days", type: "number", desc: "Recent calendar days including today in the deployment timezone. Default 7; range 1..90." },
+    { name: "limit", type: "number", desc: "Complete scenarios per page. Default 20; range 1..50." },
+    { name: "offset", type: "number", desc: "Scenario offset. Default 0; follow meta.next_offset until meta.has_more is false." },
+    { name: "end-time", type: "string", desc: "Exclusive ISO-8601 snapshot boundary. Reuse the first response meta.end_time and the same days on every subsequent page." }
+  ],
+  buildInput: scenarioListInput
+});
+function scenarioGetInput(ctx) {
+  const { limit, offset, ...input } = scenarioListInput(ctx);
+  for (const key of ["open-id", "agent-session-id", "question-id"]) {
+    input[key.replaceAll("-", "_")] = text2(ctx.str(key), key, 191);
+  }
+  return input;
+}
+var scenarioGet = createAnalysisCapabilityCommand({
+  resource: "scenario",
+  command: "get",
+  capabilityId: "analysis.scenario.get",
+  risk: "read",
+  description: "Read one archived question with answer duration and linked CLI inputs, execution results, costs and errors. Missing evidence stays explicit.",
+  flags: [
+    ...scenarioList.flags.filter((flag) => !["limit", "offset"].includes(flag.name)),
+    { name: "open-id", type: "string", required: true, desc: "Exact initial.open_id from scenario list. Project configuration permission is still required." },
+    { name: "agent-session-id", type: "string", required: true, desc: "Exact initial.agent_session_id from scenario list." },
+    { name: "question-id", type: "string", required: true, desc: "Exact initial.question_id from scenario list." }
+  ],
+  buildInput: scenarioGetInput
+});
+var scenario_default = [scenarioBegin, scenarioCollect, scenarioAppend, scenarioList, scenarioGet];
+
 // src/commands/te-analysis/index.ts
 registerCapabilityGatewayRoute("analysis", { gatewayDomain: "analysis" });
 registerCapabilityGatewayRoute("project", { gatewayDomain: "analysis" });
@@ -11305,10 +11788,11 @@ var baseCommands = [
   ...alert_job_default,
   ...alert_notice_config_default,
   ...system_default,
-  ...feedback_default
+  ...feedback_default,
+  ...scenario_default
 ];
-var commands83 = [...baseCommands];
-var te_analysis_default = commands83;
+var commands84 = [...baseCommands];
+var te_analysis_default = commands84;
 export {
   baseCommands,
   te_analysis_default as default