section0/rta-handbook
Archived
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Rename projection repo for Section 0

Browse Source
This commit is contained in:
virgil
2026-06-07 19:21:24 -07:00
parent cf7f4d95fc
commit f7426cf3a6
5 changed files with 31 additions and 31 deletions
Download Patch File Download Diff File Expand all files Collapse all files

20
README.md
View File

@@ -1,4 +1,4 @@
# Mock RTA Knowledge Base # Section 0 RTA Handbook
This hosted Git repo is intentionally plain Markdown. It has no required RTA This hosted Git repo is intentionally plain Markdown. It has no required RTA
sidecars. Collaborators clone, edit, commit, and push it as the canonical sidecars. Collaborators clone, edit, commit, and push it as the canonical
@@ -22,38 +22,38 @@ Current projected docs:
From any machine that can reach the lab mesh: From any machine that can reach the lab mesh:
```sh ```sh
curl -fsSL http://100.64.0.1:30087/virgil-admin/rta-mock-docs/raw/branch/main/scripts/setup-rta-mock-docs.sh | sh curl -fsSL http://100.64.0.1:30087/section0/rta-handbook/raw/branch/main/scripts/setup-section0-docs.sh | sh
``` ```
The script clones this repo into: The script clones this repo into:
```text ```text
~/Developer/Section0/rta-mock-docs ~/Developer/Section0/rta-handbook
``` ```
It also installs a small helper command at: It also installs a small helper command at:
```text ```text
~/.local/bin/rta-mock-docs ~/.local/bin/section0-docs
``` ```
Override the destination if you prefer: Override the destination if you prefer:
```sh ```sh
TARGET_DIR=~/work/rta-mock-docs \ TARGET_DIR=~/work/rta-handbook \
curl -fsSL http://100.64.0.1:30087/virgil-admin/rta-mock-docs/raw/branch/main/scripts/setup-rta-mock-docs.sh | sh curl -fsSL http://100.64.0.1:30087/section0/rta-handbook/raw/branch/main/scripts/setup-section0-docs.sh | sh
``` ```
## Daily Flow ## Daily Flow
```sh ```sh
rta-mock-docs pull section0-docs pull
# Edit Markdown files in your normal editor. # Edit Markdown files in your normal editor.
rta-mock-docs status section0-docs status
MESSAGE="Describe the doc change" rta-mock-docs commit MESSAGE="Describe the doc change" section0-docs commit
rta-mock-docs push section0-docs push
``` ```
After a push, ask the projection operator to pull and project. For now that is After a push, ask the projection operator to pull and project. For now that is

16
docs/projection-operations.md
View File

@@ -5,19 +5,19 @@ This repo is projected into AFFiNE manually for now.
Canonical Gitea repo: Canonical Gitea repo:
```text ```text
http://100.64.0.1:30087/virgil-admin/rta-mock-docs.git http://100.64.0.1:30087/section0/rta-handbook.git
``` ```
Projected AFFiNE path: Projected AFFiNE path:
```text ```text
Agent Workspace / projected-markdown / mock-rta-docs Agent Workspace / Section 0 / Git Projections / RTA Handbook
``` ```
## What A Collaborator Does ## What A Collaborator Does
```sh ```sh
cd ~/Developer/Section0/rta-mock-docs cd ~/Developer/Section0/rta-handbook
git pull --ff-only git pull --ff-only
# edit Markdown # edit Markdown
git add . git add .
@@ -33,7 +33,7 @@ collaborator's dirty working tree.
Nice wrapper: Nice wrapper:
```sh ```sh
/Users/virgil/Developer/rta/tmp/markdown-projection-gitea/collaborator-checkout/rta-mock-docs/scripts/project-rta-mock-docs.sh /Users/virgil/Developer/rta/tmp/markdown-projection-gitea/collaborator-checkout/rta-handbook/scripts/project-section0-rta-handbook.sh
``` ```
It pulls the projector checkout, checks it is clean, and runs the AFFiNE It pulls the projector checkout, checks it is clean, and runs the AFFiNE
@@ -42,7 +42,7 @@ projection command.
Manual equivalent: Manual equivalent:
```sh ```sh
git -C /Users/virgil/Developer/rta/tmp/markdown-projection-gitea/projector-checkout/rta-mock-docs pull --ff-only git -C /Users/virgil/Developer/rta/tmp/markdown-projection-gitea/projector-checkout/rta-handbook pull --ff-only
``` ```
Then from `home-lab-v7`: Then from `home-lab-v7`:
@@ -51,14 +51,14 @@ Then from `home-lab-v7`:
cd /Users/virgil/Developer/Virgil-Info/home-lab-v7 cd /Users/virgil/Developer/Virgil-Info/home-lab-v7
nix develop --command bash -lc 'scripts/ops/sync-obsidian-affine.rb \ nix develop --command bash -lc 'scripts/ops/sync-obsidian-affine.rb \
--name rta-mock-docs \ --name section0-rta-handbook \
--source /Users/virgil/Developer/rta/tmp/markdown-projection-gitea/projector-checkout/rta-mock-docs \ --source /Users/virgil/Developer/rta/tmp/markdown-projection-gitea/projector-checkout/rta-handbook \
--username projection-bot \ --username projection-bot \
--authentik-sub rta-projection-bot \ --authentik-sub rta-projection-bot \
--affine-workspace "Agent Workspace" \ --affine-workspace "Agent Workspace" \
--affine-workspace-id 53ea0a0b-eca7-4887-8e31-f5b2a8ab7744 \ --affine-workspace-id 53ea0a0b-eca7-4887-8e31-f5b2a8ab7744 \
--affine-user-id ce42f50a-5367-4466-920b-7422c4e27de0 \ --affine-user-id ce42f50a-5367-4466-920b-7422c4e27de0 \
--affine-namespace projected-markdown/mock-rta-docs \ --affine-namespace 'Section 0/Git Projections/RTA Handbook' \
--include "**/*.md" \ --include "**/*.md" \
--apply' --apply'
``` ```

4
rta/reports/current-status.md
View File

@@ -1,6 +1,6 @@
# RTA Status # RTA Status
This is still a demo status, not an exhaustive status report. This is a concise operator status, not an exhaustive status report.
The current mock says RTA has a working Markdown projection slice with hosted Git as the source authority. The current handbook records that RTA has a working Markdown projection slice with hosted Git as the source authority.
Live AFFiNE writing remains the next adapter step. Live AFFiNE writing remains the next adapter step.
The rename demonstrates that Git history can preserve projection identity. The rename demonstrates that Git history can preserve projection identity.

6
scripts/project-rta-mock-docs.sh → scripts/project-section0-rta-handbook.sh
View File

@@ -1,7 +1,7 @@
#!/usr/bin/env sh #!/usr/bin/env sh
set -eu set -eu
PROJECTOR_DIR="${PROJECTOR_DIR:-/Users/virgil/Developer/rta/tmp/markdown-projection-gitea/projector-checkout/rta-mock-docs}" PROJECTOR_DIR="${PROJECTOR_DIR:-/Users/virgil/Developer/rta/tmp/markdown-projection-gitea/projector-checkout/rta-handbook}"
HOME_LAB_DIR="${HOME_LAB_DIR:-/Users/virgil/Developer/Virgil-Info/home-lab-v7}" HOME_LAB_DIR="${HOME_LAB_DIR:-/Users/virgil/Developer/Virgil-Info/home-lab-v7}"
if [ ! -d "$PROJECTOR_DIR/.git" ]; then if [ ! -d "$PROJECTOR_DIR/.git" ]; then
@@ -27,13 +27,13 @@ fi
echo "==> Projecting Markdown into AFFiNE" echo "==> Projecting Markdown into AFFiNE"
cd "$HOME_LAB_DIR" cd "$HOME_LAB_DIR"
nix develop --command bash -lc "scripts/ops/sync-obsidian-affine.rb \ nix develop --command bash -lc "scripts/ops/sync-obsidian-affine.rb \
--name rta-mock-docs \ --name section0-rta-handbook \
--source '$PROJECTOR_DIR' \ --source '$PROJECTOR_DIR' \
--username projection-bot \ --username projection-bot \
--authentik-sub rta-projection-bot \ --authentik-sub rta-projection-bot \
--affine-workspace 'Agent Workspace' \ --affine-workspace 'Agent Workspace' \
--affine-workspace-id 53ea0a0b-eca7-4887-8e31-f5b2a8ab7744 \ --affine-workspace-id 53ea0a0b-eca7-4887-8e31-f5b2a8ab7744 \
--affine-user-id ce42f50a-5367-4466-920b-7422c4e27de0 \ --affine-user-id ce42f50a-5367-4466-920b-7422c4e27de0 \
--affine-namespace projected-markdown/mock-rta-docs \ --affine-namespace 'Section 0/Git Projections/RTA Handbook' \
--include '**/*.md' \ --include '**/*.md' \
--apply" --apply"

16
scripts/setup-rta-mock-docs.sh → scripts/setup-section0-docs.sh
View File

@@ -1,10 +1,10 @@
#!/usr/bin/env sh #!/usr/bin/env sh
set -eu set -eu
REPO_URL="${REPO_URL:-http://100.64.0.1:30087/virgil-admin/rta-mock-docs.git}" REPO_URL="${REPO_URL:-http://100.64.0.1:30087/section0/rta-handbook.git}"
TARGET_DIR="${TARGET_DIR:-$HOME/Developer/Section0/rta-mock-docs}" TARGET_DIR="${TARGET_DIR:-$HOME/Developer/Section0/rta-handbook}"
COMMAND_DIR="${COMMAND_DIR:-$HOME/.local/bin}" COMMAND_DIR="${COMMAND_DIR:-$HOME/.local/bin}"
COMMAND_NAME="${COMMAND_NAME:-rta-mock-docs}" COMMAND_NAME="${COMMAND_NAME:-section0-docs}"
COMMAND_PATH="$COMMAND_DIR/$COMMAND_NAME" COMMAND_PATH="$COMMAND_DIR/$COMMAND_NAME"
step() { step() {
@@ -40,7 +40,7 @@ REPO_DIR="$TARGET_DIR"
usage() { usage() {
cat <<USAGE cat <<USAGE
rta-mock-docs - helper for the RTA mock docs projection repo section0-docs - helper for Section 0 Git Projection repos
Commands: Commands:
open print the repo path open print the repo path
@@ -51,10 +51,10 @@ Commands:
help show this help help show this help
Examples: Examples:
rta-mock-docs pull section0-docs pull
rta-mock-docs status section0-docs status
MESSAGE="Update concept notes" rta-mock-docs commit MESSAGE="Update concept notes" section0-docs commit
rta-mock-docs push section0-docs push
AFFiNE is read-only for this repo. Durable edits happen in Markdown, then the AFFiNE is read-only for this repo. Durable edits happen in Markdown, then the
projection operator pulls and projects. projection operator pulls and projects.