Commit 061bd50
bookerzhao
docs(skills/no-sql-web-sdk): surface CUSTOM-rule propagation gotcha in main pitfalls
The security-rule propagation window (backend caches rule evaluators for
2-5 minutes after managePermissions write) is already documented in
references/security-rules.md under 'Propagation And Verification'. However
agents loading the main no-sql-web-sdk/SKILL.md frequently do not drill
into the references file, so they finish configuring a CUSTOM rule and
immediately attempt the first write — which silently fails or returns
DATABASE_PERMISSION_DENIED because the rule has not propagated yet.
Seen in attribution issue_moasatof_tj63yv (CMS scaffold): agent correctly
set CUSTOM rules with auth.uid != null for create, but grader click-save
landed zero rows. Trace shows no wait or verification between rule-set
and first write.
Fix: add one pitfall bullet in SKILL.md that (a) warns about the 2-5
minute propagation window, (b) gives two working strategies (wait-retry
or verify-via-get), (c) reminds not to treat a resolved promise as
success, and (d) points to security-rules.md for the full pattern. Main
file content stays small; details remain in the reference.1 parent 046b53f commit 061bd50
1 file changed
Lines changed: 1 addition & 0 deletions
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
47 | 47 | | |
48 | 48 | | |
49 | 49 | | |
| 50 | + | |
50 | 51 | | |
51 | 52 | | |
52 | 53 | | |
| |||
0 commit comments