@thinkingai/ae-cli 6.1.28 → 6.1.29

package/dist/{local-data-upload-client-7HCPGIS3.js → local-data-upload-client-KCMG6J62.js}

@@ -2,7 +2,7 @@ import { createRequire as __createRequire } from 'node:module'; const require =
 import {
   LocalDataUploadError,
   logger
-} from "./chunk-ZW4VMY5H.js";
+} from "./chunk-Z3Q2AEIN.js";
 
 // src/core/local-data-upload-client.ts
 import { createHash } from "crypto";

package/dist/{memory-VCYLVPMI.js → memory-HHPX3NF2.js}

@@ -4,18 +4,18 @@ import {
   getMemoryCli,
   patchMemoryCli,
   postMemoryCli
-} from "./chunk-GI5BMEZO.js";
+} from "./chunk-QZUVLFNR.js";
 import {
   currentAgentSpaceId
 } from "./chunk-RK6GLDGI.js";
-import "./chunk-JJJIP2XQ.js";
-import "./chunk-2UWS5CUP.js";
+import "./chunk-N6XBLRB7.js";
+import "./chunk-RJHGDWSC.js";
 import "./chunk-Y74WTIKJ.js";
-import "./chunk-P7KL7IOH.js";
-import "./chunk-LMCYSVVA.js";
+import "./chunk-H3K5UGYC.js";
+import "./chunk-JNVVJ273.js";
 import {
   CliValidationError
-} from "./chunk-ZW4VMY5H.js";
+} from "./chunk-Z3Q2AEIN.js";
 
 // src/commands/memory/shared.ts
 var MEMORY_SERVICE = "memory";

package/dist/{metadata-YGI5M6OF.js → metadata-TIFY24LW.js}

@@ -1,19 +1,20 @@
 import { createRequire as __createRequire } from 'node:module'; const require = __createRequire(import.meta.url);
 import {
   withAsyncArtifactLifecycle
-} from "./chunk-UF244C5C.js";
+} from "./chunk-PWXDWMCW.js";
 import {
   createCapabilityCommand
-} from "./chunk-UJ7UPRXK.js";
-import "./chunk-QW3R6O7L.js";
+} from "./chunk-VCZE3IWO.js";
 import {
   registerCapabilityGatewayRoute
 } from "./chunk-KPQY44JQ.js";
-import "./chunk-ELCR235M.js";
+import "./chunk-QZLRHGVH.js";
+import "./chunk-3SDHJOCR.js";
 import "./chunk-Y74WTIKJ.js";
-import "./chunk-P7KL7IOH.js";
-import "./chunk-LMCYSVVA.js";
-import "./chunk-ZW4VMY5H.js";
+import "./chunk-2UW3Y463.js";
+import "./chunk-H3K5UGYC.js";
+import "./chunk-JNVVJ273.js";
+import "./chunk-Z3Q2AEIN.js";
 
 // src/commands/metadata/shared.ts
 function createCapabilityCommand2(config) {
@@ -150,7 +151,14 @@ var dataTableGet = createCapabilityCommand2({
   resource: "data-table",
   command: "get",
   capabilityId: "metadata.data_table.get",
-  description: "Get one metadata data table detail. Requires metadata view permission.",
+  description: "Get one metadata data table detail, including saved SQL definitions and schedule configuration when supported by the server. Requires metadata view permission.",
+  helpText: [
+    "SQL tables on supported servers include create_qp/update_qp, create_zone_offset/update_zone_offset, strategy, update_cron, and update_conf_status.",
+    "QP objects preserve SQL parameter/view-parameter definitions and saved values; they do not report values resolved for a particular execution.",
+    "The zone offsets belong to SQL parameter parsing, not the cron schedule timezone. The schedule switch status is separate from task execution status.",
+    "Use --format json for complete detail. --jq selects from the payload before envelope wrapping, for example --jq .update_qp.taSqlVo.sqlVoParams.",
+    "Older servers may omit these fields; null means unavailable configuration, not an empty parameter list."
+  ].join("\n"),
   flags: [
     { name: "project-id", type: "number", required: true, desc: "Numeric project ID.", alias: "p" },
     { name: "data-table-id", type: "number", required: true, desc: "Data table ID." },

package/dist/{model-DPJHSD73.js → model-7UHGWYVR.js}

@@ -15,11 +15,11 @@ import {
   getClaudeConfigDir,
   getSandboxModels,
   postSandboxModelSelection
-} from "./chunk-2UWS5CUP.js";
+} from "./chunk-RJHGDWSC.js";
 import "./chunk-Y74WTIKJ.js";
-import "./chunk-P7KL7IOH.js";
-import "./chunk-LMCYSVVA.js";
-import "./chunk-ZW4VMY5H.js";
+import "./chunk-H3K5UGYC.js";
+import "./chunk-JNVVJ273.js";
+import "./chunk-Z3Q2AEIN.js";
 
 // src/commands/model/index.ts
 import { existsSync, readFileSync } from "fs";

package/dist/{personal-semantic-preference-76TBKAPY.js → personal-semantic-preference-WKJEGPTM.js}

@@ -1,16 +1,17 @@
 import { createRequire as __createRequire } from 'node:module'; const require = __createRequire(import.meta.url);
 import {
   createCapabilityCommand
-} from "./chunk-UJ7UPRXK.js";
-import "./chunk-QW3R6O7L.js";
+} from "./chunk-VCZE3IWO.js";
 import {
   registerCapabilityGatewayRoute
 } from "./chunk-KPQY44JQ.js";
-import "./chunk-ELCR235M.js";
+import "./chunk-QZLRHGVH.js";
+import "./chunk-3SDHJOCR.js";
 import "./chunk-Y74WTIKJ.js";
-import "./chunk-P7KL7IOH.js";
-import "./chunk-LMCYSVVA.js";
-import "./chunk-ZW4VMY5H.js";
+import "./chunk-2UW3Y463.js";
+import "./chunk-H3K5UGYC.js";
+import "./chunk-JNVVJ273.js";
+import "./chunk-Z3Q2AEIN.js";
 
 // src/commands/personal-semantic-preference/shared.ts
 function createPersonalSemanticPreferenceCommand(config) {

package/dist/{project-semantic-XOEBO2Q5.js → project-semantic-EIQVZNHW.js}

@@ -3,22 +3,23 @@ import {
   assertOutputPathAvailable,
   downloadAnalysisArtifact,
   withAsyncArtifactLifecycle
-} from "./chunk-UF244C5C.js";
+} from "./chunk-PWXDWMCW.js";
+import {
+  registerCapabilityGatewayRoute,
+  resolveGatewayDomain
+} from "./chunk-KPQY44JQ.js";
+import "./chunk-QZLRHGVH.js";
 import {
   CapabilityGatewayError,
   dryRunCapability,
   executeCapabilityWithEnvelope,
   validateCapability
-} from "./chunk-QW3R6O7L.js";
-import {
-  registerCapabilityGatewayRoute,
-  resolveGatewayDomain
-} from "./chunk-KPQY44JQ.js";
-import "./chunk-ELCR235M.js";
+} from "./chunk-3SDHJOCR.js";
 import "./chunk-Y74WTIKJ.js";
-import "./chunk-P7KL7IOH.js";
-import "./chunk-LMCYSVVA.js";
-import "./chunk-ZW4VMY5H.js";
+import "./chunk-2UW3Y463.js";
+import "./chunk-H3K5UGYC.js";
+import "./chunk-JNVVJ273.js";
+import "./chunk-Z3Q2AEIN.js";
 
 // src/commands/project-semantic/asset-package/materializer.ts
 import { createHash, randomBytes } from "crypto";

package/dist/{sync-7PP6KQ75.js → sync-RV3OPCTI.js}

@@ -24,8 +24,8 @@ import {
 } from "./chunk-RK6GLDGI.js";
 import {
   require_lib
-} from "./chunk-2IYIYSUO.js";
-import "./chunk-T44M3PLZ.js";
+} from "./chunk-QVRIDN42.js";
+import "./chunk-JEUXDY3B.js";
 import {
   TeAgentApiError,
   TeAgentCredentialsError,
@@ -33,16 +33,17 @@ import {
   postSandboxSyncPull,
   postToMainApp,
   uploadToMainApp
-} from "./chunk-2UWS5CUP.js";
+} from "./chunk-RJHGDWSC.js";
 import {
   printError
-} from "./chunk-ELCR235M.js";
+} from "./chunk-QZLRHGVH.js";
 import "./chunk-Y74WTIKJ.js";
-import "./chunk-P7KL7IOH.js";
-import "./chunk-LMCYSVVA.js";
+import "./chunk-2UW3Y463.js";
+import "./chunk-H3K5UGYC.js";
+import "./chunk-JNVVJ273.js";
 import {
   __toESM
-} from "./chunk-ZW4VMY5H.js";
+} from "./chunk-Z3Q2AEIN.js";
 
 // src/commands/sync/index.ts
 var import_jszip = __toESM(require_lib(), 1);

package/dist/{te-agent-PJVAPKBD.js → te-agent-5ENVZJUH.js}

@@ -11,7 +11,7 @@ import {
   workspaceResourcePath,
   workspaceTargetFlags,
   workspaceTargetPath
-} from "./chunk-UUD5RB36.js";
+} from "./chunk-7JAVT5TK.js";
 import {
   currentAgentSpaceId
 } from "./chunk-RK6GLDGI.js";
@@ -27,23 +27,23 @@ import {
   requestResourcePackageRaw,
   resourcePackagePreflightChange,
   uploadAgentApi
-} from "./chunk-JJJIP2XQ.js";
+} from "./chunk-N6XBLRB7.js";
 import {
   TeAgentApiError,
   resolveTeClaudeBaseUrl
-} from "./chunk-2UWS5CUP.js";
+} from "./chunk-RJHGDWSC.js";
 import {
   buildCapabilityGatewayUrl,
   callCapabilityApi
-} from "./chunk-QW3R6O7L.js";
+} from "./chunk-3SDHJOCR.js";
 import "./chunk-Y74WTIKJ.js";
-import "./chunk-P7KL7IOH.js";
+import "./chunk-H3K5UGYC.js";
 import {
   getConfigDir
-} from "./chunk-LMCYSVVA.js";
+} from "./chunk-JNVVJ273.js";
 import {
   CliValidationError
-} from "./chunk-ZW4VMY5H.js";
+} from "./chunk-Z3Q2AEIN.js";
 
 // src/commands/te-agent/notifications.ts
 import { openSync, closeSync, fstatSync, readSync } from "fs";
@@ -63,6 +63,7 @@ function requestApprovalCli(ctx, method, path2, body, options = {}) {
     body,
     {
       apiBaseUrl: resolveApprovalApiBaseUrl(ctx.host()),
+      includeClientContextInBody: false,
       ...options,
       retryOnInvalidTokenForbidden: false
     }
@@ -4459,11 +4460,13 @@ function exportBody(ctx) {
     payload: {
       roots: references(ctx, "roots"),
       excluded: references(ctx, "excluded"),
+      ...ctx.str("view") ? { view: ctx.str("view") } : {},
       ...ctx.str("fileNameBase") ? { fileNameBase: ctx.str("fileNameBase") } : {}
     }
   };
 }
 function validateExport(ctx) {
+  if (ctx.str("view") && !["working", "published"].includes(ctx.str("view"))) throw new CliValidationError("--view must be working or published");
   exportBody(ctx);
   if (ctx.str("requestKey")) id(ctx, "requestKey", "request-key");
   const base = ctx.str("fileNameBase");
@@ -4483,6 +4486,7 @@ var exportResourcePackage = {
     { name: "scope", type: "string", required: true, desc: "Export scope: personal or company" },
     { name: "roots", type: "string", required: true, desc: "JSON, @file, or stdin (-) array of root resources" },
     { name: "excluded", type: "string", desc: "JSON or @file array of dependencies to exclude" },
+    { name: "view", type: "string", desc: "Knowledge base content: working (default) or published" },
     { name: "file-name-base", type: "string", desc: "Optional output ZIP base name" },
     { name: "request-key", type: "string", desc: "Optional idempotency key; reuse only for the same export" },
     { name: "output", type: "string", desc: "Local ZIP path; defaults to the artifact filename" },

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

@@ -7,12 +7,19 @@ import {
   waitForAnalysisRun,
   withAsyncArtifactLifecycle,
   withInterruptSignal
-} from "./chunk-UF244C5C.js";
+} from "./chunk-PWXDWMCW.js";
 import {
   createCapabilityCommand,
   definitionIntentSnapshotFlag,
   modelDefinitionIntentSnapshotFlag
-} from "./chunk-UJ7UPRXK.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-QW3R6O7L.js";
-import {
-  registerCapabilityGatewayRoute,
-  resolveGatewayDomain
-} from "./chunk-KPQY44JQ.js";
-import {
-  withOutputMetadata
-} from "./chunk-ELCR235M.js";
+} from "./chunk-3SDHJOCR.js";
 import "./chunk-Y74WTIKJ.js";
+import "./chunk-2UW3Y463.js";
 import {
   getCliToken
-} from "./chunk-P7KL7IOH.js";
-import "./chunk-LMCYSVVA.js";
+} from "./chunk-H3K5UGYC.js";
+import "./chunk-JNVVJ273.js";
 import {
   CliValidationError
-} from "./chunk-ZW4VMY5H.js";
+} from "./chunk-Z3Q2AEIN.js";
 
 // src/commands/te-analysis/capability-shared.ts
 var ANALYSIS_GATEWAY_CLI_SERVICES = /* @__PURE__ */ new Set(["project", "system"]);
@@ -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,23 +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.",
-  "- 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.",
+  "- 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:",
@@ -3125,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" }],',
@@ -3339,6 +3388,7 @@ function validatePresentation(presentation, itemIds) {
     }
     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.");
       }
@@ -3352,6 +3402,19 @@ function validatePresentation(presentation, itemIds) {
         }
         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) {
@@ -11515,12 +11578,25 @@ function scenarioInput(ctx, append = false) {
     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")) {
+    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." },
@@ -11568,7 +11644,7 @@ var scenarioCollect = withProjectCollectionPolicy(createAnalysisCapabilityComman
     { 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)
+  buildInput: (ctx) => scenarioTransportInput(ctx)
 }));
 var scenarioAppend = withProjectCollectionPolicy(createAnalysisCapabilityCommand({
   resource: "scenario",
@@ -11584,9 +11660,85 @@ var scenarioAppend = withProjectCollectionPolicy(createAnalysisCapabilityCommand
     { 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)
+  buildInput: (ctx) => scenarioTransportInput(ctx, true)
 }));
-var scenario_default = [scenarioCollect, scenarioAppend];
+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" });