refactor(app): isolate composition and presentation / 完成 App 装配与展示层拆分

.github/workflows/app-memory.yml

@@ -0,0 +1,174 @@
+name: App memory screening
+
+on:
+  pull_request:
+    branches: [main-v2]
+  push:
+    branches: [main-v2]
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+concurrency:
+  group: app-memory-${{ github.event.pull_request.number || github.ref }}
+  cancel-in-progress: true
+
+env:
+  EXPECTED_SOURCE_SHA: ${{ github.event.pull_request.head.sha || github.sha }}
+
+jobs:
+  changes:
+    runs-on: ubuntu-22.04
+    outputs:
+      run: ${{ steps.paths.outputs.run }}
+    steps:
+      - uses: actions/checkout@v7
+        with:
+          ref: ${{ env.EXPECTED_SOURCE_SHA }}
+          fetch-depth: 0
+      - uses: actions/setup-node@v7
+        with:
+          node-version: "24"
+      - id: paths
+        env:
+          BASE_SHA: ${{ github.event.pull_request.base.sha || github.event.before }}
+        run: |
+          if [ "$GITHUB_EVENT_NAME" != pull_request ]; then
+            echo 'run=true' >> "$GITHUB_OUTPUT"
+          else
+            git diff --name-only -z "$BASE_SHA...$EXPECTED_SOURCE_SHA" > "$RUNNER_TEMP/memory-paths"
+            node desktop/frontend/bench/app-memory-paths.mjs "$RUNNER_TEMP/memory-paths" >> "$GITHUB_OUTPUT"
+          fi
+
+  prepare:
+    needs: changes
+    if: needs.changes.outputs.run == 'true'
+    runs-on: ubuntu-22.04
+    timeout-minutes: 20
+    defaults:
+      run:
+        working-directory: desktop/frontend
+    steps:
+      - uses: actions/checkout@v7
+        with:
+          ref: ${{ env.EXPECTED_SOURCE_SHA }}
+      - uses: pnpm/action-setup@v6.0.9
+        with:
+          version: 10
+          run_install: false
+      - uses: actions/setup-node@v7
+        with:
+          node-version: "24"
+          cache: pnpm
+          cache-dependency-path: desktop/frontend/pnpm-lock.yaml
+      - run: pnpm install --frozen-lockfile
+      - run: node --test bench/app-memory-shards.test.mjs bench/app-memory-paths.test.mjs
+      - run: pnpm build
+      - run: node bench/app-memory-prepare.mjs "$RUNNER_TEMP/app-memory-build"
+      - uses: actions/upload-artifact@v7
+        with:
+          name: app-memory-build-${{ github.run_id }}-${{ github.run_attempt }}
+          path: ${{ runner.temp }}/app-memory-build
+          include-hidden-files: true
+          if-no-files-found: error
+          retention-days: 7
+
+  shard:
+    needs: prepare
+    runs-on: ubuntu-22.04
+    timeout-minutes: 90
+    strategy:
+      fail-fast: false
+      matrix:
+        shard: [1, 2, 3]
+    defaults:
+      run:
+        working-directory: desktop/frontend
+    steps:
+      - uses: actions/checkout@v7
+        with:
+          ref: ${{ env.EXPECTED_SOURCE_SHA }}
+      - uses: pnpm/action-setup@v6.0.9
+        with:
+          version: 10
+          run_install: false
+      - uses: actions/setup-node@v7
+        with:
+          node-version: "24"
+          cache: pnpm
+          cache-dependency-path: desktop/frontend/pnpm-lock.yaml
+      - run: pnpm install --frozen-lockfile
+      - run: pnpm exec playwright install --with-deps chromium
+      - uses: actions/download-artifact@v8
+        with:
+          name: app-memory-build-${{ github.run_id }}-${{ github.run_attempt }}
+          path: ${{ runner.temp }}/app-memory-build
+      - run: cp -a "$RUNNER_TEMP/app-memory-build/dist/." dist/
+      - name: Run complete independent memory process
+        env:
+          REASONIX_APP_MEMORY_SHARD: ${{ matrix.shard }}
+          REASONIX_APP_MEMORY_PREPARED: ${{ runner.temp }}/app-memory-build/identity.json
+          REASONIX_APP_MEMORY_ARTIFACTS: ${{ runner.temp }}/app-memory-results
+          PLAYWRIGHT_BROWSERS_PATH: /home/runner/.cache/ms-playwright
+        run: node bench/app-memory.mjs
+      - uses: actions/upload-artifact@v7
+        if: always()
+        with:
+          name: app-memory-shard-${{ matrix.shard }}-${{ github.run_id }}-${{ github.run_attempt }}
+          path: ${{ runner.temp }}/app-memory-results
+          if-no-files-found: error
+          retention-days: 7
+
+  app-memory:
+    if: always()
+    needs: [changes, prepare, shard]
+    runs-on: ubuntu-22.04
+    steps:
+      - name: Verify all prerequisite jobs
+        env:
+          CHANGES_RESULT: ${{ needs.changes.result }}
+          SHOULD_RUN: ${{ needs.changes.outputs.run }}
+          PREPARE_RESULT: ${{ needs.prepare.result }}
+          SHARD_RESULT: ${{ needs.shard.result }}
+        run: |
+          test "$CHANGES_RESULT" = success
+          if [ "$SHOULD_RUN" = true ]; then
+            test "$PREPARE_RESULT" = success
+            test "$SHARD_RESULT" = success
+          else
+            test "$SHOULD_RUN" = false
+            test "$PREPARE_RESULT" = skipped
+            test "$SHARD_RESULT" = skipped
+          fi
+      - uses: actions/checkout@v7
+        if: needs.changes.outputs.run == 'true'
+        with:
+          ref: ${{ env.EXPECTED_SOURCE_SHA }}
+      - uses: actions/setup-node@v7
+        if: needs.changes.outputs.run == 'true'
+        with:
+          node-version: "24"
+      - uses: actions/download-artifact@v8
+        if: needs.changes.outputs.run == 'true'
+        with:
+          pattern: app-memory-shard-*-${{ github.run_id }}-${{ github.run_attempt }}
+          path: ${{ runner.temp }}/app-memory-reports
+      - uses: actions/download-artifact@v8
+        if: needs.changes.outputs.run == 'true'
+        with:
+          name: app-memory-build-${{ github.run_id }}-${{ github.run_attempt }}
+          path: ${{ runner.temp }}/app-memory-build
+      - name: Verify same-build complete protocol
+        if: needs.changes.outputs.run == 'true'
+        run: |
+          node desktop/frontend/bench/app-memory-aggregate.mjs \
+            "$RUNNER_TEMP/app-memory-reports" "$RUNNER_TEMP/app-memory-build/identity.json" \
+            "$RUNNER_TEMP/app-memory-report.json" "$EXPECTED_SOURCE_SHA"
+      - uses: actions/upload-artifact@v7
+        if: success() && needs.changes.outputs.run == 'true'
+        with:
+          name: app-memory-aggregate-${{ github.run_id }}-${{ github.run_attempt }}
+          path: ${{ runner.temp }}/app-memory-report.json
+          if-no-files-found: error
+          retention-days: 7

.github/workflows/ci.yml

@@ -395,6 +395,9 @@ jobs:
           pnpm --dir frontend test:motion-browser
           pnpm --dir frontend test:composer
           pnpm --dir frontend test:todo-visibility
+          pnpm --dir frontend test:app-lifecycle
+          PLAYWRIGHT_BROWSERS_PATH=.pw-browsers pnpm --dir frontend test:app-browser
+          pnpm --dir frontend test:all
           pnpm --dir frontend test:transcript
           xvfb-run -a env REASONIX_TRANSCRIPT_NATIVE_THUMB=1 pnpm --dir frontend test:transcript-browser
           PLAYWRIGHT_BROWSERS_PATH=.pw-browsers pnpm --dir frontend test:transcript-reader-browser

desktop/AGENTS.md

@@ -67,23 +67,33 @@ contracts when touching anything that can move the transcript viewport.
   position and native scroll state into independently committed compositor
   transactions.
 - **Anchor-safe measurement commit**: DOM measurements enter a block-keyed
-  staging ledger before they can change TanStack's prefix sizes. While native
-  input owns reader intent, the entire painted viewport is immutable: both the pre-measurement
+  staging ledger before they can change TanStack's prefix sizes. First
+  materialization is distinct: each new native host must publish its real size
+  and complete prefix before its first paint, not wait for gesture release.
+  One generation-bound window origin can preserve common visible positions
+  while new preceding blocks are measured. Translate positions, extent, range
+  lookup and publication-frontier checks together; consume the origin
+  continuously toward the native leading edge, never reset it abruptly at zero.
+  Clear it using the committed prefix anchor in one prepaint commit after
+  input ends; ordinary growth retains the input-captured Kernel anchor. Acknowledge geometry only after materialization finishes. For
+  subsequent size changes, while native input owns reader intent, the entire painted viewport is immutable: both the pre-measurement
   prefix range and mounted DOM must place a block after the viewport before it
   becomes a publish boundary. The logical Kernel anchor may only move that
   boundary later. This prevents stale listeners, underestimated ranges, or
   lazy blocks from reflowing any content the reader can see. TanStack's
   `scrollMargin` is measured in the native scroller's coordinate space,
   including Transcript padding and any prefix. Earlier and visible sizes remain
-  staged during native ownership; only post-viewport overscan may publish.
+  staged during native ownership; only post-viewport overscan may publish later
+  changes. Newly materialized natural sizes follow the prepaint rule above.
   After ownership ends, publish staged DOM sizes under a Kernel logical-anchor
   restore transaction. Prefix layout and anchor correction must complete in
   one before-paint commit, cancelling any queued older geometry work.
   Preserve the first reading anchor, while allowing later
   blocks to move with actual content growth; freezing every old top would
   overlap expanded content. Observe mounted absolute blocks as well as the
   projection root, since local folds do not change the root extent. Tail intent
-  does not refine invisible cold history; its exact geometry belongs to resident DOM. The measurement ledger owns sizes only.
+  does not refine subsequent invisible cold-history changes; first materialization
+  still establishes real mounted sizes. The measurement ledger owns sizes only.
   Input leases belong to the Kernel and must not be duplicated in the window
   adapter. Re-read physical viewport geometry at measurement admission; both
   painted prefix and measured DOM must place the publication boundary beyond

desktop/frontend/.gitignore

@@ -20,3 +20,5 @@ package-lock.json
 # Playwright browsers for the real-DOM bench (kept inside the repo; see bench/).
 .pw-browsers
 bench/results.json
+bench/app-memory-results.json
+bench/app-memory-artifacts/