openyida 2026.9.2-1 → 2026.9.2-2

package/lib/app/nav-group.js

@@ -7,6 +7,7 @@ const {
   requestWithAutoLogin,
 } = require('../core/utils');
 const { createAuthRef, isAuthRefReady } = require('../core/yida-client');
+const { CliError } = require('../core/cli-error');
 const { parseYidaI18n } = require('../core/yida-i18n');
 
 const ROOT_NAV_UUID = 'NAV-SYSTEM-PARENT-UUID';
@@ -422,6 +423,92 @@ function autoOrderRootNodes(list) {
   };
 }
 
+function snapshotNavigationRoots(roots) {
+  const snapshot = [];
+
+  const visit = (nodes, parentNavUuid) => {
+    (nodes || []).forEach((node, siblingIndex) => {
+      snapshot.push({
+        navUuid: node.navUuid,
+        parentNavUuid,
+        siblingIndex,
+        navType: node.navType || '',
+      });
+      visit(node.children || [], node.navUuid);
+    });
+  };
+
+  visit(roots || [], ROOT_NAV_UUID);
+  return snapshot;
+}
+
+function buildNavigationSnapshot(list) {
+  return snapshotNavigationRoots(buildMutableForest(list).roots);
+}
+
+function navigationSnapshotsEqual(left, right) {
+  if (!Array.isArray(left) || !Array.isArray(right) || left.length !== right.length) {
+    return false;
+  }
+
+  return left.every((item, index) => {
+    const other = right[index];
+    return other &&
+      item.navUuid === other.navUuid &&
+      item.parentNavUuid === other.parentNavUuid &&
+      item.siblingIndex === other.siblingIndex &&
+      item.navType === other.navType;
+  });
+}
+
+function findFirstNavigationDifference(actual, expected) {
+  const actualItems = Array.isArray(actual) ? actual : [];
+  const expectedItems = Array.isArray(expected) ? expected : [];
+  const length = Math.max(actualItems.length, expectedItems.length);
+
+  for (let index = 0; index < length; index++) {
+    const actualItem = actualItems[index] || null;
+    const expectedItem = expectedItems[index] || null;
+    if (!actualItem || !expectedItem ||
+      actualItem.navUuid !== expectedItem.navUuid ||
+      actualItem.parentNavUuid !== expectedItem.parentNavUuid ||
+      actualItem.siblingIndex !== expectedItem.siblingIndex ||
+      actualItem.navType !== expectedItem.navType) {
+      return {
+        index,
+        actual: actualItem,
+        expected: expectedItem,
+      };
+    }
+  }
+
+  return null;
+}
+
+function summarizeNavigationOrderDiff(code, beforeOrder, expectedOrder, observedOrder) {
+  const hasObservedOrder = Array.isArray(observedOrder);
+  return {
+    beforeCount: Array.isArray(beforeOrder) ? beforeOrder.length : 0,
+    expectedCount: Array.isArray(expectedOrder) ? expectedOrder.length : 0,
+    observedCount: hasObservedOrder ? observedOrder.length : null,
+    firstPlannedChange: findFirstNavigationDifference(beforeOrder, expectedOrder),
+    ...(code === 'NAV_ORDER_READBACK_MISMATCH' && hasObservedOrder
+      ? { firstReadbackMismatch: findFirstNavigationDifference(observedOrder, expectedOrder) }
+      : {}),
+  };
+}
+
+function buildNavigationOrderPlan(list, ordered) {
+  const beforeOrder = buildNavigationSnapshot(list);
+  const expectedOrder = snapshotNavigationRoots(ordered.roots);
+  return {
+    beforeOrder,
+    expectedOrder,
+    targetNavUuids: ordered.orderedNavUuids.slice(),
+    changed: !navigationSnapshotsEqual(beforeOrder, expectedOrder),
+  };
+}
+
 function countChildren(list, navUuid) {
   return (list || []).filter((node) => node.parentNavUuid === navUuid).length;
 }
@@ -455,7 +542,7 @@ async function fetchNavigationList(appType, authRef) {
   return Array.isArray(result.content) ? result.content : [];
 }
 
-async function postNavAction(appType, action, payload, authRef) {
+async function postNavAction(appType, action, payload, authRef, options = {}) {
   const endpoints = {
     save: 'saveFormNavigation.json',
     update: 'updateFormNavigation.json',
@@ -475,21 +562,143 @@ async function postNavAction(appType, action, payload, authRef) {
     throw new Error(`Unknown nav action: ${action}`);
   }
 
-  const result = await requestWithAutoLogin((auth) => {
+  const requestFn = (auth) => {
     const path = `/dingtalk/web/${appType}/query/formnav/${endpoint}` +
       `?_api=${encodeURIComponent(apiNames[action])}` +
       '&_mock=false' +
       `&_stamp=${Date.now()}`;
     return httpPost(auth.baseUrl, path, querystring.stringify(payload));
-  }, authRef);
+  };
+  const result = options.oneShot === true
+    ? await requestFn(authRef)
+    : await requestWithAutoLogin(requestFn, authRef);
 
-  if (!result || result.success === false) {
+  if (!result || result.success === false || result.__needLogin || result.__csrfExpired) {
     throw new Error(result ? result.errorMsg || `Nav action failed: ${action}` : `Nav action failed: ${action}`);
   }
 
   return result;
 }
 
+function buildNavigationOrderSuccess(appType, action, ordered, observedList, plan, recoveredByReadback) {
+  const orderedNodes = ordered.orderedNavUuids.map((navUuid) => normalizeNavNode(
+    resolveNode(observedList, navUuid, { excludeSystem: true })
+  ));
+  return {
+    success: true,
+    appType,
+    action,
+    targetParentNavUuid: ROOT_NAV_UUID,
+    changed: plan.changed,
+    alreadyApplied: !plan.changed,
+    mutationPerformed: plan.changed,
+    readbackVerified: true,
+    recoveredByReadback: recoveredByReadback === true,
+    sideEffectState: plan.changed ? 'committed' : 'none',
+    orderedNavUuids: ordered.orderedNavUuids,
+    orderedNodes,
+    skipped: !plan.changed,
+  };
+}
+
+function buildNavigationOrderError(code, appType, action, plan, observedOrder, cause) {
+  const sideEffectState = code === 'NAV_ORDER_NOT_APPLIED' ? 'none' : 'unknown';
+  const retrySafe = code === 'NAV_ORDER_NOT_APPLIED';
+  const readbackVerified = code === 'NAV_ORDER_NOT_APPLIED';
+  const status = code === 'NAV_ORDER_NOT_APPLIED'
+    ? 'NOT_APPLIED'
+    : code === 'NAV_ORDER_READBACK_MISMATCH'
+      ? 'SEMANTIC_FAILURE'
+      : 'RESULT_UNKNOWN';
+  return new CliError(code, {
+    code,
+    details: {
+      target: {
+        type: 'navigationOrder',
+        appType,
+        action,
+        navUuids: plan.targetNavUuids,
+      },
+      changed: plan.changed,
+      ...(code === 'NAV_ORDER_NOT_APPLIED' ? { mutationPerformed: false } : {}),
+      readbackVerified,
+      retryable: retrySafe,
+      retrySafe,
+      sideEffectState,
+      status,
+      readbackAllowed: true,
+      orderDiff: summarizeNavigationOrderDiff(
+        code,
+        plan.beforeOrder,
+        plan.expectedOrder,
+        observedOrder
+      ),
+      cause: cause && cause.message ? cause.message : undefined,
+      nextStep: `openyida nav-group list ${appType} --flat`,
+    },
+  });
+}
+
+async function applyNavigationOrder(appType, action, list, ordered, authRef, dependencies = {}) {
+  const fetchList = dependencies.fetchNavigationList || fetchNavigationList;
+  const postAction = dependencies.postNavAction || postNavAction;
+  const plan = buildNavigationOrderPlan(list, ordered);
+
+  if (!plan.changed) {
+    return buildNavigationOrderSuccess(appType, action, ordered, list, plan, false);
+  }
+
+  const firstNode = resolveNode(list, ordered.orderedNavUuids[0], { excludeSystem: true });
+  let mutationError = null;
+  try {
+    await postAction(appType, 'updateOrderNew', {
+      currentId: firstNode.id,
+      parentNavUuid: ROOT_NAV_UUID,
+      navType: firstNode.navType,
+      ids: ordered.ids.join(','),
+    }, authRef, { oneShot: true });
+  } catch (error) {
+    mutationError = error;
+  }
+
+  let updatedList;
+  try {
+    updatedList = await fetchList(appType, authRef);
+  } catch (readbackError) {
+    throw buildNavigationOrderError(
+      'NAV_ORDER_RESULT_UNKNOWN',
+      appType,
+      action,
+      plan,
+      null,
+      readbackError
+    );
+  }
+
+  const observedOrder = buildNavigationSnapshot(updatedList);
+  if (navigationSnapshotsEqual(observedOrder, plan.expectedOrder)) {
+    return buildNavigationOrderSuccess(appType, action, ordered, updatedList, plan, !!mutationError);
+  }
+  if (navigationSnapshotsEqual(observedOrder, plan.beforeOrder)) {
+    throw buildNavigationOrderError(
+      'NAV_ORDER_NOT_APPLIED',
+      appType,
+      action,
+      plan,
+      observedOrder,
+      mutationError
+    );
+  }
+  throw buildNavigationOrderError(
+    'NAV_ORDER_READBACK_MISMATCH',
+    appType,
+    action,
+    plan,
+    observedOrder,
+    mutationError
+  );
+}
+
 function normalizeListOutput(list, options = {}) {
   const includeSystem = options.includeSystem === true;
   return (list || [])
@@ -647,62 +856,17 @@ async function orderRootNodes(appType, values, authRef) {
 
   const list = await fetchNavigationList(appType, authRef);
   const ordered = reorderRootNodes(list, values);
-  const firstNode = resolveNode(list, ordered.orderedNavUuids[0], { excludeSystem: true });
-
-  await postNavAction(appType, 'updateOrderNew', {
-    currentId: firstNode.id,
-    parentNavUuid: ROOT_NAV_UUID,
-    navType: firstNode.navType,
-    ids: ordered.ids.join(','),
-  }, authRef);
-
-  const updatedList = await fetchNavigationList(appType, authRef);
-  const orderedNodes = ordered.orderedNavUuids.map((navUuid) => normalizeNavNode(
-    resolveNode(updatedList, navUuid, { excludeSystem: true })
-  ));
-  return {
-    success: true,
-    appType,
-    action: 'order',
-    targetParentNavUuid: ROOT_NAV_UUID,
-    orderedNavUuids: ordered.orderedNavUuids,
-    orderedNodes,
-  };
+  return applyNavigationOrder(appType, 'order', list, ordered, authRef);
 }
 
 async function autoOrderNavigation(appType, authRef) {
   const list = await fetchNavigationList(appType, authRef);
   const ordered = autoOrderRootNodes(list);
   if (!ordered.orderedNavUuids.length) {
-    return {
-      success: true,
-      appType,
-      action: 'auto-order',
-      targetParentNavUuid: ROOT_NAV_UUID,
-      orderedNavUuids: [],
-      orderedNodes: [],
-      skipped: true,
-    };
+    const plan = buildNavigationOrderPlan(list, ordered);
+    return buildNavigationOrderSuccess(appType, 'auto-order', ordered, list, plan, false);
   }
-
-  const firstNode = resolveNode(list, ordered.orderedNavUuids[0], { excludeSystem: true });
-  await postNavAction(appType, 'updateOrderNew', {
-    currentId: firstNode.id,
-    parentNavUuid: ROOT_NAV_UUID,
-    navType: firstNode.navType,
-    ids: ordered.ids.join(','),
-  }, authRef);
-
-  const updatedList = await fetchNavigationList(appType, authRef);
-  const updatedOrdered = autoOrderRootNodes(updatedList);
-  return {
-    success: true,
-    appType,
-    action: 'auto-order',
-    targetParentNavUuid: ROOT_NAV_UUID,
-    orderedNavUuids: updatedOrdered.orderedNavUuids,
-    orderedNodes: updatedOrdered.orderedNodes,
-  };
+  return applyNavigationOrder(appType, 'auto-order', list, ordered, authRef);
 }
 
 async function setVisibility(appType, value, hidden, authRef) {
@@ -790,8 +954,11 @@ async function run(args) {
 
 module.exports = {
   ROOT_NAV_UUID,
+  applyNavigationOrder,
   autoOrderNavigation,
   autoOrderRootNodes,
+  buildNavigationOrderPlan,
+  buildNavigationSnapshot,
   buildI18nTitle,
   buildNavigationTree,
   compareNavigationNodes,
@@ -800,6 +967,7 @@ module.exports = {
   getNavigationPriority,
   moveNodeInTree,
   normalizeNavNode,
+  navigationSnapshotsEqual,
   orderRootNodes,
   parseArgs,
   reorderRootNodes,

package/lib/app/publish.js

@@ -28,7 +28,7 @@ const { createAuthRef, isTokenAuthRef } = require('../core/yida-client');
 const { requireSchemaServerRevision } = require('../core/server-revision');
 const { t } = require('../core/i18n');
 const { banner, step, label, success, fail, warn, info, error, result, usage, hint } = require('../core/chalk');
-const { CliError } = require('../core/cli-error');
+const { CliError, isCliError, toErrorPayload } = require('../core/cli-error');
 const { compileSource } = require('./page-compiler');
 const { compileCanvas } = require('./canvas-compile');
 const { runLintCheck } = require('./page-linter');
@@ -723,6 +723,18 @@ async function runMain(argv) {
       success(t('publish.nav_order_ok', orderedNames || '-'));
     } catch (navOrderError) {
       navOrderWarning = navOrderError && navOrderError.message ? navOrderError.message : t('common.unknown_error');
+      navOrderResult = isCliError(navOrderError)
+        ? toErrorPayload(navOrderError)
+        : {
+          success: false,
+          errorCode: 'NAV_ORDER_RESULT_UNKNOWN',
+          errorMsg: navOrderWarning,
+          retryable: false,
+          retrySafe: false,
+          sideEffectState: 'unknown',
+          readbackVerified: false,
+          nextStep: `openyida nav-group list ${appType} --flat`,
+        };
       warn(t('publish.nav_order_failed', navOrderWarning));
     }
   }

package/lib/core/agent-capabilities.js

@@ -446,6 +446,37 @@ function compactBuilderPath(builderPath) {
   };
 }
 
+function buildFullAppArtifactRoute(manifest) {
+  const workflow = manifest.summary.core_workflows.full_app_build;
+  return {
+    orchestrator_skill_id: workflow.orchestrator_skill_id,
+    requirement_analysis_skill_id: workflow.requirement_analysis_skill_id,
+    requirement_brief_path: workflow.requirement_brief_path,
+    artifact_generation: workflow.artifact_generation,
+  };
+}
+
+function buildApplicationEntryPolicy(builderPath, env = process.env) {
+  const runtime = builderPath.runtime || {};
+  const managedRuntime = String(env.OPENYIDA_MANAGED_RUNTIME || '').trim().toLowerCase();
+  const managedCloudAgent = managedRuntime === 'cloud' ||
+    runtime.runtime === 'web_sandbox' ||
+    runtime.tool === 'mulerun';
+
+  return {
+    schema_version: 1,
+    environment: managedCloudAgent ? 'managed_cloud_agent' : 'non_cloud_agent',
+    delivery_unit: 'single_application_entry_group',
+    resource_delivery: 'summary_only',
+    internal_artifact_delivery: 'never',
+    entries: {
+      workbench: 'always',
+      custom: 'when_entry_mode_standalone_and_is_render_nav_false_readback',
+      admin: managedCloudAgent ? 'omit' : 'include',
+    },
+  };
+}
+
 function canonicalize(value) {
   if (Array.isArray(value)) {
     return value.map(canonicalize);
@@ -514,6 +545,7 @@ function buildAgentCapabilitiesSummary() {
   const builderPath = compactBuilderPath(
     buildBuilderPath(loginStatus, projectRoot, manifest, process.env, runtime)
   );
+  const applicationEntryPolicy = buildApplicationEntryPolicy(builderPath, process.env);
 
   return {
     schema_version: 1,
@@ -532,6 +564,8 @@ function buildAgentCapabilitiesSummary() {
     command_manifest_digest_algorithm: 'sha256',
     command_count: manifest.summary.command_count,
     full_capabilities_command: 'openyida agent-capabilities --json',
+    full_app_artifact_route: buildFullAppArtifactRoute(manifest),
+    application_entry_policy: applicationEntryPolicy,
     runtime,
     builder_path: builderPath,
   };
@@ -551,6 +585,7 @@ function buildAgentCapabilities() {
   const loginStatus = redactLogin(getAuthStatus({ projectRoot, includeSecrets: false }));
   const runtime = buildRuntimeSnapshot(projectRoot);
   const builderPath = buildBuilderPath(loginStatus, projectRoot, manifest, process.env, runtime);
+  const applicationEntryPolicy = buildApplicationEntryPolicy(builderPath, process.env);
 
   return {
     schema_version: 1,
@@ -564,6 +599,7 @@ function buildAgentCapabilities() {
     active: envSnapshot.active,
     runtime,
     login: loginStatus,
+    application_entry_policy: applicationEntryPolicy,
     recommended: {
       preflight_command: 'openyida agent-capabilities --summary-json',
       full_capabilities_command: 'openyida agent-capabilities --json',
@@ -607,7 +643,7 @@ function buildAgentCapabilities() {
       ],
       retry_policy: 'Do not repeat the same failed command without changing login state, organization, parameters, files, or field IDs.',
       completion_contracts: {
-        full_app: 'Default full-app build is complete after creating or reusing the app, core forms, primary page, publishing it, and returning access URLs. If three or more resources/links are returned, present them in a Markdown table with type, purpose/name, URL, and status.',
+        full_app: 'Default full-app build is complete after creating or reusing the app, core forms, primary page, publishing it, and returning one named application entry group. Summarize business resources in prose; do not deliver one artifact or link card per resource.',
       },
       full_app_data_contract: 'Default full-app page code must not call this.dataSourceMap.* unless the same run created and bound a designer data source; use this.utils.yida.* or an entry-only page by default.',
     },
@@ -638,6 +674,7 @@ async function run(args = []) {
 module.exports = {
   buildAgentCapabilities,
   buildAgentCapabilitiesSummary,
+  buildApplicationEntryPolicy,
   compactBuilderPath,
   buildCommandManifestDigest,
   run,

package/lib/core/cli-error.js

@@ -50,6 +50,10 @@ function toErrorPayload(error) {
         'deleted',
         'alreadyAbsent',
         'mutationAccepted',
+        'mutationPerformed',
+        'changed',
+        'alreadyApplied',
+        'recoveredByReadback',
         'readbackVerified',
         'status',
       ].forEach((key) => {
@@ -86,7 +90,8 @@ function shouldUseStructuredErrorOutput(error, args = []) {
     && details.retrySafe === false
     && details.sideEffectState === 'unknown'
   );
-  return ownedPartial || mutationOutcomeUnknown;
+  const navigationOrderFailure = /^NAV_ORDER_/.test(error.code || '');
+  return ownedPartial || mutationOutcomeUnknown || navigationOrderFailure;
 }
 
 module.exports = {

package/lib/core/command-manifest.js

@@ -1456,17 +1456,45 @@ function summarizeLocalizedCommands(commands) {
     core_workflows: {
       full_app_build: {
         mode: 'unified_build',
+        orchestrator_skill_id: 'yida-app',
         trigger_phrases: ['默认方案', '不要追问', '直接创建', '尽快搭建'],
         default_form_visual_guidance_skill_id: 'yida-form-detail',
         default_page_skill_id: 'yida-canvas-custom-page',
         default_ui_guidance_skill_id: 'yida-design',
+        requirement_analysis_skill_id: 'yida-requirement-analysis',
+        requirement_brief_path: '.cache/openyida/<project>/requirement-brief.json',
+        artifact_generation: {
+          mode: 'parallel',
+          audience: 'internal',
+          user_visible_delivery: false,
+          tasks: [
+            { skill_id: 'yida-prd', output_path: 'prd/<project>/prd.md' },
+            { skill_id: 'yida-design', output_path: 'prd/<project>/design.md' },
+          ],
+          join_owner_skill_id: 'yida-app',
+        },
         ordinary_jsx_skill_id: 'yida-custom-page',
         form_visual_guidance_policy: 'Default form page development loads yida-form-detail as form visual guidance and merges Divider semantic grouping into field JSON. The runtime loads the same application custom theme CSS file in custom pages, forms, submissions, formDetail pages, and FormOpenContainer iframes so all contexts use aligned theme variables.',
         page_skill_policy: 'Use YidaCodeCanvas by default for new primary custom pages. Choose yida-custom-page only when the current target has been identified as existing .oyd.jsx/.oyb.jsx/renderJsx/platform Jsx component maintenance; do not switch to yida-custom-page merely because a page needs data, forms, uploads, this.utils.yida.*, or dataSourceMap-like capabilities.',
-        product_design_policy: 'Full app creation first resolves resource context, then uses yida-design for requirement analysis and product design before creating or filling missing app/form/process/page resources. yida-design outputs prd/<project>/prd.md with app information, app configuration, data structures, page functions, business rules, interaction states, resource blueprint, resource creation order, page implementation delivery order, navigation order, and acceptance criteria; it outputs prd/<project>/design.md with theme tokens, app custom theme CSS delivery, themeColor/navTheme, visual DNA, layout density, rounded rules, scene recipes, component rules, state rules, and visual acceptance checks.',
-        ui_guidance_policy: 'Default full-app primary page creation consumes yida-design prd.md for positioning, information architecture, page prototype, native form entry policy, material strategy, and business-specific checks; it consumes design.md for theme system, visual states, visualScaffold, surface material, rounded rules, density rules, components, and state styling. prd.md and design.md are the only design sources of truth. Page implementation may extract page-spec.json as a derived implementation handoff from prd.md + design.md; conflicts are resolved by regenerating the spec from prd.md/design.md. Demo data, screenshots, public sharing, data-source deep binding, and fine navigation grouping are optional after explicit user request or PRD acceptance criteria.',
-        default_nav_order_policy: 'After the primary page is successfully published, immediately run a lightweight navigation order update. If the PRD names a navigation order, call openyida nav-group order <appType> <items...>. If the PRD only gives broad groups or is missing navigation order, use openyida publish ... --auto-nav-order or openyida nav-group auto-order <appType> as a fallback with portal/home/workbench entry > business handling > data management > business analytics > system configuration.',
-        final_link_policy: 'Return exactly one primary user-facing link. For single-page create/update/publish intent, return the current page URL. For full app, form, process, permission, theme, navigation, or batch-resource work, return the app workbench URL: {base_url}/{appType}/workbench. Summarize other resources by type/name/ID/status only; do not output static asset, CDN build, locale JSON, admin, config, schema, or intermediate-file URLs unless explicitly requested.',
+        product_design_policy: 'Full app creation first resolves resource context. yida-requirement-analysis writes one shared requirement brief. yida-prd and yida-design start in parallel from that brief and own prd/<project>/prd.md and prd/<project>/design.md independently; neither waits for or overwrites the other. yida-app joins both artifacts, validates their references, and only then creates or fills missing app/form/process/page resources.',
+        ui_guidance_policy: 'Page implementation consumes yida-prd prd.md for positioning, information architecture, page prototype, native form entry policy, material strategy, business-specific checks, resource creation order, page implementation delivery order, navigation order, and acceptance criteria; it consumes yida-design design.md for app custom theme CSS delivery, themeColor/navTheme, visual states, visualScaffold, surface material, rounded rules, density rules, components, and state styling. prd.md and design.md are the only design sources of truth. Page implementation may extract page-spec.json as a derived implementation handoff from prd.md + design.md; conflicts are resolved by sending business conflicts to yida-prd and visual conflicts to yida-design before regenerating the spec. Demo data, screenshots, public sharing, data-source deep binding, and fine navigation grouping are optional after explicit user request or PRD acceptance criteria.',
+        default_nav_order_policy: 'After the primary page is successfully published, perform exactly one navigation order operation. If the PRD names a navigation order, publish without --auto-nav-order and then call openyida nav-group order <appType> <items...>. If the PRD only gives broad groups or is missing navigation order, use openyida publish ... --auto-nav-order and do not call nav-group order or auto-order afterward. Explicit and automatic ordering are mutually exclusive; never generate per-item move loops. The fallback priority is portal/home/workbench entry > business handling > data management > business analytics > system configuration.',
+        final_link_policy: 'Return exactly one user-visible application entry group, never one artifact or link card per form, process, report, schema, manifest, PRD, design file, or intermediate artifact. The group always contains the app workbench URL. Add the clean custom page URL only when PRD entryMode=standalone and get-form-config readback confirms isRenderNav=false. Add the admin URL only when agent-capabilities application_entry_policy.entries.admin=include. Summarize other business resources in prose unless the user explicitly asks for technical IDs.',
+        application_entry_policy: {
+          delivery_unit: 'single_application_entry_group',
+          workbench: { include: 'always', url: '{base_url}/{appType}/workbench' },
+          custom: {
+            include: 'when_entry_mode_standalone_and_is_render_nav_false_readback',
+            url: '{base_url}/{appType}/custom/{formUuid}',
+          },
+          admin: {
+            include: 'follow_agent_capabilities_application_entry_policy',
+            url: '{base_url}/{appType}/admin',
+          },
+          internal_artifacts: 'never_user_visible',
+          business_resources: 'summary_only',
+        },
+        conditional_entry_command_ids: ['update-form-config', 'get-form-config'],
         required_command_ids: [
           'agent-capabilities',
           'create-app',
@@ -1496,7 +1524,7 @@ function summarizeLocalizedCommands(commands) {
           'yida-data-management',
           'yida-dashboard',
         ],
-        completion_contract: 'Resolve context, write the yida-design PRD, create or reuse app, core forms/processes, and primary page in PRD resource order, publish it, apply PRD navigation order or lightweight fallback navigation order, and return access URLs. If three or more resources/links are returned, present them in a Markdown table with type, purpose/name, URL, and status.',
+        completion_contract: 'Resolve context, write the shared requirement brief, complete and join the internal parallel yida-prd and yida-design artifacts, create or reuse app, core forms/processes, and primary page in PRD resource order, publish it, apply PRD navigation order or lightweight fallback navigation order, and return one named application entry group. The group contains workbench, conditionally a verified standalone custom entry, and admin only for non-cloud agents. Business resources are summarized instead of emitted as individual delivery artifacts.',
       },
     },
   };

package/lib/core/locales/en.js

@@ -1849,6 +1849,8 @@ Options:
 };
 
 Object.assign(module.exports.query_data || (module.exports.query_data = {}), {
+  association_derived_field_read_only: 'Derived association-form query field {0} is read-only and cannot be saved or updated. Write the source association field without the _id suffix.',
+  association_value_invalid: 'The write value for association-form field {0} is invalid. Use an array of objects where every item includes appType, formUuid, formType, instanceId, and title.',
   command_unsupported: 'Unsupported data command: {0} {1}. Run openyida commands --json to inspect the actual capability.',
   delete_confirmation_required: 'Before deleting a form instance, query it, show the target summary to the user, and add --confirm only after explicit approval. No delete was performed.',
   delete_preflight_failed: 'Could not read form instance {0} for delete preflight. No delete was performed.',
@@ -1857,6 +1859,7 @@ Object.assign(module.exports.query_data || (module.exports.query_data = {}), {
   delete_result_unknown: 'The delete outcome for form instance {0} is unknown. Perform read-only inspection and do not retry the delete automatically.',
   delete_target_mismatch: 'Form instance {0} does not belong to target form {1}. The operation stopped before delete.',
   delete_target_unverified: 'Could not verify the identity and ownership of form instance {0}. The operation stopped before delete.',
+  field_reference_unknown: 'Field reference {0} is not a real fieldId or component alias in the target form. The operation stopped before mutation.',
   form_mode_unverified: 'Could not verify the type of form {0}. Creation stopped before any data write.',
   instance_target_mismatch: 'Instance {0} does not belong to expected business resource {1}. The operation stopped before mutation.',
   instance_target_unverified: 'Could not verify the business resource ownership of instance {0}. The operation stopped before mutation.',

package/lib/core/locales/zh.js

@@ -137,7 +137,7 @@ openyida - 宜搭命令行工具
   copy [--force]                                               复制 project 工作目录到当前 AI 工具环境
   login                                                        OAuth token 登录态管理
   logout                                                       退出登录 / 切换账号
-  create-app --name "<名称>" [--theme-file <css> 及导航布局选项] 创建应用；推荐导入新版主题，输出 appType
+  create-app --name "<名称>" [--theme-file <css> 及导航布局选项] 创建应用；推荐导入应用主题文件，输出 appType
   create-page <appType> "<页面名>" [--mode dashboard] [--hide-nav] 创建自定义页面，输出 pageId
   update-app <appType> [--name "..."] [--hide-app-nav|--show-app-nav] 更新应用信息
   create-form create <appType> "<表单名>" <字段JSON> [--layout <布局>] [--theme <主题>] [--label-align <对齐>]  创建表单页面
@@ -1803,6 +1803,8 @@ openyida - 宜搭命令行工具
 };
 
 Object.assign(module.exports.query_data || (module.exports.query_data = {}), {
+  association_derived_field_read_only: '关联表单查询派生字段 {0} 只读，不能用于保存或更新。请写入不带 _id 后缀的原始关联表单字段。',
+  association_value_invalid: '关联表单字段 {0} 的写入值无效。必须使用对象数组，每项完整包含 appType、formUuid、formType、instanceId 和 title。',
   command_unsupported: '不支持的数据命令：{0} {1}。请使用 openyida commands --json 查询真实能力。',
   delete_confirmation_required: '删除表单实例前必须先查询并向用户展示目标摘要，获得明确确认后追加 --confirm。未执行删除。',
   delete_preflight_failed: '无法读取表单实例 {0} 完成删除前校验，未执行删除。',
@@ -1811,6 +1813,7 @@ Object.assign(module.exports.query_data || (module.exports.query_data = {}), {
   delete_result_unknown: '表单实例 {0} 的删除结果未知。请只读回查目标，不要自动重试删除。',
   delete_target_mismatch: '表单实例 {0} 不属于目标表单 {1}，已停止且未执行删除。',
   delete_target_unverified: '无法验证表单实例 {0} 的身份和归属，已停止且未执行删除。',
+  field_reference_unknown: '字段引用 {0} 不是当前表单的真实 fieldId 或组件别名，已在写入前停止。',
   form_mode_unverified: '无法验证表单 {0} 的类型，已停止创建；未执行任何数据写入。',
   instance_target_mismatch: '实例 {0} 不属于期望的业务资源 {1}，已在写入前停止。',
   instance_target_unverified: '无法验证实例 {0} 的业务资源归属，已在写入前停止。',