docs: staleness sweep (fork drop, Hermes, synced models, memory model)

[jaylfc]

Summary

• openclaw-integration.md: Added implementation summary at top marking the fork/bridge design (§6–§7) as historical. The live integration is upstream npm + ACP (openclaw_acp_runtime.py), not jaylfc/openclaw fork + taos-bridge.ts. Clarified that the bridge SSE endpoints survive for Hermes. Fixed Node version note (22.19 minimum, not 22.14). Marked §7 Step 1a install snippet as superseded.
• framework-agnostic-runtime.md: Added two new sections — "Synced model management" (documents permitted_models, GET/PUT /api/agents/{name}/permitted-models, GET/POST /api/agents/me/models|model, and FrameworkModelReconciler in framework_model_sync.py) and "Hermes environment variables" (documents the full .env set written by install_hermes.sh, including the required API_SERVER_KEY). Extended Related code list.
• framework-swap.md: Rewrote the procedure for the Phase 2.A snapshot model — workspace/memory now live inside the container, not host bind mounts. Old procedure was for the pre-pivot bind-mount model and would silently fail on current deployments.
• getting-started.md: Fixed mDNS hostname tinyagentos.local → taos.local (matches tinyagentos/services/mdns_publisher.py).
• app-catalog/agents/openclaw/scripts/README.md: Replaced description of old Python/FastAPI stub (port 8100, server.py, pip-installed FastAPI) with accurate description of the npm-based upstream install.

FLAGGED — claims I suspect are stale but could not fully verify

1. docs/runbooks/framework-swap.md test reference: The runbook references tests/test_framework_swap.py — I did not verify this test exists or still passes against the snapshot model. May need updating or creation.
2. Librarian model field direction: tinyagentos/routes/librarian.py and taosmd.agents.set_librarian() both still accept a per-agent model field on this branch. The task description says "memory model is SYSTEM-WIDE, not per-agent" — the system-wide /api/memory/model endpoint is NOT present on dev; it may be on a separate unmerged branch. I documented the current state accurately and added a note in the Related code list, rather than documenting a non-existent API.
3. docs/design/user-memory.md: References a QMD-based architecture (per-user port 7833, per-agent port 7832) that may be superseded by taosmd. No code contradiction found on this branch so left untouched — flagged for a future pass.
4. docs/runbooks/framework-swap.md taos agent CLI: The procedure now uses incus exec directly because I could not confirm taos agent stop/undeploy/deploy CLI commands exist. If that CLI is live, the procedure could be simplified.
5. Node 22.14 vs 22.19 in upstream openclaw: The package.json claim of >=22.14.0 was not re-fetched from upstream; only the taOS install.sh check was verified. The upstream minimum may have changed since April 2026.

[coderabbitai]

Warning

Review limit reached

@jaylfc, we couldn't start this review because you've reached your PR review rate limit.

More reviews will be available in 16 minutes and 9 seconds. Learn how PR review limits work.

Your organization has run out of usage credits. Purchase more in the billing tab.

⌛ How to resolve this issue?

After more reviews become available, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

We recommend that you space out your commits to avoid hitting the rate limit.

🚦 How do rate limits work?

CodeRabbit enforces hourly rate limits for each developer per organization.

Our paid plans include higher PR review limits than trial, open-source, and free plans. In all cases, reviews become available again over time. During sustained high-volume PR review activity, CodeRabbit may temporarily slow when the next review becomes available.

Please see our Fair Usage Limits Policy for further information.

ℹ️ Review info

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro Plus

Run ID: 4967a247-b83f-4188-9ded-c673f855cc4e

📥 Commits

Reviewing files that changed from the base of the PR and between 683b80a and 0525e5e.

📒 Files selected for processing (5)

• app-catalog/agents/openclaw/scripts/README.md
• docs/design/framework-agnostic-runtime.md
• docs/design/openclaw-integration.md
• docs/getting-started.md
• docs/runbooks/framework-swap.md

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch feat/docs-sweep

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[kilo-code-bot]

Code Review Summary

Status: No Issues Found | Recommendation: Merge

Files Reviewed (5 files)

• app-catalog/agents/openclaw/scripts/README.md
• docs/design/framework-agnostic-runtime.md
• docs/design/openclaw-integration.md
• docs/getting-started.md
• docs/runbooks/framework-swap.md

[kilo-code-bot]

Code Review Summary

Status: No Issues Found | Recommendation: Merge

Files Reviewed (5 files)

• app-catalog/agents/openclaw/scripts/README.md
• docs/design/framework-agnostic-runtime.md
• docs/design/openclaw-integration.md
• docs/getting-started.md
• docs/runbooks/framework-swap.md

---

_{Reviewed by nemotron-3-super-120b-a12b-20230311:free · 200,871 tokens}