[ENG-1852] Keep Roam shared node content fresh

[sid597]

Summary

• Extends the existing Roam Supabase sync loop to refresh already-shared source nodes.
• Detects shared source pages whose Roam page content changed via :page/edit-time or title-level :edit/time.
• Uploads refreshed full markdown content without running embeddings, while keeping direct/direct_and_description embedding updates on the existing changed-node path.
• Carries the matched node type through the shared freshness query so required schema metadata stays current.
• Adds the compact full-markdown validation artifact as a typed example.

Base / dependencies

ENG-1848 and ENG-1849 have landed on main, so this PR has been rebased onto current main and now contains only the ENG-1852 freshness-layer commit.

Validation

• pnpm install --frozen-lockfile after rebasing onto current main
• pnpm --filter roam check-types
• pnpm --filter @repo/database check-types
• pnpm --filter roam lint (0 errors, existing warnings remain)
• git diff --check origin/main...HEAD

Note: local shell is still on Node 20.20.1, while current main asks for Node >=22, so pnpm prints an engine warning locally.

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

1 Skipped Deployment

Project	Deployment	Actions	Updated (UTC)
discourse-graph	Skipped		Jun 28, 2026 4:50pm

[supabase]

This pull request has been ignored for the connected project zytfjzqyijgagqxrzbmz because there are no changes detected in packages/database/supabase directory. You can change this behaviour in Project Integrations Settings ↗︎.

---

Preview Branches by Supabase.
Learn more about Supabase Branching ↗︎.

[linear-code]

ENG-1852

[graphite-app]

PR size/scope check

This PR is over our review-size guideline.

• Recommended: ~200 lines changed
• Acceptable limit: up to 400 lines when well-scoped/self-contained
• Preferred file count: fewer than 5 files

Please split this into smaller PRs unless there is a clear reason the changes need to land together.

If keeping it as one PR, please add a brief justification covering:

• What single problem this PR solves
• Why the files/changes are coupled

[chatgpt-codex-connector]

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 554884cf58

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

[devin-ai-integration]

Devin Review found 1 potential issue.