openyida 2026.5.9-beta.9 → 2026.5.9

package/README.md

@@ -1,6 +1,6 @@
 <div align="center">
 
-![OpenYida](https://img.alicdn.com/imgextra/i4/O1CN017uyK3q1UUfbv7Z8oh_!!6000000002521-2-tps-2648-1382.png)
+![OpenYida](https://img.alicdn.com/imgextra/i3/O1CN01SKWbWu1aPzGXh293W_!!6000000003323-2-tps-1672-941.png)
 
 # OpenYida
 
@@ -199,6 +199,40 @@ openyida get-permission APP_XXX FORM_XXX
 
 When creating or updating test data with `openyida data`, Yida date fields must use 13-digit millisecond timestamps, for example `"dateField_xxx": 1719705600000`. Do not submit `YYYY-MM-DD` strings for `DateField` or `CascadeDateField` values.
 
+### Real Environment E2E
+
+Most checks should stay offline, but OpenYida also includes an explicit real-environment smoke path for release and nightly validation:
+
+```bash
+OPENYIDA_E2E=1 npm run test:e2e:real
+OPENYIDA_E2E=1 npm run test:e2e:real:full
+npm run test:e2e:real:skills
+```
+
+The runner creates a disposable app, form, and custom page with an `OY_E2E_*` prefix, then verifies login, app listing, schema fetch, data query, and page publish. It writes a registry to `project/.cache/e2e-real/` so created resources can be audited later. To inject CI cookies without relying on a local login cache, pass `OPENYIDA_E2E_COOKIES_BASE64` as a base64 encoded cookie array or `{ "cookies": [...] }` object.
+
+`test:e2e:real:full` extends the smoke path into a broad deterministic feature matrix: auth/env, app update, form update and option mutation, page build/compile/generate/publish, data create/get/update/query, permission read, page config and short URL check, report create/append, dashboard skill verification, export/import, batch, task-center, formula/doctor/sample/CDN config, and local connector parsing/template generation. AI-backed commands such as `flash-to-prd` are available as the optional `ai` stage because they depend on remote model availability.
+
+`test:e2e:real:skills` enforces coverage for every directory under `yida-skills/skills/`. Each skill must be classified as real E2E, offline/unit, opt-in, or deprecated with an explicit reason. This prevents new skills from quietly bypassing the real-environment test plan.
+
+Each successful full run leaves a human-inspectable result app in the target organization. The final step publishes a dedicated `Full E2E Dashboard` custom page, renames the app to `OY_E2E_*_PASSED` by default, and prints direct links for the app, form, dashboard page, and report; the same links are saved under `resultApp` in the registry JSON.
+
+Useful options:
+
+| Env var | Purpose |
+|---------|---------|
+| `OPENYIDA_E2E_PREFIX` | Override the disposable resource name prefix |
+| `OPENYIDA_E2E_CORP_ID` | Switch to the dedicated test organization before creating resources |
+| `OPENYIDA_E2E_RESULT_APP_NAME` | Override the final app name shown as the full-run result |
+| `OPENYIDA_E2E_BASE_URL` | Override the Yida base URL for private deployments |
+| `OPENYIDA_E2E_FIELDS_FILE` | Use a custom form fields fixture |
+| `OPENYIDA_E2E_PAGE_SOURCE` | Use a custom page source for publish verification |
+| `OPENYIDA_E2E_SKIP_PUBLISH=1` | Skip custom page creation and publish |
+| `OPENYIDA_E2E_REGISTRY_DIR` | Write registries outside `project/.cache/e2e-real/` |
+| `OPENYIDA_E2E_FULL_STAGES` | Comma-separated stage list for `test:e2e:real:full`; use `all` or omit for the default broad matrix |
+
+Use `npm run test:e2e:real:cleanup` to list recorded disposable resources. OpenYida does not yet expose a safe app/form deletion command, so cleanup is intentionally a registry-backed audit step rather than an automatic destructive action.
+
 ### Connectors, Integrations, and Reports
 
 ```bash

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openyida",
-  "version": "2026.5.9-beta.9",
+  "version": "2026.5.9",
   "description": "OpenYida CLI - 宜搭低代码 AI 开发工具（安装即用，零配置）",
   "bin": {
     "openyida": "bin/yida.js",
@@ -22,6 +22,10 @@
   "scripts": {
     "test": "jest",
     "test:unit": "jest",
+    "test:e2e:real": "node scripts/e2e-real/runner.js",
+    "test:e2e:real:full": "node scripts/e2e-real/full-runner.js",
+    "test:e2e:real:skills": "node scripts/e2e-real/skill-coverage.js",
+    "test:e2e:real:cleanup": "node scripts/e2e-real/cleanup.js",
     "test:coverage": "jest --coverage",
     "lint": "eslint bin/ lib/ scripts/ tests/ --ext .js",
     "lint:fix": "eslint bin/ lib/ scripts/ tests/ --ext .js --fix",

package/scripts/e2e-real/cleanup.js

@@ -0,0 +1,67 @@
+#!/usr/bin/env node
+
+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+
+const ROOT = path.resolve(__dirname, '..', '..');
+const DEFAULT_REGISTRY_DIR = path.join(ROOT, 'project', '.cache', 'e2e-real');
+
+function getRegistryDir(env = process.env) {
+  return env.OPENYIDA_E2E_REGISTRY_DIR || DEFAULT_REGISTRY_DIR;
+}
+
+function listRegistries(registryDir = getRegistryDir()) {
+  if (!fs.existsSync(registryDir)) {return [];}
+  return fs.readdirSync(registryDir)
+    .filter((file) => file.endsWith('.json'))
+    .map((file) => {
+      const registryPath = path.join(registryDir, file);
+      const registry = JSON.parse(fs.readFileSync(registryPath, 'utf8'));
+      return { registryPath, registry };
+    })
+    .sort((a, b) => String(a.registry.startedAt || '').localeCompare(String(b.registry.startedAt || '')));
+}
+
+function printSummary(items) {
+  if (items.length === 0) {
+    console.log('No real E2E registries found.');
+    return;
+  }
+
+  for (const item of items) {
+    const registry = item.registry;
+    console.log(`\n${registry.runId || path.basename(item.registryPath)} [${registry.status || 'unknown'}]`);
+    console.log(`Registry: ${item.registryPath}`);
+    for (const resource of registry.resources || []) {
+      const id = resource.appType || resource.formUuid || resource.pageId || 'unknown';
+      const secondary = resource.formUuid || resource.pageId || '';
+      console.log(`- ${resource.type}: ${id}${secondary && secondary !== id ? ` / ${secondary}` : ''} ${resource.name || ''}`);
+    }
+  }
+
+  console.log('\nOpenYida does not yet expose a safe app/form deletion command, so this script lists disposable resources recorded by real E2E runs for manual cleanup.');
+}
+
+function run(options = {}) {
+  const registryDir = options.registryDir || getRegistryDir(options.env || process.env);
+  const items = listRegistries(registryDir);
+  printSummary(items);
+  return items;
+}
+
+if (require.main === module) {
+  try {
+    run();
+  } catch (error) {
+    console.error(error.message);
+    process.exit(1);
+  }
+}
+
+module.exports = {
+  getRegistryDir,
+  listRegistries,
+  run,
+};

package/scripts/e2e-real/fixtures/form-fields.json

@@ -0,0 +1,18 @@
+[
+  {
+    "type": "TextField",
+    "label": "E2E Text",
+    "required": true,
+    "placeholder": "Created by OpenYida real E2E"
+  },
+  {
+    "type": "NumberField",
+    "label": "E2E Number",
+    "placeholder": "123"
+  },
+  {
+    "type": "SelectField",
+    "label": "E2E Status",
+    "options": ["New", "Done"]
+  }
+]