Skip to content

docs: Snapshots, Utils workspace, origin policy, and dialect list - #438

Draft
cursor[bot] wants to merge 2 commits into
mainfrom
cursor/engineering-documentation-updates-4ba8
Draft

cursor[bot] wants to merge 2 commits into
mainfrom
cursor/engineering-documentation-updates-4ba8

Conversation

@cursor

@cursor cursor Bot commented Sep 28, 2026

Copy link
Copy Markdown
Contributor

Weekly engineering-docs pass against main (0.2.265). No product-code changes.

Docs added/updated

  • USER_GUIDE.md — left-rail names (Compare / Editor / Utils / Snapshots); Utils as its own workspace; Snapshots vs Applies; Same DB warning; partial-grid data compare; Edit/Delete unique-key rule; origin 403 troubleshooting.
  • README.md — 14 SQL dialects (+ MongoDB/Redis settings-only).
  • DEPLOYMENT.md + .env.example — FOX_ALLOWED_ORIGINS and the literal-IP dev allowlist.
  • CONTRIBUTING.md — DIALECTS.md is tracked; E2E sweep timeouts and Lokee 20/min rate-limit helper; dialectFamily().
  • ARCHITECTURE.md / CODE_MAP.md / WORKFLOW.md — dialect families, origin guard, unknown fromPort refused at save.
  • UNRELEASED.md — workspace and origin-policy notes for the next GitHub Release.
  • sql-editor-agent-memory.mdc — Index Management / Clone Table live in Utils, not the SQL Editor sidebar.

Codepaths covered

  • UtilitiesView.tsx (Utils workspace; Editor sidebar utilities/files return null)
  • LokeeWeaveView / ForceMigrateModal / reversalGate (Snapshots, revert vs force-migrate)
  • ActivityRail (Snapshots vs Applies)
  • origin-policy.ts (FOX_ALLOWED_ORIGINS, LAN Vite Origins)
  • alignResultGridsByKey / migrateKeysSafeForMutatingOps
  • dialectFamily() in provider-settings.ts
  • assertKnownFromPorts at workflow save
  • apps/e2e/scripts/run-all.mjs + rate-limited.ts

Knowledge gaps addressed

  • User guide still described a SQL Editor Utilities sidebar and a single History pane.
  • README/ARCHITECTURE under-counted dialects (10 vs 14 SQL).
  • LAN npm run dev 403s looked like a blank UI with no runbook.
  • E2E sweep timeouts and capture/revert 429s had no contributor notes.
  • CONTRIBUTING still called DIALECTS.md gitignored.

Verified: npx vitest run packages/shared/src/doc-paths.test.ts (20 passed, 2 skipped).

Open in Web View Automation 

cursoragent and others added 2 commits September 28, 2026 16:09
The left rail is Compare / Editor / Utils / Snapshots, not Schema Sync plus
a SQL Editor sidebar. History split into Snapshots (Lokee) and Applies
(migration runs). README lists all 14 SQL dialects.

Co-authored-by: huy.ph1988 <huy.ph1988@gmail.com>
Record FOX_ALLOWED_ORIGINS and the literal-IP dev allowlist, the E2E
rate-limit helper and suite timeouts, DIALECTS.md as tracked, and
assertKnownFromPorts at workflow save. Point agent memory at the Utils
workspace instead of the SQL Editor sidebar.

Co-authored-by: huy.ph1988 <huy.ph1988@gmail.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant