Add memory care and multi-workspace handoff support

[solomonneas]

Summary

• Add starter cards for multi-workspace handoff administration and memory-care staleness checks.
• Wire the new cards into workspace installs and update the public docs/runbooks.
• Extend solo-mise doctor to report memory-care decay files and OpenClaw cron-backed handoff/card-decay jobs.

Validation

• PYTHONPATH=src python3 -m pytest -q
• PYTHONPATH=$HOME/repos/content-guard/src python3 -m content_guard scan . --policy $HOME/repos/content-guard/policies/public-repo.json
• workspace init smoke under /tmp/solo-mise-smoke
• live OpenClaw doctor against ~/.openclaw/workspace

Summary by CodeRabbit

• New Features

  • Multi-workspace handoff administration for managing multiple agent homes with a canonical memory owner
  • Memory care staleness scanning to identify and refresh outdated memory cards
  • Enhanced diagnostic checks for memory care setup and scheduled job verification

• Documentation

  • Comprehensive guides for multi-workspace workflows, memory maintenance, and staleness scan procedures across installation and quickstart materials

• Tests

  • Added coverage for memory care diagnostics and cron job verification functionality

[coderabbitai]

Caution

Review failed

The pull request is closed.

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 7736e203-e150-406a-b5be-42206baec2a1

📥 Commits

Reviewing files that changed from the base of the PR and between f3e6c7f and f613383.

📒 Files selected for processing (24)

• AGENTS.md
• INSTALL_FOR_AGENTS.md
• MEMORY.md
• QUICKSTART.md
• README.md
• TOOLS.md
• memory/cards/handoff-flow.md
• memory/cards/memory-architecture.md
• memory/cards/memory-care-staleness.md
• memory/cards/memory-scanner.md
• memory/cards/multi-workspace-handoff-admin.md
• src/solo_mise/doctor.py
• src/solo_mise/templates/memory/cards/handoff-flow.md
• src/solo_mise/templates/memory/cards/memory-architecture.md
• src/solo_mise/templates/memory/cards/memory-care-staleness.md
• src/solo_mise/templates/memory/cards/memory-scanner.md
• src/solo_mise/templates/memory/cards/multi-workspace-handoff-admin.md
• src/solo_mise/templates/profiles/workspace.json
• src/solo_mise/templates/workspace/AGENTS.md
• src/solo_mise/templates/workspace/INSTALL_FOR_AGENTS.md
• src/solo_mise/templates/workspace/MEMORY.md
• src/solo_mise/templates/workspace/TOOLS.md
• tests/test_doctor.py
• tests/test_init.py

---

📝 Walkthrough

Walkthrough

This PR introduces memory-care staleness scanning and multi-workspace handoff coordination. Staleness scanning detects and safely refreshes outdated cards. Multi-workspace handoffs enable hub-and-spoke coordination where secondary workspaces route memory to a canonical owner via staging. The doctor command gains verification checks for both features, and workspace templates are updated to integrate them.

Changes

Memory-care Staleness and Multi-workspace Handoffs

Layer / File(s)	Summary
Memory-care staleness foundation memory/cards/memory-care-staleness.md, src/solo_mise/templates/memory/cards/memory-care-staleness.md, memory/cards/memory-architecture.md, memory/cards/memory-scanner.md	New staleness scanning process: decay scanner writes scan-latest.json and refresh-queue.json, safe refresh rules exclude judgment-heavy content, schedule is daily scan and weekly manual review, verification includes jq checks on queue size. Memory scanner documentation cross-references the staleness loop.
Multi-workspace handoff admin pattern memory/cards/multi-workspace-handoff-admin.md, src/solo_mise/templates/memory/cards/multi-workspace-handoff-admin.md, memory/cards/handoff-flow.md	Hub-and-spoke workflow: secondary workspaces write handoffs locally, canonical owner pulls into staging directories via rsync, then injects via solo-mise ingest. Admin rules enforce staging-before-ingest, exclude processed/, preserve original text, and label per-source. Verification confirms incoming files and dry-run ingest.
Doctor verification checks src/solo_mise/doctor.py, tests/test_doctor.py	New _check_memory_care() validates memory/cards/decay/ directory and JSON files, extracting scan date and queue counts. New _check_openclaw_cron_jobs() audits ~/.openclaw/cron/jobs.json, verifies expected jobs exist and are enabled, formats schedules into human-readable text via _format_schedule() and _find_job() helpers. Tests fixture memory-care JSON and openclaw cron configurations.
Workspace templates and profile wiring src/solo_mise/templates/profiles/workspace.json, src/solo_mise/templates/workspace/AGENTS.md, src/solo_mise/templates/workspace/MEMORY.md, src/solo_mise/templates/workspace/INSTALL_FOR_AGENTS.md, src/solo_mise/templates/workspace/TOOLS.md, AGENTS.md, MEMORY.md, INSTALL_FOR_AGENTS.md, TOOLS.md, QUICKSTART.md, README.md, tests/test_init.py	Profile registers two new memory card files (memory-care-staleness.md, multi-workspace-handoff-admin.md). AGENTS and MEMORY templates add "Memory-care staleness scan" job to daily rhythm during quiet hours. INSTALL_FOR_AGENTS instructs secondary setups to read multi-workspace handoff card and route durable truth via handoffs; instructs established card maintainers to read staleness card. TOOLS template adds memory-care commands for scanning and queue inspection. README/QUICKSTART add multi-workspace and staleness features to getting-started guidance. Tests verify new card files are included in workspace profile.

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~25 minutes

Poem

🐰 Two homes now speak through careful relay,
Stale memories refreshed at end of day,
The hub collects, the branches send,
A trusted sync that help extends,
Safe refresh rules keep judgment dear,
While staleness scans keep knowledge clear!

✨ Finishing Touches

📝 Generate docstrings

• Create stacked PR
• Commit on current branch

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch codex/memory-care-multi-workspace

Tip

💬 Introducing Slack Agent: The best way for teams to turn conversations into code.

Slack Agent is built on CodeRabbit's deep understanding of your code, so your team can collaborate across the entire SDLC without losing context.

• Generate code and open pull requests
• Plan features and break down work
• Investigate incidents and troubleshoot customer tickets together
• Automate recurring tasks and respond to alerts with triggers
• Summarize progress and report instantly

Built for teams:

• Shared memory across your entire org—no repeating context
• Per-thread sandboxes to safely plan and execute work
• Governance built-in—scoped access, auditability, and budget controls

One agent for your entire SDLC. Right inside Slack.

👉 Get started

---

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.}