Seanaye/feat/server fact projections 2

[seanaye]

Note

High Risk
Changes cache schema epoch, authoritative projection composition, and local list authority for production Documents filters—incorrect supplement/patch handling could cause stale membership or unsafe local results until network fallback.

Overview
Ships browser-side soup-flat-v2 predicate projections so Documents tabs can re-evaluate locally after realtime/backfill writes, using direct GraphQL fields plus decoded cacheProjection supplements (subtype + email-attachment facts).

The WASM cache path now composes complete v2 Replace mutations (or Patch when mutations omit projection fields) from query/subscription/backfill responses, rejects invalid required backfill capsules without advancing revision/checkpoints, and switches entityFilter compilation to compile_soup_flat_v2. CACHE_SCHEMA_COMPATIBILITY_EPOCH is bumped to 2 to invalidate stale v1 index state.

Mixed-deployment safety: dssGraphqlFetch retries without cacheProjection on legacy servers, exposes graphqlSoupProjectionSupported(), and flat Soup local authority stays off when projection isn’t supported. apply_authoritative_projection_patch preserves unmentioned server-owned facts on settlement/partial writes.

Large planning docs (entity-filter-cache-index-plan, server-minted projection plan, v1 manifest) are removed; related plans are retargeted to the optimistic/pagination prerequisites.

^{Reviewed by Cursor Bugbot for commit 6359ae5. Bugbot is set up for automated code reviews on this repo. Configure here.}

[coderabbitai]

Important

Review skipped

Auto reviews are disabled on base/target branches other than the default branch.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro Plus

Run ID: d956ee62-d9a2-4e77-a0fc-470f72139e0c

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}

[github-actions]

Preview: https://seanaye-feat-server-fact-proje-tsmafi.preview.macro.com/app (2417b1f)

[cursor]

Cursor Bugbot has reviewed your changes using high effort and found 2 potential issues.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

^{Reviewed by Cursor Bugbot for commit 30ab8cb. Configure here.}