chore: save current workspace changes

future_entry_demo/AGENTS.md

@@ -0,0 +1,31 @@
+# `entry` HAP Module
+
+## Scope and layout
+
+- This checkout is the HarmonyOS stage-model `entry` HAP module, not the complete application workspace.
+- Production ArkTS: `src/main/ets/`. Existing areas include `pages/`, `widget/`, `entryability/`, `communication/`, `initialize/`, and `register/`.
+- Resources: `src/main/resources/`.
+- Local Hypium tests: `src/test/`; device/ability Hypium tests: `src/ohosTest/`.
+- Module metadata: `src/main/module.json5`; build targets/configuration: `build-profile.json5`.
+- `hvigorfile.ts` registers the HAP tasks and HMRouter plugin.
+
+## Workspace and commands
+
+`oh-package.json5` uses sibling `file:../...` dependencies, and imports resolve across those siblings. Invoke builds and runs only from the complete parent workspace; its exact root is not verified in this checkout.
+
+```bash
+# Parent-workspace commands
+devecocli build --modules entry@default
+devecocli build --modules entry@ohosTest
+devecocli build --modules entry@Official --build-mode release
+devecocli device list
+devecocli run --module entry
+```
+
+- Configured targets are `default`, `ohosTest`, `OEM`, `Official`, and `forTest`.
+- Device/ability tests require a connected device or emulator.
+- No test-runner command is verified here.
+
+## Generated files
+
+- `oh-package-lock.json5` is autogenerated; do not edit it manually.