openyida 2026.7.12 → 2026.7.14-1

package/README.md

@@ -55,10 +55,10 @@ If Codex is already installed, OpenYida also imports a local Codex plugin during
 Run this from the AI coding workspace where you want OpenYida to operate:
 
 ```bash
-openyida agent-capabilities --json
+openyida agent-capabilities --summary-json
 ```
 
-OpenYida detects the active agent environment, workspace path, login state, organization context, command manifest, and side-effect hints in one machine-readable snapshot. `openyida commands --json` remains available when an agent only needs the command manifest.
+OpenYida returns a compact machine-readable summary with the version, login state, workspace/cache paths, and command manifest digest. `openyida agent-capabilities --json` is the full diagnostic snapshot, where compact `workdir` maps to `active.projectRoot` and `workdir_exists` maps to `active.projectRootExists`. `openyida commands --json` remains available when an agent only needs the command manifest.
 
 ### 3. Log In
 
@@ -343,8 +343,7 @@ Run `openyida --help` or `openyida <command> --help` for detailed usage.
 | `openyida logout` | Logout / switch account |
 | `openyida auth <status\|login\|refresh\|logout>` | Login state management |
 | `openyida org <list\|switch>` | Organization management (list / switch) |
-| `openyida env [--json]` | Detect AI tool environment & login state |
-| `openyida env <setup\|list\|show\|switch\|add\|remove>` | Manage public/private Yida environment profiles |
+| `openyida env [--json\|setup\|list\|show\|switch\|add\|remove] [options]` | Detect AI tool environment & login state |
 
 ### App Management
 
@@ -374,7 +373,7 @@ Run `openyida --help` or `openyida <command> --help` for detailed usage.
 | `openyida create-form add-option <appType> <formUuid> <fieldLabel> <option1> [option2] ...` | Update a form page |
 | `openyida list-forms <appType> [--keyword <text>]` | List forms/pages in an app |
 | `openyida aggregate-table <list\|create-empty\|inspect\|preview\|save\|publish\|status> <appType> ...` | Manage aggregate tables (virtualView) |
-| `openyida get-schema <appType> <formUuid\|--all>` | Get one form Schema or all form Schemas |
+| `openyida get-schema <appType> <formUuid\|--all> [--summary-json\|--field-map-json]` | Get one form Schema or all form Schemas |
 | `openyida er <appType> [--format mermaid\|json] [--output file] [--include-system] [--include-pages]` | Export app entity relationship diagram |
 | `openyida create-page <appType> "<name>" [--mode dashboard] [--locale zh_CN\|en_US\|ja_JP] [--open\|--no-open]` | Create a custom display page |
 | `openyida generate-page <template>` | Generate page from curated template |
@@ -458,7 +457,7 @@ Run `openyida --help` or `openyida <command> --help` for detailed usage.
 | Command | Description |
 |---------|-------------|
 | `openyida commands [--json]` | Output machine-readable command manifest |
-| `openyida agent-capabilities [--json]` | Output one-shot agent capability snapshot |
+| `openyida agent-capabilities [--json] [--summary-json\|--compact]` | Output one-shot agent capability snapshot |
 | `openyida a2a <serve\|agent-card> [options]` | Start local read-only A2A adapter or print Agent Card |
 | `openyida bridge start [--token <pair-token>] [--port 6736] [--origin https://demo.aliwork.com] [--open\|--no-open]` | Start OpenYida local web bridge service |
 | `openyida copy [--force]` | Copy project working directory |
@@ -469,8 +468,7 @@ Run `openyida --help` or `openyida <command> --help` for detailed usage.
 | `openyida update` | Check and update to latest version |
 | `openyida export-conversation [options]` | Export AI conversation records |
 | `openyida feedback <setup\|url\|dismiss\|status> [options]` | Configure experience feedback form and local reminder state |
-| `openyida batch <file> [--stop-on-error] [--json]` | Run OpenYida commands in batch |
-| `openyida batch --commands "cmd1 ; cmd2" [--stop-on-error] [--json]` | Run OpenYida commands in batch |
+| `openyida batch <file>\|--commands "cmd1 ; cmd2" [--stop-on-error] [--json]` | Run OpenYida commands in batch |
 | `openyida flash-to-prd --file <path> --name "<project>"` | Convert flash notes or meeting notes to a PRD prompt |
 | `openyida ai <text\|image> [options]` | Call Yida AI text and image recognition APIs |
 | `openyida cdn-config [options]` | Configure CDN / OSS upload |

package/lib/app/get-schema.js

@@ -2,8 +2,8 @@
  * get-schema.js - 宜搭表单 Schema 获取命令
  *
  * 用法：
- *   openyida get-schema <appType> <formUuid>
- *   openyida get-schema <appType> --all [--output-dir <dir>] [--concurrency N] [--retries N]
+ *   openyida get-schema <appType> <formUuid> [--summary-json|--field-map-json]
+ *   openyida get-schema <appType> --all [--summary-json] [--output-dir <dir>] [--concurrency N] [--retries N]
  */
 
 'use strict';
@@ -31,7 +31,7 @@ const FIELD_TYPES_NEEDING_VALUE_SUFFIX = new Set([
 /**
  * 从 Schema 中提取字段摘要，列出每个字段的真实 fieldId、组件别名和报表用 reportFieldCode。
  * @param {object} schemaResult - getFormSchema API 返回结果
- * @returns {Array<{label, componentName, fieldId, alias, reportFieldCode}>}
+ * @returns {Array<{label, componentName, fieldId, alias, reportFieldCode, options}>}
  */
 function extractFieldSummary(schemaResult) {
   const fields = [];
@@ -62,12 +62,17 @@ function extractFieldSummary(schemaResult) {
         ? `${fieldId}_value`
         : fieldId;
       if (fieldId) {
+        const options = extractOptionSummary(props);
+        const optionSource = getOptionSource(props) || [];
         fields.push({
           label,
           componentName: node.componentName,
           fieldId,
           alias: aliasMaps.aliasByFieldId[fieldId] || '',
           reportFieldCode,
+          options,
+          optionCount: optionSource.length,
+          optionsTruncated: optionSource.length > options.length,
         });
       }
     }
@@ -87,6 +92,70 @@ function extractFieldSummary(schemaResult) {
   return fields;
 }
 
+function normalizeOptionLabel(value) {
+  if (value === null || value === undefined) {
+    return '';
+  }
+  if (typeof value === 'object') {
+    return value.zh_CN || value.zh_HK || value.en_US || value.ja_JP || value.text || value.label || value.value || '';
+  }
+  return String(value);
+}
+
+function firstPresent(values) {
+  return values.find(value => value !== undefined && value !== null);
+}
+
+function normalizeOptionValue(value, fallback) {
+  if (value === null || value === undefined || value === '') {
+    return fallback;
+  }
+  if (typeof value === 'object') {
+    return value.value || value.label || value.text || fallback;
+  }
+  return String(value);
+}
+
+function optionArrayFromDataSource(dataSource) {
+  if (!dataSource) {
+    return null;
+  }
+  if (Array.isArray(dataSource)) {
+    return dataSource;
+  }
+  const candidates = [
+    dataSource.options,
+    dataSource.data,
+    dataSource.list,
+    dataSource.values,
+  ];
+  return candidates.find(Array.isArray) || null;
+}
+
+function getOptionSource(props = {}) {
+  return Array.isArray(props.options)
+    ? props.options
+    : optionArrayFromDataSource(props.dataSource);
+}
+
+function extractOptionSummary(props = {}) {
+  const source = getOptionSource(props);
+  if (!source) {
+    return [];
+  }
+  return source.slice(0, 50).map((item, index) => {
+    if (typeof item === 'string' || typeof item === 'number' || typeof item === 'boolean') {
+      const text = String(item);
+      return { label: text, value: text };
+    }
+    const label = normalizeOptionLabel(firstPresent([item.label, item.text, item.name, item.title, item.value]));
+    return {
+      label,
+      value: normalizeOptionValue(firstPresent([item.value, item.key, item.id]), label || String(index)),
+    };
+  });
+}
+
 function buildComponentAliasMaps(schemaResult) {
   const aliasByFieldId = {};
   const fieldIdByAlias = {};
@@ -136,6 +205,7 @@ function parseArgs(args) {
     // 仅返回目标字段的 {componentName, fieldId, label, props}
     field: '',
     json: false,
+    summaryJson: false,
   };
 
   for (let index = 1; index < args.length; index++) {
@@ -159,6 +229,8 @@ function parseArgs(args) {
       index++;
     } else if (arg === '--json') {
       parsed.json = true;
+    } else if (arg === '--summary-json' || arg === '--field-map-json') {
+      parsed.summaryJson = true;
     } else if (!arg.startsWith('--') && !parsed.formUuid) {
       parsed.formUuid = arg;
     }
@@ -303,6 +375,18 @@ function printFieldSummary(result) {
   process.stderr.write(`  ${c.dim}注：SelectField/EmployeeField 在报表中需加 _value 后缀${c.reset}\n\n`);
 }
 
+function buildSchemaSummary(appType, formUuid, schemaResult, meta = {}) {
+  const fields = extractFieldSummary(schemaResult);
+  return {
+    success: true,
+    appType,
+    formUuid,
+    ...meta,
+    fieldCount: fields.length,
+    fields,
+  };
+}
+
 function filterForms(forms, keyword) {
   if (!keyword) {
     return forms;
@@ -373,9 +457,19 @@ async function fetchSchemaRecord(appType, form, authRef, retries) {
   };
 }
 
-function writeBatchOutput(outputDir, records) {
+function summarizeRecord(record) {
+  if (!record.success) {
+    return record;
+  }
+  const { schema, ...summary } = record;
+  void schema;
+  return summary;
+}
+
+function writeBatchOutput(outputDir, records, options = {}) {
+  const compact = !!options.compact;
   if (!outputDir) {
-    return records;
+    return compact ? records.map(summarizeRecord) : records;
   }
 
   const resolvedDir = path.resolve(outputDir);
@@ -391,10 +485,8 @@ function writeBatchOutput(outputDir, records) {
     const filePath = path.join(resolvedDir, fileName);
     fs.writeFileSync(filePath, JSON.stringify(record.schema, null, 2), 'utf-8');
 
-    const { schema, ...summary } = record;
-    void schema;
     return {
-      ...summary,
+      ...summarizeRecord(record),
       schemaFile: filePath,
     };
   });
@@ -452,6 +544,11 @@ async function runSingle(parsed, authRef) {
     return;
   }
 
+  if (parsed.summaryJson) {
+    console.log(JSON.stringify(buildSchemaSummary(parsed.appType, parsed.formUuid, result), null, 2));
+    return;
+  }
+
   chalkSuccess(t('get_schema.success'));
   printFieldSummary(result);
   console.log(JSON.stringify(result, null, 2));
@@ -494,7 +591,7 @@ async function runBatch(parsed, authRef) {
     return record;
   });
 
-  const outputRecords = writeBatchOutput(parsed.outputDir, records);
+  const outputRecords = writeBatchOutput(parsed.outputDir, records, { compact: parsed.summaryJson });
   const successCount = records.filter(record => record.success).length;
   const failedCount = records.length - successCount;
 
@@ -509,6 +606,7 @@ async function runBatch(parsed, authRef) {
     total: records.length,
     successCount,
     failedCount,
+    summaryOnly: parsed.summaryJson || undefined,
     outputDir: parsed.outputDir ? path.resolve(parsed.outputDir) : undefined,
     forms: outputRecords,
   }, null, 2));
@@ -527,6 +625,8 @@ async function run(args) {
 
 module.exports = {
   extractFieldSummary,
+  extractOptionSummary,
+  buildSchemaSummary,
   buildComponentAliasMaps,
   parseArgs,
   filterForms,

package/lib/core/agent-capabilities.js

@@ -1,5 +1,6 @@
 'use strict';
 
+const crypto = require('crypto');
 const path = require('path');
 const { version } = require('../../package.json');
 const { t } = require('./i18n');
@@ -14,6 +15,79 @@ function redactLogin(login) {
   return redacted;
 }
 
+function compactLogin(login) {
+  return {
+    status: login.status,
+    can_auto_use: login.can_auto_use === true,
+  };
+}
+
+function canonicalize(value) {
+  if (Array.isArray(value)) {
+    return value.map(canonicalize);
+  }
+  if (!value || typeof value !== 'object') {
+    return value;
+  }
+
+  return Object.keys(value)
+    .sort()
+    .reduce((result, key) => {
+      result[key] = canonicalize(value[key]);
+      return result;
+    }, {});
+}
+
+function buildCommandManifestDigest(manifest) {
+  const digestPayload = {
+    schema_version: manifest.schema_version,
+    command_prefix: manifest.command_prefix,
+    summary: {
+      command_count: manifest.summary.command_count,
+      group_count: manifest.summary.group_count,
+      side_effect_counts: manifest.summary.side_effect_counts,
+      permission_mode_counts: manifest.summary.permission_mode_counts,
+      core_workflows: manifest.summary.core_workflows,
+    },
+    commands: manifest.commands.map(entry => ({
+      id: entry.id,
+      usage: entry.usage,
+      requires_login: entry.requires_login,
+      output: entry.output,
+      side_effect_kind: entry.side_effect && entry.side_effect.kind,
+      permission_mode: entry.permission && entry.permission.mode,
+      permission_effect: entry.permission && entry.permission.effect,
+    })),
+  };
+
+  return crypto
+    .createHash('sha256')
+    .update(JSON.stringify(canonicalize(digestPayload)))
+    .digest('hex');
+}
+
+function buildAgentCapabilitiesSummary() {
+  const envSnapshot = buildEnvironmentSnapshot();
+  const loginStatus = checkLoginOnly({ includeSecrets: false });
+  const manifest = buildCommandManifest({ t, version });
+  const projectRoot = envSnapshot.active.projectRoot;
+
+  return {
+    schema_version: 1,
+    name: 'openyida-agent-capabilities-summary',
+    version,
+    login: compactLogin(loginStatus),
+    workdir: projectRoot,
+    workdir_exists: !!envSnapshot.active.projectRootExists,
+    cache_dir: path.join(projectRoot, '.cache'),
+    openyida_task_cache_dir: path.join(projectRoot, '.cache', 'openyida'),
+    command_manifest_digest: buildCommandManifestDigest(manifest),
+    command_manifest_digest_algorithm: 'sha256',
+    command_count: manifest.summary.command_count,
+    full_capabilities_command: 'openyida agent-capabilities --json',
+  };
+}
+
 function buildAgentCapabilities() {
   const envSnapshot = buildEnvironmentSnapshot();
   const loginStatus = redactLogin(checkLoginOnly({ includeSecrets: false }));
@@ -32,43 +106,69 @@ function buildAgentCapabilities() {
     active: envSnapshot.active,
     login: loginStatus,
     recommended: {
-      preflight_command: 'openyida agent-capabilities --json',
+      preflight_command: 'openyida agent-capabilities --summary-json',
+      full_capabilities_command: 'openyida agent-capabilities --json',
       mutation_guard: 'Run mutating commands only when login.status is ok or after a successful openyida login.',
       workdir: projectRoot,
       cache_dir: path.join(projectRoot, '.cache'),
       openyida_task_cache_dir: path.join(projectRoot, '.cache', 'openyida'),
+      default_full_app_workflow: manifest.summary.core_workflows.full_app_fast_build,
     },
     skills: {
       index_file: 'skills-index.json',
       entry: 'openyida',
       note: 'Use host use_skill/search_skills when available; otherwise load only the current-stage SKILL.md selected by the root routing table.',
     },
+    commands: {
+      count: manifest.summary.command_count,
+      group_count: manifest.summary.group_count,
+      side_effect_counts: manifest.summary.side_effect_counts,
+      permission_mode_counts: manifest.summary.permission_mode_counts,
+      read_only_command_ids: manifest.summary.read_only_command_ids,
+      mutating_command_ids: manifest.summary.mutating_command_ids,
+      allow_command_ids: manifest.summary.allow_command_ids,
+      ask_command_ids: manifest.summary.ask_command_ids,
+      deny_command_ids: manifest.summary.deny_command_ids,
+      core_workflows: manifest.summary.core_workflows,
+    },
     sideEffects: {
       read_only_preflight: [
-        'openyida agent-capabilities --json',
+        'openyida agent-capabilities --summary-json',
         'openyida env --json',
         'openyida login --check-only --json',
         'openyida commands --json',
       ],
       retry_policy: 'Do not repeat the same failed command without changing login state, organization, parameters, files, or field IDs.',
       completion_contracts: {
-        full_app: 'Publishing the primary page successfully and returning an access URL completes the default build.',
+        full_app: 'Default fast_build is complete after creating the app, core forms, primary page, publishing it, and returning an access URL.',
       },
+      fast_build_data_contract: 'Default fast_build 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.',
     },
     command_manifest: {
       schema_version: manifest.schema_version,
       groups: manifest.groups,
       side_effect_schema: manifest.side_effect_schema,
+      permission_schema: manifest.permission_schema,
+      summary: manifest.summary,
       commands: manifest.commands,
     },
   };
 }
 
-async function run() {
-  console.log(JSON.stringify(buildAgentCapabilities(), null, 2));
+function shouldUseSummary(args = []) {
+  return args.includes('--summary-json') || args.includes('--compact');
+}
+
+async function run(args = []) {
+  const payload = shouldUseSummary(args)
+    ? buildAgentCapabilitiesSummary()
+    : buildAgentCapabilities();
+  console.log(JSON.stringify(payload, null, 2));
 }
 
 module.exports = {
   buildAgentCapabilities,
+  buildAgentCapabilitiesSummary,
+  buildCommandManifestDigest,
   run,
 };