Keep search focus and keyboard dismissal together
Shell and Settings search useAppSearchField, with the search icon and clear
control inside the input decoration. The shell retains its focus node and close
callback; fallback Settings fields retain their localized clear label.
Closing, submitting, tapping outside, dragging content and opening a result must
release search focus. Settings scroll padding reserves the larger of the current
keyboard inset and safe-area bottom padding, plus the standard scroll-end gap.
Use shell_search_field_test.dart and settings_search_interaction_test.dart for
focus, controller, geometry and inset regressions. Dock visibility uses the shell
keyboard policy; input widgets do not implement a second dock animation.
Preserve startup barriers while overlapping local reads
loadStartupPreferences starts haptic policy, theme and saved-route reads together.
System chrome waits for the resolved theme. Bootstrap waits for every read before
rendering, retaining tab-route precedence and required cache, consent and identity
barriers. local_preferences_test.dart controls pending reads and failures with
completers; elapsed wall time is not a concurrency assertion.
Dock workspace subscriptions select the effective workspace ID. Unrelated
workspace metadata must retain the dock configuration, while switching workspace
must remove the prior workspace’s composer. Exercise both chrome-action provider
presence and absence in widget coverage. These checks prove subscription behavior;
real-device profile traces are required to quantify frame-time improvements.
Separate repeated push handling from duplicate Mail events
Mobile startup initializes push handling before a restored auth session starts. Both entry paths must await the same initialization so one foreground delivery has one receiver. Fetch the cold-start message before attaching listeners; a failed lookup must not leave a receiver behind when setup retries.push_notification_initialization_test.dart exercises overlapping setup,
retry after failure, disposal, and distinct notifications through the service.
Duplicates on both Web and mobile lists require a separate producer diagnosis.
Mail receipts prevent re-enqueue of the same message for the same recipient;
forwarding can create distinct messages in different mailboxes. Compare redacted
notification, message, mailbox, receipt and batch identities before changing
that policy. A client display fix does not prove a shared producer issue resolved.
Web notification type labels interpolate runtime types, which the static key
scanner cannot enumerate. notification-type-translations.test.ts checks the
incoming Mail label in both owning Web bundles, including a key absent from both.
Remove the route owned by the departed session
An account or workspace switch can happen while an editor is covered by another modal. A generic navigator pop can dismiss the covering route and leave the old editor alive. Capture the editor’s own route and remove that route after the frame, checking that it is still active and the navigator is mounted. If the UI is settled, callWidgetsBinding.instance.ensureVisualUpdate() when scheduling
that cleanup: adding a post-frame callback alone does not request a frame.
HabitsOwnedOverlay implements this ownership pattern. The CMS and Education
workspace regressions also cover an editor beneath an unrelated modal and assert
that the previous actor’s content is gone without dismissing the unrelated route.
See cms_workspace_test.dart, education_workspace_test.dart, and
habits_host_scope_test.dart under apps/mobile/test/features.
Test the real entry path, not only the destination widget
A review sheet can render correctly in isolation while the page never exposes its action. Mount the actual host with its shell action publisher, invoke the published action, and assert the resulting widget and side effects. Inject a bounded repository or cubit result to avoid accidental provider calls, but keep the real host admission and navigation code in the test. Notes voice review distinguishescanReview from canSave: completed silence
can explain the result, while Save stays disabled and no analysis is replayed.
notes/voice/notes_voice_host_review_test.dart covers the published dock action;
notes_voice_widgets_test.dart covers the review widget itself. Both are useful,
but the latter alone does not establish reachability.
For Assistant first-turn fixtures, establish new-conversation authority through
the real history/New conversation confirmation path. A repository mock’s outer
creation flag does not acknowledge the page adapter’s persisted unknown-creation
hold. Keep setup free of creation POSTs and preserve actor/workspace admission;
then exercise the actual page send and authoritative creation receipt.
Cached display data is not a fresh authorization result
A read-through repository can return a previously authorized snapshot while its network revalidation continues. That is appropriate for stale-while-revalidate rendering. It cannot authorize publication into a second cache or reauthorize content after a durable denial marker has been written. For an authorization-sensitive publication, request the repository’s explicit fresh path and disable awaited transport fallback. Habits usesrequireFresh
for this purpose; its repository passes forceRefresh: true and
allowAwaitedTransportFallback: false to readThroughJson. Preserve the actor,
workspace, request token, and denial revision checks around reads and writes.
A fresh read failure must not silently promote an older cached result.
habits/cubit/habits_snapshot_access_test.dart covers transport fallback,
denial serialization, and scoped publication. The product policy is documented
in Mobile workspace tools.
Distinguish verification from definitive denial
An HTTP status alone does not distinguish an MFA challenge from revoked access. Check both the typed verification flag and theMFA_REQUIRED error code when
that endpoint’s contract supports them. Keep the existing scoped view during a
challenge and show its message; a later definitive denial still clears retained
rows and selection. Do not treat retaining the view as permission to bypass the
challenge for a mutation or a new request.
The Drive page regression exercises both challenge forms through actual refresh
and then verifies clearing on a definitive 403. See
drive/drive_page_test.dart and the Drive policy.
Attach handlers to independent startup tasks together
Independent prerequisites can run concurrently, but sequentially awaiting already started futures can leave the second failure unhandled while the first is still pending. Attach both to a sharedFuture.wait before awaiting either. Its default
settle-all behavior keeps the owned attempt pending until both finish. Connect
only after both succeed, then recheck the actor/session/request generation.
Mira Live binds history and initializes native audio this way before opening the
socket. assistant/assistant_live_startup_phases_test.dart verifies overlap,
settle-all failure handling, and scope cancellation. Duration-only diagnostics
show completed phases; concurrent phase durations must not be summed as a total.
Keep validation claims scoped
Focused host, state, and cache regressions establish these source behaviors. Run the required full mobile checks for implementation changes, then use CI for native builds. A mocked provider result or a passing widget suite does not prove authenticated device behavior, provider billing, installed model inference, or production delivery. Record those missing gates separately from the code fix.Close offline queue admission before awaiting cleanup
Disposing an offline mutation queue permanently closes that instance. Mark it closed before awaiting subscription cancellation, and check closure after connectivity, initialization, and dependency reads before starting another request or refreshing cached resources. Disposal must not await an unresolved connectivity future. A delayed old queue must not refresh resources registered by a replacement queue, including when the same actor returns after logout. An already dispatched write retains acknowledgment reconciliation so disposal cannot make an accepted write replay. Reconcile only its owned pending record; skip subsequent dispatch, retry timers, revalidation, and visible refresh after closure. A new queue remains able to synchronize the current actor’s resources.offline_queue_disposal_regression_test.dart covers held connectivity, actor
ABA, disposal before/during initialization, replacement queues, and admitted
ordinary and inventory acknowledgments using a real scoped temporary cache.
Await owned Assistant stream cancellation
Workspace retirement, explicit Stop and Cubit closure must capture and detach the intended current subscription and admission before awaiting any cleanup. Track pending cleanup per operation: joining an older reply’s cancellation does not cancel a replacement reply. A caller joins only the operations captured at its entry; it must not rescan after an await and cancel a later replacement. Concurrent callers without a replacement still join the same pending cleanup. A pre-dispatch rejection can surface through the cancellation future rather than its detached listener. Handle only a typed definitely-not-dispatched failure whose admission is identical to that subscription’s captured admission; retain unexpected failures and ambiguous dispatched outcomes. Cancellation does not supply a saved-USER acknowledgment or authorize a replacement request.assistant_native_dispatch_v116_test.dart covers held credentials across actor
retirement and concurrent Stop calls, zero retired POSTs and a fresh next turn.
Its public-history replacement controls hold A cleanup, restore and start B,
then verify Stop/close owns B cleanup while the older A caller cannot cancel B
or wait for B’s later cleanup. Those cleanup ports are synthetic streams, not
live HTTP cancellation proof.
Selection fixtures must use uploaded attachment paths owned by the selected
chat. assistant_chat_creation_selection_test.dart checks the actual outbound
attachment tuple and saved-USER proof before clearing the retained composer.
Native history attachments use the Chat wire response keys storagePath,
filename, contentType and sizeBytes. Do not substitute the Assistant stored-file
path/name/type/size shape: native restore reads filename and otherwise uses
its fallback label. Keep the original filename, storage path and tuple assertions.
These controls require actual mobile CI execution; source preparation alone is
not a passing test result.
Byte-backed XFile.fromData fixtures need a nonempty path as well as name
when testing filenames on the IO implementation. Assert the uploaded name and
outbound summary rather than accepting an empty attachment label.
Keep asynchronous Assistant fixtures in their owning zone
Widget callbacks run in fake async, while a fixture may use real Hive/file I/O. Locate the actual blocked await before changing scheduling. When real queue writes must progress independently of fake microtasks, captureZone.current eagerly
inside the existing tester.runAsync creation scope and admit those writes there.
Keep this fixture-only and opt-in, delegating the same record, scope callback and
real queue implementation. Preserve close/disposal waits and all persistence
assertions; wrapping only the later close does not drain an earlier fake-owned write.
A reduced Hive/zone control establishes a possible mechanism, not the hosted
writer’s identity or complete widget acceptance.
Capture scheduling ownership before entering fake callbacks; a lazy zone initializer
can capture the wrong zone on its first read. Awaiting an already-completed
fake-owned Future from runAsync does not necessarily advance its source-zone
continuations. A reduced cross-zone probe must attach its caller-owned completion
bridge while the source is still pending and record explicit final completion;
an empty exit-zero process is not proof that its awaited work finished.
Page workspace bootstrap may disconnect a supplied Live socket. Open a controlled
socket after that owned cleanup and assert its setup frame before testing sink
admission. A seeded connected Cubit state alone does not establish an open sink.
Create real file/cache operations and socket cancellation inside runAsync;
passing a previously created fake-zone Future into it does not move its work.
Keep the original dispatch, filename, ACK and retirement assertions.
When advancing reconnect and readiness timers in a widget test, construct the
Cubit inside that widget body. Ordinary setUp can put socket listeners and
reconnect timers in a real zone while the watchdog runs in fake time. Hold and
observe the actual replacement preparation so the clocks cannot conceal request
supersession. assistant_live_typed_dispatch_test.dart covers this boundary.
A retired send must leave shared setup in a terminal state, or under a newer
preparation owner. Assert that state after abort and fence cleanup publication
across native awaits. Count preparation attempts before retry or screen teardown
awaits, so abandoned cleanup preserves a newer attempt before request admission.
The latest rejected attempt settles inherited setup; teardown rechecks that
ownership after native awaits.
Notice guards must use the requested selection while a
restore is pending; the previous loaded chat snapshot is not selection proof.
assistant_live_preparation_cases.dart retains both same-chat recovery and
no-notice controls for another conversation. Manual End needs a monotonic
retirement fence independent of automatic recovery; resetting a connection flag
must not revive a cancelled send during replacement preparation.
Actor-ABA stream controls must establish that the actual response body is subscribed
before retiring the actor/epoch. Complete an explicit handshake inside the existing
onListen, after its prior callback, and await it before the actor change. Request
creation alone does not prove subscription. Keep the original request tuple,
receipt/body assertions, zero forbidden effects and cleanup after retirement.
Shell fixtures must provide the getters used by their real page consumers.
MockCubit does not supply a valid isClosed value automatically: stub an open
AuthCubit explicitly when mounting Assistant. Preserve navigation and geometry
assertions instead of ignoring the resulting page-build exception. For auth
transitions, assert immediate revocation and await the actual source notification
before requiring restored session identity.
Measure the Mira composer after layout
Mira text entry grows from one to five lines. Enter inserts a newline; the side primary action sends the draft. Keep the existing controller, focus, attachment, and restoring-state admission when adjusting this widget. The composer reports its rendered height to the assistant page. Use that height for transcript padding and scroll-to-bottom clearance, including the shell surface border. A one-line text estimate cannot cover wrapped drafts or enlarged text inside the published shell slot. Keep the system safe area separate from an IME inset already consumed by the shell Scaffold. The page publishes its dock slot after its frame; the shell consumes that slot in a subsequent build. Reopening a collapsed composer through the real FAB therefore has separate tap, page-visibility, slot-publication and mounted-dock boundaries. Assert that the launcher is hit-testable, observe the public composer state, then observe the published composing slot before driving its consumer frame and requiring exactly one dock. Derive frames from those boundaries, not arbitrary delays or a pump-until loop. A failed boundary needs evidence, not more pumping. Preserve the held request, draft controller and attachments; do not reach unmounted input State. Runassistant_composer_multiline_test.dart and
assistant_composer_geometry_test.dart under
apps/mobile/test/features/assistant/widgets before bun check:mobile. The
geometry regression renders the real composer in PersistentShellDock and
checks multiline growth, large text, keyboard and physical safe-area variants.
These fixtures do not establish authenticated native-device behavior.
Recover a hosted Dart formatting failure
The existing Mobile Analysis job runs the configured hosted Flutter SDK after its app-rootflutter pub get --enforce-lockfile dependency step. The app’s lock
and path overrides resolve vendor libraries; quality does not independently run
pub-get inside vendor packages or their examples. Standalone vendor resolution
can change a tracked vendor lock before formatting, invalidating preimages.
A lock mismatch must fail dependency installation; do not restore changed locks,
ignore dirty paths or relax capture guards. Other mobile jobs keep their own
install/validation contracts. A failed dart format --set-exit-if-changed lib test
still fails quality and prevents analysis. Its three-day mobile-format failure
artifact contains only a bounded tracked-Dart patch and a digest/version receipt;
it does not contain raw package configuration, environment or authentication data.
No patch is committed or applied automatically, and artifact existence is not a
format, analyzer, test or runtime pass.
Before using a patch, verify its GitHub run/job and reviewed workflow identity,
then require producerValid=true, an ordinary formatter exit1 with no bound
failure, stopped owned processes and the expected source/context identities.
The tested checkout commit may be a synthetic PR merge: compare testedCommit,
eventCommit and the separate prHeadCommit with the actual run metadata rather
than treating them as interchangeable. A missing/invalid receipt is a hold.
Schema1 retains class/phase captureErrors; optional captureErrorCodes adds
only exact allowlisted producer constants with their phase. Unknown exceptions
retain class/phase only. Use a captured safe code to diagnose a failure; never
bypass validation or infer its cause from a generic class alone.
preformatIdentityMatches separates checkout identity from dirty-source evidence.
preformatTrackedChanges contains only a capped count and SHA256 hashes of raw
NUL-delimited relative tracked path bytes, never names or diffs. Match hashes
offline against the public tested Git tree. Incomplete/invalid snapshots remain
a hold; countTruncated=true means more than 256 paths and no hashes are emitted.
Check patch byte length/SHA256, every changed path and full old/new blob IDs.
Only existing tracked regular .dart files under apps/mobile/lib or
apps/mobile/test are allowed. Compare each old SHA256/blob/mode with the actual
application target before any separately authorized git apply --check; reject
wrong-source, tampered, out-of-scope, new/deleted/renamed or mode-changing input.
A matching PR number or commit title does not establish preimage equality.
The receipt’s digest is not an independent signature: retrieve it through the
trusted exact run and verify the producer workflow/context, not only its claims.
The producer bounds input to 4096 tracked Dart files / 32 MiB (2 MiB per file), changed
paths to 256, patch to 4 MiB, receipt/output captures to 1 MiB, and the actual formatter
to 180 seconds. Bounds or capture failures retain the original formatting failure
and cannot qualify a patch; missing capture/upload requires another admitted
source-bound run. Context records hashes of source/lock/analysis/package context,
resolved analysis includes and actual tool identities, never their raw contents.
Keep a local formatter result separate when its SDK/package context differs.
When an owned checkout lacks package configuration, derive its language version
from apps/mobile/pubspec.yaml and pass it explicitly to the formatter, such as
dart format --language-version=3.10 for the current package. Limit formatting to
the owned path manifest; still require analysis and tests in the resolved project
context before accepting the change.
After separately reviewed application, require clean exact-head format and
analysis CI; retain independent compiler, behavior, SQL and delivery gates.
Keep widget fixtures current
Flutter verifies semantics handles and debug platform overrides before registeredaddTearDown callbacks run. Dispose handles and restore overrides in a
try/finally inside the test body, including when an assertion fails. Keep the
accessibility and platform-specific assertions intact.
Transport changes also affect widget fixtures. Exercise the current operation
receipt and read shape rather than stubbing a retired method: a mock that never
receives the request can leave a held-response test waiting indefinitely.
Assert that the expected request entered before awaiting its completion, and
retain stable operation identity, uncertainty and duplicate-write checks.
The Assistant message-action and transcript review regressions cover these
boundaries.
Prepare chat qualification declarations
The opt-in chat SQL-to-Web-to-Dart qualification compiles the actual Web route and its transitive imports. In CI, the selected source builds the existing@tuturuuu/types and @tuturuuu/supabase workspace declarations before the
unchanged explicit bridge tsc --noEmit step. The maintained Turbo build graph
orders dependencies with ^build; the chat-only step uses one worker and emits
normal ignored dist outputs. Other profiles keep their existing setup.
Missing public declaration artifacts are a setup failure before SQL, not SQL
qualification. Build success still requires the full compiler gate; remaining
type errors must be diagnosed independently. Do not replace exports with source
aliases or declaration stubs, weaken compiler checks, or treat absent phase
artifacts or an empty cleanup as a completed database qualification.
The Web bridge selects its existing tsconfig.chat-initial-settings.json
explicitly through Vite’s top-level tsconfig option. This keeps transforms
under the same owning configuration as the explicit compiler, including when
the installed source checkout sits beneath a separate control checkout. A
missing-config transform error before test collection is a Web setup failure;
it does not qualify SQL or either consumer. Preserve the actual route imports,
full compiler checks, and all nine Web and nine Dart cases, and require the
source-bound hosted qualification after correcting configuration ownership.
Web bridge process failures after passing tests
A successful nine-test JSON report does not qualify a child that aborts or fails to stop cleanly. The bridge records the actual status, signal, timeout and group cleanup before enforcing its existing exit gate. Its separate process-output summary contains only fixed panic, assertion, memory, fatal or unknown indicators, per-stream byte counts and SHA256 digests, with 64-KiB tails and explicit truncation. Counts saturate at 1 GiB per stream; a saturation flag preserves that limit while streaming hashes cover the received bytes. No stdout, stderr, paths, environment, SQL payloads or arbitrary exception text are retained. Existing build diagnostics keep their prior category/code/path projection. The bridge validates the summary before accepting a successful Web phase. Missing or malformed summary cannot qualify. Fixed indicators are evidence hints, not causal attribution; an unknown signal remains unknown without further evidence. Preserve source/control/run binding, all exit/cleanup gates and the independent SQL, Web and Dart phases. Do not substitute a passing report for exit zero, change runtimes or IPC, or retry qualification blindly. Require reviewed source and a separately admitted exact-source hosted attempt for actual process evidence.Opt in to a chat process comparison without qualifying a retry
diagnose_chat_process defaults to false and is accepted only with standalone
include_chat_initial_settings=true, with all other optional profiles and
structured provenance false. It does not change the authoritative Bunx attempt.
Only a stopped, non-timeout original SIGABRT with nine valid passing Web controls,
matching actual process identities and the unchanged SQL-produced envelope may
launch one sequential direct setup-Node24 comparison of the locked source Vitest
entry. Both arms retain the same config, controls, one-worker policy, owned
process-group cleanup and 120-second bound. They use separate report/result and
identity artifacts, with no second SQL producer or database lifecycle.
Config and fixture code record actual runtime versions, executable and Vitest-bin
digests, actual per-role entry digests, bounded process ancestry and only
NODE_OPTIONS presence/digest. The config entry must be the source-owned Vitest
bin, and each role’s entry digest must agree across arms. Identity
records are owned 0600 regular nonlink files, source/control/run/envelope-bound,
and bounded to 2 KiB each; the fixed diagnostic receipt is bounded to 8 KiB. No raw
arguments, paths, environment, output, SQL or arbitrary errors are emitted.
Missing or unequal identity, timeout, malformed artifacts or cleanup uncertainty
makes the comparison invalid. Command spelling does not identify the interpreter.
The original abort remains failed, with Web0/Dart0 and qualification false even
if the comparison passes. No Dart follows the original failure, no comparison
is a fallback or causal repair, and no further launch is allowed. A diagnostic
result only narrows the launcher/interpreter/teardown hypothesis; the signal
source remains unknown until separately proven. Require reviewed clean source
and control pins and an independently admitted hosted attempt. The synthetic
chat-process-diagnostic.test.mjs ports are orchestration regression coverage,
not actual SQL, Vitest, runtime or provider qualification.