docs: define session/workspace/global memory ownership for multi-session daemon

[xinhuagu]

Summary

• Audit all memory stores, learning write paths, and persistent state by scope
• Classify each store as session-local, workspace-scoped, or global/user-scoped
• Document concurrency guarantees (locks, atomic writes, file-level locks)
• Map promotion paths: session-local → workspace → global
• Document complete file system layout under ~/.aceclaw/ and {projectRoot}/.aceclaw/
• Identify 3 follow-up code tasks for known limitations
• Cross-reference from multi-session.md

Key Findings

• All stores are safe for multi-session concurrent access (locks/atomic writes)
• CandidateStore full-file rewrite is the main concurrency concern (mitigated by infrequent transitions)
• Learning pipeline runs after session close, reducing contention
• Legacy project-{hashCode}.jsonl format co-exists with WorkspacePaths routing

Closes #347

[greptile-apps]

Your free trial has ended. If you'd like to continue receiving code reviews, you can add a payment method here.

[coderabbitai]

Important

Review skipped

Review was skipped due to path filters

⛔ Files ignored due to path filters (2)

• docs/memory-ownership.md is excluded by !**/*.md, !docs/**
• docs/multi-session.md is excluded by !**/*.md, !docs/**

CodeRabbit blocks several paths by default. You can override this behavior by explicitly including those paths in the path filters. For example, including **/dist/** will override the default block on the dist directory, by removing the pattern from both the lists.

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro

Run ID: e39d7bc3-42c6-454e-899d-ab3e38cacf1b

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch docs/347-memory-ownership-model

---

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