bootstrap: projects management repo

README.md

@@ -0,0 +1,45 @@
+Projects Management Repo (auto-updated by OpenClaw)
+
+Goal
+- OpenClaw updates this repo automatically (on main) to keep a durable project index.
+- Humans read it offline. Do not hand-edit PROJECTS_INDEX.md.
+
+Files
+- projects.json           Source of truth (machine-edited)
+- PROJECTS_INDEX.md       Generated from projects.json (human-readable)
+- tools/projectsctl       The ONLY allowed writer (adds/updates + commits + pushes)
+- tools/render_projects_index.py  Generator/validator
+
+Prereqs (Debian/Ubuntu)
+- sudo apt-get update
+- sudo apt-get install -y git jq python3 util-linux
+
+Bootstrap
+1) Generate the index:
+   ./tools/projectsctl render
+
+2) Add a project (example):
+   PROJREPO=$(pwd) ./tools/projectsctl add "CognitiveOS" active \
+     "https://git.molloyhome.net/mmolloy/Cognition-OS" \
+     "/home/openclaw/.openclaw/workspace/repo-Cognition-OS" \
+     "Deterministic microkernel-style control plane for LLM/agent systems."
+
+3) Change status:
+   PROJREPO=$(pwd) ./tools/projectsctl set-status "CognitiveOS" paused
+
+4) Update notes:
+   PROJREPO=$(pwd) ./tools/projectsctl update-notes "CognitiveOS" "New notes here..."
+
+Making OpenClaw read this reliably
+- Symlink PROJECTS_INDEX.md into OpenClaw’s indexed memory folder:
+
+  ln -sf /opt/projects/projects-mgmt/PROJECTS_INDEX.md ~/.openclaw/memory/projects_index.md
+  sudo systemctl restart openclaw-gateway
+
+Then confirm it’s indexed:
+  sqlite3 ~/.openclaw/memory/main.sqlite "SELECT path FROM files WHERE path LIKE '%projects_index%';"
+
+Operational contract (recommended)
+- OpenClaw MUST use tools/projectsctl for any changes.
+- Never edit PROJECTS_INDEX.md directly.
+- If push fails, OpenClaw must report the error (no silent drift).