expo-harmony-toolkit 1.8.3 → 1.9.0

package/README.en.md

@@ -1,6 +1,6 @@
 <div align="center">
   <h1>Expo Harmony Toolkit</h1>
-  <p><strong>A HarmonyOS migration, admission, and UI-stack build toolkit for Managed/CNG Expo projects.</strong></p>
+  <p><strong>A HarmonyOS migration, admission, and UI-stack build toolkit for Managed/CNG Expo projects, now with a bare intake baseline.</strong></p>
   <p>One verified UI-stack matrix, additive preview/experimental capability tiers, managed Harmony sidecar scaffolding, and a toolkit-driven <code>doctor → init → bundle → build-hap</code> path.</p>
   <p>
     <a href="./README.md">简体中文</a> ·
@@ -9,9 +9,9 @@
   <p>
     <a href="https://github.com/BlackishGreen33/Expo-Harmony-Toolkit/actions/workflows/ci.yml"><img alt="Checks" src="https://img.shields.io/badge/checks-passing-16a34a?style=flat-square&logo=githubactions&logoColor=white"></a>
     <a href="./LICENSE"><img alt="License" src="https://img.shields.io/badge/license-MIT-0f766e?style=flat-square"></a>
-    <a href="https://github.com/BlackishGreen33/Expo-Harmony-Toolkit/releases"><img alt="Version" src="https://img.shields.io/badge/version-v1.8.3-111827?style=flat-square"></a>
+    <a href="https://github.com/BlackishGreen33/Expo-Harmony-Toolkit/releases"><img alt="Version" src="https://img.shields.io/badge/version-v1.9.0-111827?style=flat-square"></a>
     <a href="./docs/support-matrix.md"><img alt="Matrix" src="https://img.shields.io/badge/matrix-expo55--rnoh082--ui--stack-2563eb?style=flat-square"></a>
-    <img alt="Input" src="https://img.shields.io/badge/input-Managed%2FCNG-059669?style=flat-square">
+    <img alt="Input" src="https://img.shields.io/badge/input-Managed%2FCNG%20%2B%20bare%20intake-059669?style=flat-square">
   </p>
   <p>
     <a href="./docs/support-matrix.md">Support Matrix</a> ·
@@ -24,7 +24,7 @@
 </div>
 
 > [!IMPORTANT]
-> `v1.8` keeps the `verified + preview + experimental` model and continues to keep `expo-location` and `expo-camera` in `preview`. The public promise remains tighter: `latest` only carries fully accepted `verified` capabilities, while `next` is reserved for preview fast-track work. The roadmap now defines `v2.0.0` itself as “reliable Harmony packaging for any Expo project”, so the intermediate versions will keep getting split smaller, but that still does not widen the current `verified` boundary yet.
+> `v1.9.0` keeps the `verified + preview + experimental` model and brings bare workflow intake, five app foundation modules, and the `react-native-gesture-handler` formal slice onto the mainline tracker. The public promise remains tighter: `latest` only carries fully accepted `verified` capabilities, while `next` is reserved for preview fast-track work. The expanded goal still does not widen the current `verified` boundary yet.
 
 > [!TIP]
 > The two validated `@react-native-oh-tpl/*` adapters in the public matrix are currently consumed via exact Git URLs and commits. For repository development and the official UI-stack sample, prefer `pnpm install --ignore-scripts` so adapter prepare hooks do not fail on private upstream resources.
@@ -48,12 +48,12 @@
 <!-- GENERATED:readme-current-status:start -->
 | Item | Status |
 | --- | --- |
-| Current version | `v1.8.3` |
+| Current version | `v1.9.0` |
 | Support model | `verified + preview + experimental` |
 | Public `verified` matrix | `expo55-rnoh082-ui-stack` |
-| Supported input | Managed/CNG Expo projects |
+| Supported input | Managed/CNG Expo projects; bare workflow intake baseline |
 | `verified` JS/UI capabilities | `expo-router`, `expo-linking`, `expo-constants`, `react-native-reanimated`, `react-native-svg` |
-| `preview` native capabilities | `expo-file-system`, `expo-image-picker`, `expo-location`, `expo-camera` |
+| `preview` native capabilities | `expo-file-system`, `expo-image-picker`, `expo-location`, `expo-camera`, `expo-secure-store`, `expo-asset`, `expo-device`, `expo-clipboard`, `expo-haptics` |
 | `experimental` capabilities | `expo-notifications`, `react-native-gesture-handler` |
 | Release tracks | `latest` = fully accepted `verified` only; `next` = preview fast track |
 | Capability telemetry | `runtimeMode` + `evidence(...)` + `evidenceSource(...)` + `coverageProfile` + `nextActions` |
@@ -66,10 +66,11 @@
 <details>
 <summary><strong>Still outside the verified public promise</strong></summary>
 
-- bare Expo
+- bare Expo still only reaches the intake baseline
 - `expo-file-system`, `expo-image-picker`, `expo-location`, and `expo-camera` remain `preview`
+- `expo-secure-store`, `expo-asset`, `expo-device`, `expo-clipboard`, and `expo-haptics` remain the `preview` shim baseline
 - `expo-notifications`
-- `react-native-gesture-handler`
+- `react-native-gesture-handler` remains a formal experimental slice
 - multiple public matrices
 
 </details>
@@ -174,7 +175,7 @@ Common decision points:
 
 <!-- GENERATED:readme-support-matrix:start -->
 - `verified`: the only public matrix remains `expo55-rnoh082-ui-stack`
-- `preview`: `expo-file-system`, `expo-image-picker`, `expo-location`, `expo-camera`
+- `preview`: `expo-file-system`, `expo-image-picker`, `expo-location`, `expo-camera`, `expo-secure-store`, `expo-asset`, `expo-device`, `expo-clipboard`, `expo-haptics`
 - `experimental`: `expo-notifications`, `react-native-gesture-handler`
 
 `doctor --strict` still means `verified` only. `doctor --target-tier preview` allows the same runtime matrix plus preview-tier capabilities, but that does not promote them into the formal public promise.
@@ -198,7 +199,7 @@ If you want the `v1.8.x` promotion board directly, use [acceptance/v1.8.x-capabi
 - `examples/official-ui-stack-sample`
   The current public main sample, covering router, linking, constants, SVG, reanimated, and the Harmony sidecar build flow.
 - `examples/official-native-capabilities-sample`
-  The `v1.8.x` preview walkthrough sample, covering the supported core subsets for `expo-file-system`, `expo-image-picker`, `expo-location`, and `expo-camera` plus permission, bundle, debug-build validation, and per-capability acceptance tracking.
+  Preview walkthrough sample for `expo-file-system`, `expo-image-picker`, `expo-location`, `expo-camera`, and the v1.9 app foundation modules, keeping core subsets, permissions, bundle/debug evidence, and per-capability acceptance tracking explicit.
 - `examples/official-app-shell-sample`
   The minimal App Shell onboarding sample that demonstrates router, linking, constants, pathname, observed URL, and a generated deep-link flow.
 - `examples/official-minimal-sample`

package/README.md

@@ -1,6 +1,6 @@
 <div align="center">
   <h1>Expo Harmony Toolkit</h1>
-  <p><strong>面向 Managed/CNG Expo 项目的 HarmonyOS 迁移、准入检查与 UI-stack 构建工具链。</strong></p>
+  <p><strong>面向 Managed/CNG Expo 项目，并开始纳入 bare intake baseline 的 HarmonyOS 迁移、准入检查与 UI-stack 构建工具链。</strong></p>
   <p>One verified UI-stack matrix, additive preview/experimental capability tiers, managed Harmony sidecar scaffolding, and a toolkit-driven <code>doctor → init → bundle → build-hap</code> path.</p>
   <p>
     <a href="./README.md">简体中文</a> ·
@@ -9,9 +9,9 @@
   <p>
     <a href="https://github.com/BlackishGreen33/Expo-Harmony-Toolkit/actions/workflows/ci.yml"><img alt="Checks" src="https://img.shields.io/badge/checks-passing-16a34a?style=flat-square&logo=githubactions&logoColor=white"></a>
     <a href="./LICENSE"><img alt="License" src="https://img.shields.io/badge/license-MIT-0f766e?style=flat-square"></a>
-    <a href="https://github.com/BlackishGreen33/Expo-Harmony-Toolkit/releases"><img alt="Version" src="https://img.shields.io/badge/version-v1.8.3-111827?style=flat-square"></a>
+    <a href="https://github.com/BlackishGreen33/Expo-Harmony-Toolkit/releases"><img alt="Version" src="https://img.shields.io/badge/version-v1.9.0-111827?style=flat-square"></a>
     <a href="./docs/support-matrix.md"><img alt="Matrix" src="https://img.shields.io/badge/matrix-expo55--rnoh082--ui--stack-2563eb?style=flat-square"></a>
-    <img alt="Input" src="https://img.shields.io/badge/input-Managed%2FCNG-059669?style=flat-square">
+    <img alt="Input" src="https://img.shields.io/badge/input-Managed%2FCNG%20%2B%20bare%20intake-059669?style=flat-square">
   </p>
   <p>
     <a href="./docs/support-matrix.md">支持矩阵</a> ·
@@ -24,7 +24,7 @@
 </div>
 
 > [!IMPORTANT]
-> `v1.8` 延续 `verified + preview + experimental` 三层支持模型，并把 `expo-location`、`expo-camera` 继续保持在 `preview`。当前公开承诺仍然收紧为：`latest` 只承诺完整验收的 `verified` 能力，`next` 用于 preview fast track。最新 roadmap 已把 `v2.0.0` 直接定义成“任何 Expo 项目都能可靠打包成鸿蒙 App”，因此中间版本会继续拆小，但这不等于当前 `verified` 边界已经放宽。
+> `v1.9.0` 延续 `verified + preview + experimental` 三层支持模型，并把 bare workflow intake、五个 app foundation modules 与 `react-native-gesture-handler` formal slice 纳入主线追踪。当前公开承诺仍然收紧为：`latest` 只承诺完整验收的 `verified` 能力，`next` 用于 preview fast track。目标扩大不等于当前 `verified` 边界已经放宽。
 
 > [!TIP]
 > 由于当前公开矩阵内的两套 `@react-native-oh-tpl/*` adapter 依赖以 Git URL + exact commit 形式接入，仓库开发和官方 UI-stack sample 推荐使用 `pnpm install --ignore-scripts`，避免 Git adapter 在 prepare 阶段拉取私有资源而中断安装。
@@ -48,12 +48,12 @@
 <!-- GENERATED:readme-current-status:start -->
 | 项目 | 说明 |
 | --- | --- |
-| 当前版本 | `v1.8.3` |
+| 当前版本 | `v1.9.0` |
 | 支持模型 | `verified + preview + experimental` |
 | 唯一 `verified` 公开矩阵 | `expo55-rnoh082-ui-stack` |
-| 输入范围 | Managed/CNG Expo 项目 |
+| 输入范围 | Managed/CNG Expo 项目；bare workflow intake baseline |
 | `verified` JS/UI 能力 | `expo-router`、`expo-linking`、`expo-constants`、`react-native-reanimated`、`react-native-svg` |
-| `preview` 原生能力 | `expo-file-system`、`expo-image-picker`、`expo-location`、`expo-camera` |
+| `preview` 原生能力 | `expo-file-system`、`expo-image-picker`、`expo-location`、`expo-camera`、`expo-secure-store`、`expo-asset`、`expo-device`、`expo-clipboard`、`expo-haptics` |
 | `experimental` 能力 | `expo-notifications`、`react-native-gesture-handler` |
 | 发布轨 | `latest` = fully accepted verified only；`next` = preview fast track |
 | capability 遥测 | `runtimeMode` + `evidence(...)` + `evidenceSource(...)` + `coverageProfile` + `nextActions` |
@@ -66,10 +66,11 @@
 <details>
 <summary><strong>当前仍不在 verified 正式承诺范围</strong></summary>
 
-- bare Expo
+- bare Expo 仍只到 intake baseline
 - `expo-file-system`、`expo-image-picker`、`expo-location`、`expo-camera` 仍只属于 `preview`
+- `expo-secure-store`、`expo-asset`、`expo-device`、`expo-clipboard`、`expo-haptics` 仍只属于 `preview` shim baseline
 - `expo-notifications`
-- `react-native-gesture-handler`
+- `react-native-gesture-handler` 仍只属于 formal experimental slice
 - 多矩阵并行支持
 
 </details>
@@ -174,7 +175,7 @@ pnpm exec expo-harmony build-hap --mode release
 
 <!-- GENERATED:readme-support-matrix:start -->
 - `verified`：唯一公开矩阵仍是 `expo55-rnoh082-ui-stack`
-- `preview`：`expo-file-system`, `expo-image-picker`, `expo-location`, `expo-camera`
+- `preview`：`expo-file-system`, `expo-image-picker`, `expo-location`, `expo-camera`, `expo-secure-store`, `expo-asset`, `expo-device`, `expo-clipboard`, `expo-haptics`
 - `experimental`：`expo-notifications`, `react-native-gesture-handler`
 
 `doctor --strict` 继续只代表 `verified`。`doctor --target-tier preview` 会在同一 runtime matrix 下额外放行 preview 能力，但这不等于它们已经进入正式承诺。
@@ -204,7 +205,7 @@ pnpm exec expo-harmony build-hap --mode release
 - `examples/official-ui-stack-sample`
   当前唯一对外主 sample，同时覆盖 router、linking、constants、SVG、reanimated 和 Harmony sidecar 构建链。
 - `examples/official-native-capabilities-sample`
-  `v1.8.x` 的 preview walkthrough sample，用来承接 `expo-file-system`、`expo-image-picker`、`expo-location`、`expo-camera` 的核心支持子集、permission、bundle、debug build 与逐 capability 验收追踪。
+  preview walkthrough sample，用来承接 `expo-file-system`、`expo-image-picker`、`expo-location`、`expo-camera` 与 v1.9 app foundation modules 的核心支持子集、permission、bundle、debug build 与逐 capability 验收追踪。
 - `examples/official-app-shell-sample`
   最小可理解的 App Shell onboarding sample，用来展示 router、linking、constants、pathname、observed URL 与 generated deep link。
 - `examples/official-minimal-sample`

package/build/core/constants.d.ts

@@ -1,6 +1,6 @@
 export declare const TOOLKIT_PACKAGE_NAME = "expo-harmony-toolkit";
 export declare const CLI_NAME = "expo-harmony";
-export declare const TOOLKIT_VERSION = "1.8.3";
+export declare const TOOLKIT_VERSION = "1.9.0";
 export declare const TEMPLATE_VERSION = "rnoh-0.82.29";
 export declare const RNOH_VERSION = "0.82.29";
 export declare const RNOH_CLI_VERSION = "0.82.29";

package/build/core/constants.js

@@ -3,7 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.DESIRED_PACKAGE_SCRIPTS = exports.HARMONY_RUNTIME_PRELUDE_RELATIVE_PATH = exports.HARMONY_ROUTER_ENTRY_FILENAME = exports.STRICT_ENV_EXIT_CODE = exports.STRICT_DOCTOR_EXIT_CODE = exports.DEFAULT_HVIGOR_PLUGIN_FILENAME = exports.PREBUILD_METADATA_FILENAME = exports.TOOLKIT_CONFIG_FILENAME = exports.BUILD_REPORT_FILENAME = exports.ENV_REPORT_FILENAME = exports.DOCTOR_REPORT_FILENAME = exports.MANIFEST_FILENAME = exports.SIGNING_LOCAL_EXAMPLE_FILENAME = exports.SIGNING_LOCAL_FILENAME = exports.GENERATED_SHIMS_DIR = exports.GENERATED_DIR = exports.SUPPORTED_EXPO_SDKS = exports.RNOH_CLI_VERSION = exports.RNOH_VERSION = exports.TEMPLATE_VERSION = exports.TOOLKIT_VERSION = exports.CLI_NAME = exports.TOOLKIT_PACKAGE_NAME = void 0;
 exports.TOOLKIT_PACKAGE_NAME = 'expo-harmony-toolkit';
 exports.CLI_NAME = 'expo-harmony';
-exports.TOOLKIT_VERSION = '1.8.3';
+exports.TOOLKIT_VERSION = '1.9.0';
 exports.TEMPLATE_VERSION = 'rnoh-0.82.29';
 exports.RNOH_VERSION = '0.82.29';
 exports.RNOH_CLI_VERSION = '0.82.29';

package/build/core/report.js

@@ -25,6 +25,12 @@ const DEFAULT_RECORD = {
 };
 const BARE_WORKFLOW_DIRECTORY_NAMES = ['android', 'ios'];
 const BARE_WORKFLOW_DEPENDENCIES = new Set(['expo-build-properties', 'expo-dev-client']);
+const FORMAL_EXPERIMENTAL_ADAPTER_PAIRS = [
+    {
+        canonicalPackageName: 'react-native-gesture-handler',
+        adapterPackageName: '@react-native-oh-tpl/react-native-gesture-handler',
+    },
+];
 async function buildDoctorReport(projectRoot, options = {}) {
     const loadedProject = await (0, project_1.loadProject)(projectRoot);
     const doctorConfig = (0, project_1.resolveExpoHarmonyDoctorConfig)(loadedProject.expoConfig);
@@ -329,6 +335,24 @@ async function collectBlockingIssues(projectRoot, expoConfig, packageJson, expoP
             });
         }
     }
+    for (const pairing of FORMAL_EXPERIMENTAL_ADAPTER_PAIRS) {
+        const hasCanonical = dependencyMap.has(pairing.canonicalPackageName);
+        const hasAdapter = dependencyMap.has(pairing.adapterPackageName);
+        if (hasCanonical && !hasAdapter) {
+            issues.push({
+                code: 'dependency.required_missing',
+                message: `Using ${pairing.canonicalPackageName} in its formal experimental Harmony slice also requires ${pairing.adapterPackageName}.`,
+                subject: pairing.adapterPackageName,
+            });
+        }
+        if (hasAdapter && !hasCanonical) {
+            issues.push({
+                code: 'dependency.required_missing',
+                message: `Using ${pairing.adapterPackageName} in its formal experimental Harmony slice also requires ${pairing.canonicalPackageName}.`,
+                subject: pairing.canonicalPackageName,
+            });
+        }
+    }
     if (!expoConfig.android?.package && !expoConfig.ios?.bundleIdentifier) {
         issues.push({
             code: 'config.native_identifier.missing',
@@ -392,14 +416,14 @@ function resolveDependencyGapCategory(dependency, coverageProfile) {
             dependency.name === 'react-native')) {
         return 'bare-workflow-gap';
     }
+    if (isThirdPartyNativeGapDependency(dependency)) {
+        return 'third-party-native-gap';
+    }
     if (isOfficialExpoDependencyName(dependency.name) || capabilities_1.CAPABILITY_BY_PACKAGE[dependency.name]) {
         return dependency.supportTier === 'verified' && dependency.status === 'supported'
             ? 'matrix-drift'
             : 'official-module-gap';
     }
-    if (isThirdPartyNativeGapDependency(dependency)) {
-        return 'third-party-native-gap';
-    }
     if (coverageProfile === 'bare') {
         return 'bare-workflow-gap';
     }
@@ -462,7 +486,7 @@ function buildNextActions(input) {
     if (blockingIssues.some((issue) => issue.code === 'dependency.not_allowed' &&
         (issue.subject === 'react-native-gesture-handler' ||
             issue.subject === '@react-native-oh-tpl/react-native-gesture-handler'))) {
-        actions.push('Keep `react-native-gesture-handler` out of the verified lane until its Harmony adapter path has stable doctor, sample, and build coverage.');
+        actions.push('Keep `react-native-gesture-handler` on the formal experimental slice until its Harmony adapter path closes device and release evidence.');
     }
     if (hasBlockingIssueCode(blockingIssues, 'config.native_identifier.missing')) {
         actions.push('Set `android.package` or `ios.bundleIdentifier` in Expo config before expecting a strict Harmony build path.');

package/build/core/template/capabilityRegistry.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.MANAGED_EXPO_HARMONY_MODULE_RENDERERS = void 0;
 exports.renderCapabilityModuleShim = renderCapabilityModuleShim;
 exports.renderUnsupportedCapabilityShim = renderUnsupportedCapabilityShim;
+const appFoundation_1 = require("./renderers/appFoundation");
 const camera_1 = require("./renderers/camera");
 const fileSystem_1 = require("./renderers/fileSystem");
 const imagePicker_1 = require("./renderers/imagePicker");
@@ -24,6 +25,26 @@ const CAPABILITY_SHIM_RENDERERS = {
         adapter: camera_1.renderExpoCameraHarmonyAdapterShim,
         preview: camera_1.renderExpoCameraPreviewShim,
     },
+    'expo-secure-store': {
+        adapter: appFoundation_1.renderExpoSecureStorePreviewShim,
+        preview: appFoundation_1.renderExpoSecureStorePreviewShim,
+    },
+    'expo-asset': {
+        adapter: appFoundation_1.renderExpoAssetPreviewShim,
+        preview: appFoundation_1.renderExpoAssetPreviewShim,
+    },
+    'expo-device': {
+        adapter: appFoundation_1.renderExpoDevicePreviewShim,
+        preview: appFoundation_1.renderExpoDevicePreviewShim,
+    },
+    'expo-clipboard': {
+        adapter: appFoundation_1.renderExpoClipboardPreviewShim,
+        preview: appFoundation_1.renderExpoClipboardPreviewShim,
+    },
+    'expo-haptics': {
+        adapter: appFoundation_1.renderExpoHapticsPreviewShim,
+        preview: appFoundation_1.renderExpoHapticsPreviewShim,
+    },
 };
 exports.MANAGED_EXPO_HARMONY_MODULE_RENDERERS = [
     {

package/build/core/template/renderers/appFoundation.d.ts

@@ -0,0 +1,5 @@
+export declare function renderExpoSecureStorePreviewShim(): string;
+export declare function renderExpoAssetPreviewShim(): string;
+export declare function renderExpoDevicePreviewShim(): string;
+export declare function renderExpoClipboardPreviewShim(): string;
+export declare function renderExpoHapticsPreviewShim(): string;

package/build/core/template/renderers/appFoundation.js

@@ -0,0 +1,225 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.renderExpoSecureStorePreviewShim = renderExpoSecureStorePreviewShim;
+exports.renderExpoAssetPreviewShim = renderExpoAssetPreviewShim;
+exports.renderExpoDevicePreviewShim = renderExpoDevicePreviewShim;
+exports.renderExpoClipboardPreviewShim = renderExpoClipboardPreviewShim;
+exports.renderExpoHapticsPreviewShim = renderExpoHapticsPreviewShim;
+function renderExpoSecureStorePreviewShim() {
+    return `'use strict';
+
+const secureStore = new Map();
+
+async function isAvailableAsync() {
+  return true;
+}
+
+async function setItemAsync(key, value) {
+  secureStore.set(String(key), String(value));
+}
+
+async function getItemAsync(key) {
+  const normalizedKey = String(key);
+  return secureStore.has(normalizedKey) ? secureStore.get(normalizedKey) : null;
+}
+
+async function deleteItemAsync(key) {
+  secureStore.delete(String(key));
+}
+
+module.exports = {
+  AFTER_FIRST_UNLOCK: 'AFTER_FIRST_UNLOCK',
+  AFTER_FIRST_UNLOCK_THIS_DEVICE_ONLY: 'AFTER_FIRST_UNLOCK_THIS_DEVICE_ONLY',
+  ALWAYS: 'ALWAYS',
+  ALWAYS_THIS_DEVICE_ONLY: 'ALWAYS_THIS_DEVICE_ONLY',
+  WHEN_PASSCODE_SET_THIS_DEVICE_ONLY: 'WHEN_PASSCODE_SET_THIS_DEVICE_ONLY',
+  WHEN_UNLOCKED: 'WHEN_UNLOCKED',
+  WHEN_UNLOCKED_THIS_DEVICE_ONLY: 'WHEN_UNLOCKED_THIS_DEVICE_ONLY',
+  isAvailableAsync,
+  setItemAsync,
+  getItemAsync,
+  deleteItemAsync,
+};
+`;
+}
+function renderExpoAssetPreviewShim() {
+    return `'use strict';
+
+class Asset {
+  constructor(input) {
+    this.name = input.name ?? null;
+    this.type = input.type ?? null;
+    this.hash = input.hash ?? null;
+    this.uri = input.uri;
+    this.localUri = input.localUri ?? input.uri;
+    this.width = input.width ?? null;
+    this.height = input.height ?? null;
+    this.downloaded = Boolean(input.downloaded);
+  }
+
+  static fromURI(uri) {
+    return new Asset({
+      name: String(uri).split('/').pop() || 'remote-asset',
+      uri: String(uri),
+      downloaded: true,
+    });
+  }
+
+  static fromModule(moduleId) {
+    if (typeof moduleId === 'string') {
+      return Asset.fromURI(moduleId);
+    }
+
+    return new Asset({
+      name: 'expo-harmony-module-asset',
+      uri: 'asset://' + String(moduleId),
+      localUri: 'asset://' + String(moduleId),
+    });
+  }
+
+  static async loadAsync(moduleIds) {
+    return loadAsync(moduleIds);
+  }
+
+  async downloadAsync() {
+    this.downloaded = true;
+    this.localUri = this.localUri ?? this.uri;
+    return this;
+  }
+}
+
+async function loadAsync(moduleIds) {
+  const input = Array.isArray(moduleIds) ? moduleIds : [moduleIds];
+  return Promise.all(input.map((moduleId) => Asset.fromModule(moduleId).downloadAsync()));
+}
+
+function useAssets() {
+  return [null, null];
+}
+
+module.exports = {
+  Asset,
+  loadAsync,
+  useAssets,
+};
+`;
+}
+function renderExpoDevicePreviewShim() {
+    return `'use strict';
+
+const DeviceType = {
+  UNKNOWN: 0,
+  PHONE: 1,
+  TABLET: 2,
+  DESKTOP: 3,
+  TV: 4,
+};
+
+async function getDeviceTypeAsync() {
+  return DeviceType.UNKNOWN;
+}
+
+module.exports = {
+  DeviceType,
+  brand: 'OpenHarmony',
+  manufacturer: 'OpenHarmony',
+  modelName: 'Harmony preview device',
+  modelId: null,
+  designName: null,
+  productName: 'expo-harmony-preview',
+  deviceYearClass: null,
+  totalMemory: null,
+  supportedCpuArchitectures: [],
+  osName: 'HarmonyOS',
+  osVersion: 'preview',
+  osBuildId: null,
+  osInternalBuildId: null,
+  osBuildFingerprint: null,
+  platformApiLevel: null,
+  deviceName: 'Harmony preview device',
+  isDevice: true,
+  getDeviceTypeAsync,
+};
+`;
+}
+function renderExpoClipboardPreviewShim() {
+    return `'use strict';
+
+let clipboardString = '';
+let clipboardUrl = null;
+let clipboardImage = null;
+
+async function setStringAsync(value) {
+  clipboardString = String(value);
+  clipboardUrl = null;
+  return true;
+}
+
+async function getStringAsync() {
+  return clipboardString;
+}
+
+async function hasStringAsync() {
+  return clipboardString.length > 0;
+}
+
+async function setUrlAsync(value) {
+  clipboardUrl = String(value);
+  clipboardString = clipboardUrl;
+}
+
+async function getUrlAsync() {
+  return clipboardUrl;
+}
+
+async function setImageAsync(value) {
+  clipboardImage = String(value);
+}
+
+async function getImageAsync() {
+  return clipboardImage;
+}
+
+module.exports = {
+  setStringAsync,
+  getStringAsync,
+  hasStringAsync,
+  setUrlAsync,
+  getUrlAsync,
+  setImageAsync,
+  getImageAsync,
+};
+`;
+}
+function renderExpoHapticsPreviewShim() {
+    return `'use strict';
+
+const ImpactFeedbackStyle = {
+  Light: 'light',
+  Medium: 'medium',
+  Heavy: 'heavy',
+  Rigid: 'rigid',
+  Soft: 'soft',
+};
+
+const NotificationFeedbackType = {
+  Success: 'success',
+  Warning: 'warning',
+  Error: 'error',
+};
+
+async function selectionAsync() {}
+
+async function impactAsync() {}
+
+async function notificationAsync() {}
+
+module.exports = {
+  ImpactFeedbackStyle,
+  NotificationFeedbackType,
+  selectionAsync,
+  impactAsync,
+  notificationAsync,
+};
+`;
+}

package/build/data/capabilities.js

@@ -30,6 +30,18 @@ const EXPLORATORY_EVIDENCE_SOURCE = {
     device: 'none',
     release: 'none',
 };
+const APP_FOUNDATION_BASELINE_EVIDENCE = {
+    bundle: true,
+    debugBuild: true,
+    device: false,
+    release: false,
+};
+const APP_FOUNDATION_BASELINE_EVIDENCE_SOURCE = {
+    bundle: 'automated',
+    debugBuild: 'automated',
+    device: 'none',
+    release: 'none',
+};
 exports.CAPABILITY_DEFINITIONS = [
     {
         id: 'expo-file-system',
@@ -116,6 +128,101 @@ exports.CAPABILITY_DEFINITIONS = [
             'Exercise preview pause/resume plus denied or canceled outcomes without crashing the Harmony runtime.',
         ],
     },
+    {
+        id: 'expo-secure-store',
+        packageName: 'expo-secure-store',
+        status: 'manual',
+        supportTier: 'preview',
+        runtimeMode: 'shim',
+        evidence: APP_FOUNDATION_BASELINE_EVIDENCE,
+        evidenceSource: APP_FOUNDATION_BASELINE_EVIDENCE_SOURCE,
+        note: 'v1.9.0 app-foundation baseline provides a toolkit-managed session shim for secure-store API shape, keeping real encrypted Harmony storage on the promotion path before verified release parity.',
+        docsUrl: 'https://docs.expo.dev/versions/latest/sdk/securestore/',
+        nativePackageNames: [],
+        harmonyPermissions: [],
+        sampleRoute: '/secure-store',
+        acceptanceChecklist: [
+            'Write a sample key with setItemAsync and read it back in the same JS session.',
+            'Delete the sample key and verify getItemAsync returns null.',
+            'Keep device persistence and encrypted backend behavior out of verified until native evidence is recorded.',
+        ],
+    },
+    {
+        id: 'expo-asset',
+        packageName: 'expo-asset',
+        status: 'manual',
+        supportTier: 'preview',
+        runtimeMode: 'shim',
+        evidence: APP_FOUNDATION_BASELINE_EVIDENCE,
+        evidenceSource: APP_FOUNDATION_BASELINE_EVIDENCE_SOURCE,
+        note: 'v1.9.0 app-foundation baseline keeps the Asset API bundle-safe on Harmony while native asset resolution and cache semantics remain promotion evidence.',
+        docsUrl: 'https://docs.expo.dev/versions/latest/sdk/asset/',
+        nativePackageNames: [],
+        harmonyPermissions: [],
+        sampleRoute: '/asset',
+        acceptanceChecklist: [
+            'Create an Asset from a URI and expose deterministic metadata.',
+            'Resolve loadAsync for one or more module identifiers without crashing the Harmony bundle.',
+            'Keep native resource resolution and cache parity pending device and release evidence.',
+        ],
+    },
+    {
+        id: 'expo-device',
+        packageName: 'expo-device',
+        status: 'manual',
+        supportTier: 'preview',
+        runtimeMode: 'shim',
+        evidence: APP_FOUNDATION_BASELINE_EVIDENCE,
+        evidenceSource: APP_FOUNDATION_BASELINE_EVIDENCE_SOURCE,
+        note: 'v1.9.0 app-foundation baseline exposes stable Harmony placeholder device metadata for JS startup paths; real hardware metadata remains outside verified.',
+        docsUrl: 'https://docs.expo.dev/versions/latest/sdk/device/',
+        nativePackageNames: [],
+        harmonyPermissions: [],
+        sampleRoute: '/device',
+        acceptanceChecklist: [
+            'Read stable device metadata constants without native module crashes.',
+            'Resolve getDeviceTypeAsync with an explicit preview value.',
+            'Record real hardware metadata behavior separately before promotion.',
+        ],
+    },
+    {
+        id: 'expo-clipboard',
+        packageName: 'expo-clipboard',
+        status: 'manual',
+        supportTier: 'preview',
+        runtimeMode: 'shim',
+        evidence: APP_FOUNDATION_BASELINE_EVIDENCE,
+        evidenceSource: APP_FOUNDATION_BASELINE_EVIDENCE_SOURCE,
+        note: 'v1.9.0 app-foundation baseline keeps clipboard reads and writes bundle-safe through a session shim while the Harmony clipboard adapter remains the native promotion path.',
+        docsUrl: 'https://docs.expo.dev/versions/latest/sdk/clipboard/',
+        nativePackageNames: ['@react-native-oh-tpl/clipboard'],
+        harmonyPermissions: [],
+        sampleRoute: '/clipboard',
+        acceptanceChecklist: [
+            'Write a string through setStringAsync and read it back with getStringAsync.',
+            'Expose hasStringAsync and URL helpers without crashing app-shell startup.',
+            'Validate real system pasteboard behavior on device before verified promotion.',
+        ],
+    },
+    {
+        id: 'expo-haptics',
+        packageName: 'expo-haptics',
+        status: 'manual',
+        supportTier: 'preview',
+        runtimeMode: 'shim',
+        evidence: APP_FOUNDATION_BASELINE_EVIDENCE,
+        evidenceSource: APP_FOUNDATION_BASELINE_EVIDENCE_SOURCE,
+        note: 'v1.9.0 app-foundation baseline makes haptics calls no-op safely on Harmony until a real device vibration path is validated.',
+        docsUrl: 'https://docs.expo.dev/versions/latest/sdk/haptics/',
+        nativePackageNames: [],
+        harmonyPermissions: [],
+        sampleRoute: '/haptics',
+        acceptanceChecklist: [
+            'Resolve selectionAsync, impactAsync, and notificationAsync without throwing.',
+            'Expose Expo haptics enum values used by common app startup paths.',
+            'Keep physical haptic feedback pending device evidence.',
+        ],
+    },
     {
         id: 'expo-notifications',
         packageName: 'expo-notifications',
@@ -135,6 +242,25 @@ exports.CAPABILITY_DEFINITIONS = [
             'Validate open-from-notification lifecycle.',
         ],
     },
+    {
+        id: 'react-native-gesture-handler',
+        packageName: 'react-native-gesture-handler',
+        status: 'manual',
+        supportTier: 'experimental',
+        runtimeMode: 'adapter',
+        evidence: APP_FOUNDATION_BASELINE_EVIDENCE,
+        evidenceSource: APP_FOUNDATION_BASELINE_EVIDENCE_SOURCE,
+        note: 'v1.9.0 formal acceptance slice tracks Gesture Handler through its Harmony adapter, but it remains experimental until device and release runtime evidence are closed.',
+        docsUrl: 'https://github.com/react-native-oh-library/react-native-harmony-gesture-handler',
+        nativePackageNames: ['@react-native-oh-tpl/react-native-gesture-handler'],
+        harmonyPermissions: [],
+        sampleRoute: '/gesture-handler',
+        acceptanceChecklist: [
+            'Install the canonical package with the matching Harmony adapter.',
+            'Bundle a minimal GestureHandlerRootView and tap handler surface.',
+            'Record debug HAP evidence before any promotion decision; device and release remain separate gates.',
+        ],
+    },
 ];
 exports.CAPABILITY_BY_PACKAGE = Object.fromEntries(exports.CAPABILITY_DEFINITIONS.map((definition) => [definition.packageName, definition]));
 const SUPPORT_TIER_ORDER = {

package/build/data/dependencyCatalog.js

@@ -112,8 +112,8 @@ exports.DEPENDENCY_CATALOG = {
     },
     'expo-asset': {
         status: 'manual',
-        supportTier: 'experimental',
-        note: 'Asset handling often needs Harmony-specific verification after bundling.',
+        supportTier: 'preview',
+        note: 'v1.9.0 app-foundation baseline keeps Asset API imports and load paths bundle-safe through the toolkit shim; native asset cache parity still needs device and release evidence.',
     },
     'expo-build-properties': {
         status: 'manual',
@@ -242,10 +242,15 @@ exports.DEPENDENCY_CATALOG = {
     },
     'expo-clipboard': {
         status: 'manual',
-        supportTier: 'experimental',
-        note: 'Clipboard support should be routed through the Harmony clipboard adapter where the app needs real pasteboard access.',
+        supportTier: 'preview',
+        note: 'v1.9.0 app-foundation baseline provides a session clipboard shim and keeps the Harmony clipboard adapter as the native promotion path.',
         replacement: '@react-native-oh-tpl/clipboard',
     },
+    'expo-device': {
+        status: 'manual',
+        supportTier: 'preview',
+        note: 'v1.9.0 app-foundation baseline exposes stable Harmony placeholder device metadata while real hardware metadata remains promotion evidence.',
+    },
     'expo-dev-client': {
         status: 'manual',
         supportTier: 'experimental',
@@ -258,8 +263,8 @@ exports.DEPENDENCY_CATALOG = {
     },
     'expo-haptics': {
         status: 'manual',
-        supportTier: 'experimental',
-        note: 'Haptics require a Harmony runtime implementation before the app can claim device parity.',
+        supportTier: 'preview',
+        note: 'v1.9.0 app-foundation baseline turns haptics calls into safe no-ops until a real Harmony device feedback path is validated.',
     },
     'expo-image': {
         status: 'manual',
@@ -289,8 +294,8 @@ exports.DEPENDENCY_CATALOG = {
     },
     'expo-secure-store': {
         status: 'manual',
-        supportTier: 'experimental',
-        note: 'Secure storage must use a real Harmony secure backend or equivalent encrypted wrapper before release parity is claimed.',
+        supportTier: 'preview',
+        note: 'v1.9.0 app-foundation baseline provides a session secure-store shim; encrypted persistence still needs native device and release evidence.',
     },
     'expo-splash-screen': {
         status: 'manual',

package/build/data/publicDocs.d.ts

@@ -7,5 +7,5 @@ export declare const PREVIEW_SAMPLE_PATH = "examples/official-native-capabilitie
 export declare const SUPPORTING_SAMPLE_PATHS: readonly ["examples/official-app-shell-sample", "examples/official-minimal-sample"];
 export declare const VERIFIED_JS_UI_CAPABILITY_NAMES: readonly ["expo-router", "expo-linking", "expo-constants", ...("react-native-reanimated" | "react-native-svg")[]];
 export declare const PREVIEW_CAPABILITY_DEFINITIONS: import("..").CapabilityDefinition[];
-export declare const EXPERIMENTAL_CAPABILITY_NAMES: readonly [...string[], "react-native-gesture-handler"];
-export declare const PUBLIC_CURRENT_VERSION = "1.8.3";
+export declare const EXPERIMENTAL_CAPABILITY_NAMES: readonly string[];
+export declare const PUBLIC_CURRENT_VERSION = "1.9.0";

package/build/data/publicDocs.js

@@ -22,7 +22,6 @@ exports.VERIFIED_JS_UI_CAPABILITY_NAMES = [
 ];
 exports.PREVIEW_CAPABILITY_DEFINITIONS = capabilities_1.CAPABILITY_DEFINITIONS.filter((definition) => definition.supportTier === 'preview');
 exports.EXPERIMENTAL_CAPABILITY_NAMES = [
-    ...capabilities_1.CAPABILITY_DEFINITIONS.filter((definition) => definition.supportTier === 'experimental').map((definition) => definition.packageName),
-    'react-native-gesture-handler',
+    ...new Set(capabilities_1.CAPABILITY_DEFINITIONS.filter((definition) => definition.supportTier === 'experimental').map((definition) => definition.packageName)),
 ];
 exports.PUBLIC_CURRENT_VERSION = constants_1.TOOLKIT_VERSION;

package/build/docs/render.js

@@ -32,7 +32,9 @@ function renderReadmeCurrentStatus(locale) {
     const releaseTracksValue = locale === 'zh'
         ? `\`latest\` = ${publicDocs_1.PUBLIC_RELEASE_TRACKS.latest}；\`next\` = ${publicDocs_1.PUBLIC_RELEASE_TRACKS.next}`
         : `\`latest\` = fully accepted \`verified\` only; \`next\` = ${publicDocs_1.PUBLIC_RELEASE_TRACKS.next}`;
-    const inputValue = locale === 'zh' ? 'Managed/CNG Expo 项目' : 'Managed/CNG Expo projects';
+    const inputValue = locale === 'zh'
+        ? 'Managed/CNG Expo 项目；bare workflow intake baseline'
+        : 'Managed/CNG Expo projects; bare workflow intake baseline';
     const listJoiner = locale === 'zh' ? '、' : ', ';
     return [
         `| ${headers[0]} | ${headers[1]} |`,

package/docs/cli-build.md

@@ -1,6 +1,6 @@
 # CLI 构建指南
 
-`v1.8.0` 延续 `verified + preview + experimental` 支持分层，并把四项 preview capability 的现有 `🟠` 缺口收口到明确 `🟡` 子集，其中 `expo55-rnoh082-ui-stack` 仍是唯一 verified 矩阵。
+`v1.9.0` 延续 `verified + preview + experimental` 支持分层，把 bare workflow 放进 intake baseline，并把五个 app foundation modules 纳入 preview shim baseline；`expo55-rnoh082-ui-stack` 仍是唯一 verified 矩阵。
 
 CLI 命令集合不变：
 
@@ -39,6 +39,15 @@ expo-harmony build-hap --mode debug
 - `expo-image-picker`
 - `expo-location`
 - `expo-camera`
+- `expo-secure-store`
+- `expo-asset`
+- `expo-device`
+- `expo-clipboard`
+- `expo-haptics`
+
+当前 experimental formal slice：
+
+- `react-native-gesture-handler`
 
 ## UI stack 依赖安装注意事项
 
@@ -81,8 +90,9 @@ pnpm install --ignore-scripts
 
 额外说明：
 
-- `react-native-gesture-handler` 当前仍保留为矩阵外的手动探索项
-- `doctor --strict` 不再把它视为公开承诺的一部分
+- `react-native-gesture-handler` 已进入 formal experimental slice，但仍不属于 verified 公开承诺
+- bare workflow 当前只有 intake / debug baseline，不代表 release-ready
+- `doctor --strict` 仍只代表完整验收的 verified 能力
 
 toolkit 不会改动用户业务路由、动画逻辑或页面源码；它只负责受管 sidecar、构建链和 metadata。
 

package/docs/official-native-capabilities-sample.md

@@ -2,7 +2,7 @@
 
 路径：`examples/official-native-capabilities-sample`
 
-这个 sample 是 `v1.8.0` 的官方 preview native-capability walkthrough。它的目标不是把 preview 能力包装成 `verified`，而是把四项能力当前真实可承诺的 `🟡` 子集集中演示出来，并把 preview 边界收敛到真机 / release 证据，而不是接口缺口。
+这个 sample 是官方 preview native-capability 与 `v1.9.0` app-foundation walkthrough。它的目标不是把 preview 能力包装成 `verified`，而是把当前真实可承诺的 `🟡` 子集和 foundation shim baseline 集中演示出来，并把 preview 边界收敛到真机 / release 证据，而不是接口缺口。
 
 从 `v1.8.x` 开始，这个 sample 的角色会固定成两层：
 
@@ -19,6 +19,11 @@
 - `expo-image-picker`
 - `expo-location`
 - `expo-camera`
+- `expo-secure-store`
+- `expo-asset`
+- `expo-device`
+- `expo-clipboard`
+- `expo-haptics`
 
 当前 route：
 
@@ -26,6 +31,11 @@
 - `/image-picker`
 - `/location`
 - `/camera`
+- `/secure-store`
+- `/asset`
+- `/device`
+- `/clipboard`
+- `/haptics`
 
 对应的逐 capability 追踪板见：
 
@@ -88,6 +98,51 @@
 - microphone permission snapshot
 - denied / canceled / successful result 展示
 
+### `/secure-store`
+
+`🟡 v1.9 app-foundation baseline`：
+
+- `isAvailableAsync`
+- session-scoped `setItemAsync`
+- session-scoped `getItemAsync`
+- `deleteItemAsync`
+- encrypted persistence、keychain / keystore 等真实 native 后端仍待 device / release evidence
+
+### `/asset`
+
+`🟡 v1.9 app-foundation baseline`：
+
+- `Asset.fromURI`
+- `Asset.loadAsync`
+- deterministic metadata display
+- native resource resolution、asset cache parity 仍待 device / release evidence
+
+### `/device`
+
+`🟡 v1.9 app-foundation baseline`：
+
+- stable Harmony placeholder metadata
+- `getDeviceTypeAsync`
+- real device model/build/hardware metadata 仍待 device / release evidence
+
+### `/clipboard`
+
+`🟡 v1.9 app-foundation baseline`：
+
+- session-scoped string write/read
+- `hasStringAsync`
+- URL helper roundtrip
+- real system pasteboard behavior 仍待 Harmony adapter evidence
+
+### `/haptics`
+
+`🟡 v1.9 app-foundation baseline`：
+
+- `selectionAsync`
+- `impactAsync`
+- `notificationAsync`
+- 当前为 no-op-safe shim；真实物理反馈仍待 device evidence
+
 ## 推荐命令
 
 ```bash
@@ -134,5 +189,5 @@ pnpm run harmony:build:release
 
 - 这个 sample 属于 `preview` 主线，不等于已经进入 `verified`
 - `doctor-report.json` 与 `toolkit-config.json` 中的 `runtimeMode` / `evidence.*` 会如实反映这些能力距离 verified 还缺哪些证据
-- 当前重点是“模拟器下真正可用、核心流清楚、文档一致”
+- 当前重点是“bundle/debug baseline 可重复、核心流清楚、文档一致”
 - 等未来补齐真机 gate 后，才讨论 capability promotion

package/docs/roadmap.md

@@ -6,6 +6,7 @@
 
 - 所有 Expo project types 与 package categories，最终都进入同一条 `mainline capability catalog`
 - `v2.0.0` 本身就要接近最完美、最最终的交付形态，而不是“还差最后一段 extension”
+- `v2.0.0` 的可靠打包承诺收敛为 catalog-covered Expo projects：只要依赖已经进入主线 capability catalog，就必须稳定闭环
 - 公开承诺仍然按 evidence gate 逐步放开，而不是因为目标扩大就提前放宽 `latest`
 - `latest` 继续只承接完整验收的 `verified`
 - `next` 继续承接 fast track，用来加速收敛，但不伪装成 `verified`
@@ -65,6 +66,8 @@
 
 ## 当前主线
 
+`v1.8.x` 已完成 repo 内可收口项，当前主线切到 `v1.9.x`。`v1.9.0` 先落 bare workflow baseline、app foundation modules 与 `react-native-gesture-handler` formal slice；剩余需要真机或 release HAP 的证据继续保留在 v1.8.x capability board，不阻塞 v1.9.x 的 bare / foundation / third-party onboarding 工作。
+
 ### v1.8.0 Intake Hardening + Parallel Promotion
 
 目标日期：`2026-05-15`
@@ -98,7 +101,9 @@
 
 目标日期：`2026-06-15`
 
-目标：把 v1.8.0 建好的 intake + promotion 架子收口到可持续执行的证据节奏。
+状态：repo-only closeout complete；device / release evidence carryover。
+
+目标：把 v1.8.0 建好的 intake + promotion 架子收口到可持续执行的证据节奏，并把外部验收项从 repo 内可完成项中拆开。
 
 - 每个 preview capability 必须单独维护：
   - bundle evidence
@@ -108,12 +113,18 @@
 - combined sample 只负责回归烟测，不再替代单 capability 证据
 - `toolkit-config.json`、`doctor-report.json`、roadmap、support matrix、acceptance board 保持同源同步
 - `latest` 仍不承接任何证据未闭环的 capability
+- 不需要真机或 release HAP 的收尾项已经完成，可以进入 `v1.9.x`
+- 仍然顺延的外部证据：
+  - 单 capability 真机 device acceptance record
+  - 单 capability release HAP runtime acceptance
 
 ### v1.9.0 Bare Workflow Baseline + App Foundation Modules
 
 目标日期：`2026-08-31`
 
-目标：先把 bare workflow 拉进主线，并补齐最容易卡死真实项目的官方基础模块。
+状态：implementation baseline complete；device / release evidence carryover。
+
+目标：把 bare workflow 拉进主线，补齐最容易卡死真实项目的官方基础模块，并先建立第三方 blocker 的正式接入切片。
 
 - bare workflow 正式进入主线里程碑
 - 优先补齐：
@@ -123,6 +134,15 @@
   - `expo-clipboard`
   - `expo-haptics`
 - 高频第三方 native dependencies 开始进入同一 capability catalog
+- `react-native-gesture-handler` 进入 formal acceptance slice：
+  - 保留 experimental / non-verified 边界
+  - 补齐 sample / fixture / doctor / debug build evidence
+  - device / release evidence 仍按 promotion gate 单独关闭
+- project-shape regression farm 建立最小版本：
+  - managed core
+  - managed native heavy
+  - bare
+  - third-party native heavy
 - 对每个新能力继续坚持：
   - fixture
   - sample route
@@ -131,6 +151,7 @@
   - bundle
   - debug build
   - acceptance 记录
+- 本阶段不改变 `verified` 边界；foundation modules 以 `preview` + `runtimeMode=shim` 记录，`react-native-gesture-handler` 以 `experimental` + formal adapter slice 记录
 
 ### v1.9.1 Third-party Native Wave A
 
@@ -139,10 +160,10 @@
 目标：优先清掉最容易挡住“任何 Expo 项目”的高频第三方 native blocker。
 
 - 第一批高频第三方 native blocker 进入正式 onboarding：
-  - `react-native-gesture-handler`
   - `react-native-safe-area-context`
   - `react-native-screens`
   - `@react-native-async-storage/async-storage`
+- `react-native-gesture-handler` 如果在 `v1.9.0` 已完成 formal acceptance slice，则本阶段只继续补 device / release evidence 与 promotion 决策
 - 建立第三方 native capability onboarding checklist：
   - catalog entry
   - shim / adapter strategy
@@ -155,10 +176,10 @@
 
 目标日期：`2026-10-31`
 
-目标：扩大第三方 native 覆盖，并建立“任何 Expo 项目”目标需要的持续回归面。
+目标：扩大第三方 native 覆盖，并把 `v1.9.0` 建好的最小 regression farm 扩容成持续回归面。
 
 - 第二批高频第三方 native 依赖进入主线
-- 引入 project-shape regression farm：
+- 扩容 project-shape regression farm：
   - managed core
   - managed native heavy
   - bare
@@ -193,13 +214,16 @@
 - 对仍无法在 `v2.0.0` 前关闭的项，必须提前明确降级策略与替代路径
 - `v2.0.0` 不接受“先宣布完成，再慢慢补长尾”
 
-### v2.0.0 Any Expo Project Reliable Packaging
+### v2.0.0 Catalog-covered Expo Project Reliable Packaging
+
+原 `Any Expo Project Reliable Packaging` 叙事保留为 intake 目标，但可靠打包承诺明确收敛到 catalog-covered 项目。
 
 目标日期：`2026-12-31`
 
-定义：任何 Expo 项目，只要依赖已经存在于主线 capability catalog 内，就能可靠打包成鸿蒙 App；`v2.0.0` 本身就是基本接近最完美、最最终的形态。
+定义：任何 Expo 项目，只要依赖已经存在于主线 capability catalog 内，就能可靠打包成鸿蒙 App；未进入 catalog 的依赖必须至少被 `doctor` 明确分类、指出 blocker，并给出下一步。`v2.0.0` 本身就是基本接近最完美、最最终的形态。
 
-- 不再只覆盖“主流项目”，而是把“任何 Expo 项目都能可靠打包成鸿蒙 App”作为正式版本定义
+- 不再只覆盖“主流项目”，而是把 catalog-covered Expo projects 的可靠打包作为正式版本定义
+- “任何 Expo 项目都能可靠打包成鸿蒙 App”不得被简化成无边界长尾承诺；真实承诺边界是 mainline capability catalog
 - `Managed/CNG` 与 bare workflow 都必须进入稳定交付路径
 - 高频官方 Expo 模块与高频第三方 native blockers 必须已经进入同一公开 capability catalog
 - `doctor -> sync-template -> bundle -> build-hap --mode debug|release` 必须对主线 catalog 内项目形成稳定闭环
@@ -208,7 +232,8 @@
 ## 长期方向
 
 - 所有输入最终都进入同一个 `mainline capability catalog`
-- `v2.0.0` 就是“任何 Expo 项目可靠打包成鸿蒙 App”的正式目标版本
+- `v2.0.0` 就是 catalog-covered Expo projects 可靠打包成鸿蒙 App 的正式目标版本
+- 对 catalog 外项目，正式目标是完整 intake：能分类、能说明 blocker、能给下一步，而不是伪装成已经可靠打包
 - `latest` 只由完整验收能力驱动
 - `next` 用来加速收敛主线 backlog，而不是制造伪 verified 叙事
 - roadmap 的关键问题不再是“要不要把某类项目算进主线”，而是“它何时进入主线、当前缺哪格 evidence、下一步怎么 unblock”

package/docs/support-matrix.md

@@ -1,6 +1,6 @@
-# v1.8 支持矩阵
+# v1.9 支持矩阵
 
-`v1.8` 继续采用 tiered support model，但从现在开始把“层级”与“晋升距离”拆开表达：
+`v1.9` 继续采用 tiered support model，并把“层级”与“晋升距离”拆开表达：
 
 - `supportTier` 表示公开承诺层级
 - `runtimeMode` 表示当前运行时接入形态：`shim`、`adapter`、`verified`
@@ -9,11 +9,12 @@
 - `coverageProfile` 表示当前项目属于哪条主线输入形态
 - `nextActions` 表示 toolkit 为当前项目生成的有序下一步
 
-同时，`v1.8.x` 的 roadmap 已经改成单一 `mainline capability catalog` 方向：
+同时，roadmap 已经改成单一 `mainline capability catalog` 方向：
 
 - bare workflow 与第三方 native package 不再被描述成“收官后才考虑的另一条 extension 终局”
 - `v2.0.0` 本身被定义成“任何 Expo 项目都能可靠打包成鸿蒙 App”的目标版本
 - 但当前公开承诺依旧没有放宽；它们只是进入同一主线 backlog，而不是已经进入 `verified`
+- `v1.9.0` 新增的是 bare intake baseline、app foundation preview shim baseline 与 `react-native-gesture-handler` formal experimental slice，不是 verified 扩容
 
 `doctor --strict` 继续只代表 `verified`。
 
@@ -106,15 +107,22 @@
 | `expo-image-picker` | `preview` | `adapter` | `bundle=yes[automated], debugBuild=yes[automated], device=yes[manual-doc], release=no[none]` | react-native-image-picker, react-native-permissions | ohos.permission.CAMERA、ohos.permission.MICROPHONE、ohos.permission.READ_IMAGEVIDEO | `/image-picker` |
 | `expo-location` | `preview` | `adapter` | `bundle=yes[automated], debugBuild=yes[automated], device=yes[manual-doc], release=no[none]` | @react-native-community/geolocation, react-native-permissions | ohos.permission.LOCATION、ohos.permission.APPROXIMATELY_LOCATION、ohos.permission.LOCATION_IN_BACKGROUND、ohos.permission.ACCELEROMETER | `/location` |
 | `expo-camera` | `preview` | `adapter` | `bundle=yes[automated], debugBuild=yes[automated], device=yes[manual-doc], release=no[none]` | react-native-camera-kit, react-native-permissions | ohos.permission.CAMERA、ohos.permission.MICROPHONE | `/camera` |
+| `expo-secure-store` | `preview` | `shim` | `bundle=yes[automated], debugBuild=yes[automated], device=no[none], release=no[none]` | toolkit-managed bridge | 无新增必需权限 | `/secure-store` |
+| `expo-asset` | `preview` | `shim` | `bundle=yes[automated], debugBuild=yes[automated], device=no[none], release=no[none]` | toolkit-managed bridge | 无新增必需权限 | `/asset` |
+| `expo-device` | `preview` | `shim` | `bundle=yes[automated], debugBuild=yes[automated], device=no[none], release=no[none]` | toolkit-managed bridge | 无新增必需权限 | `/device` |
+| `expo-clipboard` | `preview` | `shim` | `bundle=yes[automated], debugBuild=yes[automated], device=no[none], release=no[none]` | @react-native-oh-tpl/clipboard | 无新增必需权限 | `/clipboard` |
+| `expo-haptics` | `preview` | `shim` | `bundle=yes[automated], debugBuild=yes[automated], device=no[none], release=no[none]` | toolkit-managed bridge | 无新增必需权限 | `/haptics` |
 <!-- GENERATED:support-matrix-preview-capabilities:end -->
 
 说明：
 
 - 当前四项 preview capability 都已经完成 preview baseline 的 bundle / debug build / route walkthrough
 - 四项 preview capability 都已经进入 `adapter` 路径；`device=yes[manual-doc]` 只表示已有人工设备验收记录，仍不代表 verified 或 release-ready
-- 当前 preview baseline 的默认 evidenceSource 固定为：`bundle/debugBuild=automated`、`device=manual-doc`、`release=none`
+- 当前原生 adapter preview baseline 的默认 evidenceSource 固定为：`bundle/debugBuild=automated`、`device=manual-doc`、`release=none`
+- `v1.9.0` 新增的 app foundation modules 当前是 `runtimeMode=shim`，`bundle/debugBuild=automated`，`device/release=none`
 - `v1.8.2` 的 ccnubox release HAP 模拟器安装/启动记录只证明 app-shell release 构建链路，不改变上述 per-capability `release=no[none]`
 - `v1.8.x` 开始，combined sample smoke 只负责总回归；每项 capability 还必须单独维护 device / release acceptance 记录，见 [acceptance/v1.8.x-capability-board.md](../acceptance/v1.8.x-capability-board.md)
+- `v1.8.x` repo 内可完成的 closeout 已完成；剩余 carryover 只包括单 capability 真机 device record 与 release HAP runtime acceptance
 - `expo-file-system`
   - `🟡` 当前主路径是 UTF-8/base64 sandbox I/O、append/partial read、`getInfoAsync({ md5: true })` 与 `downloadAsync`
 - `expo-image-picker`
@@ -129,7 +137,7 @@
 | Expo 能力 / 依赖 | 当前层级 | runtimeMode | evidence | 说明 |
 | --- | --- | --- | --- | --- |
 | `expo-notifications` | `experimental` | `shim` | `bundle=no, debugBuild=no, device=no, release=no` | 服务链路与交付故事未打通 |
-| `react-native-gesture-handler` | `experimental` | matrix 外本地探索 | matrix 外 | 继续保留本地探索 shim，但不在公开 verified 矩阵内 |
+| `react-native-gesture-handler` | `experimental` | `adapter` | `bundle=yes[automated], debugBuild=yes[automated], device=no[none], release=no[none]` | v1.9.0 formal acceptance slice；必须与 `@react-native-oh-tpl/react-native-gesture-handler` 成对接入，仍不在公开 verified 矩阵内 |
 
 ## UI Stack 配对规则
 
@@ -229,7 +237,7 @@ toolkit 受管的核心产物仍包括：
 
 ## Release Tracks
 
-从 `v1.8` 开始，发布节奏按双轨设计：
+从 `v1.8` 开始，发布节奏按双轨设计；`v1.9.0` 继续沿用同一规则：
 
 <!-- GENERATED:support-matrix-release-tracks:start -->
 - `latest`
@@ -255,9 +263,12 @@ toolkit 受管的核心产物仍包括：
 
 `v1.8.2` 记录的 simulator release-HAP evidence 只覆盖 ccnubox app-shell 的 signed HAP 构建、安装和启动；单 capability 的 release acceptance 仍必须按各自记录单独关闭。
 
+`v1.8.x` repo-only closeout 不改变 capability evidence source：`device=yes[manual-doc]` 仍只代表既有人工基线，`release=no[none]` 仍表示没有单 capability release HAP runtime evidence。
+
 ## 当前仍未进入正式公开承诺
 
-- bare Expo
+- bare Expo；当前只进入 intake / debug baseline
+- `expo-secure-store`、`expo-asset`、`expo-device`、`expo-clipboard`、`expo-haptics` 当前仍只是 preview shim baseline
 - 多 Expo / RNOH 并行 verified 矩阵
 - 任意第三方 native package 的即时正式承诺
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "expo-harmony-toolkit",
-  "version": "1.8.3",
+  "version": "1.9.0",
   "description": "面向 Managed/CNG Expo 项目的 HarmonyOS 迁移、准入检查与 UI-stack 构建工具链",
   "main": "app.plugin.js",
   "types": "build/index.d.ts",