rta-handbook/docs/projection-operations.md

Projection Operations

This repo is projected into AFFiNE manually for now.

Canonical Gitea repo:

http://100.64.0.1:30087/virgil-admin/rta-mock-docs.git

Projected AFFiNE path:

Agent Workspace / projected-markdown / mock-rta-docs

What A Collaborator Does

cd ~/Developer/Section0/rta-mock-docs
git pull --ff-only
# edit Markdown
git add .
git commit -m "Update docs"
git push

What The Projection Operator Does

The operator keeps a separate checkout so projection never depends on a collaborator's dirty working tree.

git -C /Users/virgil/Developer/rta/tmp/markdown-projection-gitea/projector-checkout/rta-mock-docs pull --ff-only

Then from home-lab-v7:

cd /Users/virgil/Developer/Virgil-Info/home-lab-v7

nix develop --command bash -lc 'scripts/ops/sync-obsidian-affine.rb \
  --name rta-mock-docs \
  --source /Users/virgil/Developer/rta/tmp/markdown-projection-gitea/projector-checkout/rta-mock-docs \
  --username projection-bot \
  --authentik-sub rta-projection-bot \
  --affine-workspace "Agent Workspace" \
  --affine-workspace-id 53ea0a0b-eca7-4887-8e31-f5b2a8ab7744 \
  --affine-user-id ce42f50a-5367-4466-920b-7422c4e27de0 \
  --affine-namespace projected-markdown/mock-rta-docs \
  --include "**/*.md" \
  --apply'

Expected healthy result:

docs:       3
mark stale: 0
mode:       one-way read-only AFFiNE docs

Rule Of Thumb

If the source repo changes, pull the projector checkout and run projection.

If AFFiNE changes, treat it as a comment or sketch. Move durable edits back to Markdown before projecting again.