Skip to content

docs: session sources supported today and planned (groundwork for #3)#27

Draft
ohad6k wants to merge 1 commit into
mainfrom
agents/sources-page
Draft

docs: session sources supported today and planned (groundwork for #3)#27
ohad6k wants to merge 1 commit into
mainfrom
agents/sources-page

Conversation

@ohad6k

@ohad6k ohad6k commented Jul 23, 2026

Copy link
Copy Markdown
Owner

Adds docs/SOURCES.md: every session-log source supported today, every one planned, and how to add another. Groundwork for #3, documentation only, no adapter code.

Supported sources were read out of the SOURCES table, user_messages() and discover_files() rather than from memory, with the test file that covers each one named next to it.

Findings worth knowing

  • Copilot CLI has no dedicated test coverage. Nothing in the suite references session-state, events.jsonl, or its user.message shape. Documented as the least covered adapter instead of listing it beside the tested ones.
  • There is no per-OS path logic. The only platform-relevant branch anywhere is XDG_DATA_HOME; everything else is ~-relative. Written up as a limitation rather than inventing macOS/Windows paths.
  • Cursor, Windsurf and OpenClaw layouts are marked unverified, matching what ROADMAP.md says.
  • The Hermes storage spec lives in ROADMAP.md, not in docs/OPENCLAW_HERMES.md (that doc covers the opposite direction). Summarised from the roadmap and linked rather than duplicated.

Written by an agent working in an isolated worktree, reviewed before push.

Groundwork for issue #3. Every path, record shape, and filter traces to
emulo.py or a test file; Copilot CLI is marked as the least covered
adapter and the planned Cursor/Windsurf/OpenClaw layouts as unverified.
Hermes links to docs/OPENCLAW_HERMES.md instead of duplicating it.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@vercel

vercel Bot commented Jul 23, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
ditto Ready Ready Preview, Comment Jul 23, 2026 1:07pm

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant