Export

Export

Turn a finished research session into a file knowledge-intake can read without reformatting.

When To Use

After a research session has findings and you want them stored rather than merely reported.

When NOT To Use

• The session is still gathering findings: finish Skill(tome:research) first, since an export of an empty session emits only frontmatter.
• You want a human-readable report: use Skill(tome:synthesize), which produces the narrative form with coverage and gaps.

Workflow

Load the session and render it:

from pathlib import Path

from tome.session import SessionManager
from tome.output.export import export_for_memory_palace

session = SessionManager(Path.cwd()).load_latest()
markdown = export_for_memory_palace(session)
Path(f"docs/research/export-{session.id}.md").write_text(markdown)

SessionManager resolves its store relative to the path it is given, so run this from the repository root or the session will not be found.

To export a specific session, use load(session_id) instead of load_latest().

What It Emits

YAML frontmatter carrying topic, domain, session_id, date, finding_count, channels, and type: research-export, followed by findings grouped by channel. Each finding renders its source, URL, relevance, summary, and channel-specific metadata.

An empty session emits the frontmatter and a line stating that no findings were recorded, which is deliberate. A silent empty file would read as a successful export of nothing.

Handoff

The output is an external resource, not a corpus entry. Feed it to Skill(memory-palace:knowledge-intake), which owns evaluation, routing, and storage. This skill does no scoring.

Exit Criteria

• export_for_memory_palace was called on a loaded session
• The output file exists and its frontmatter includes type: research-export
• finding_count in the frontmatter matches the session's findings
• The file was handed to Skill(memory-palace:knowledge-intake) or its path was reported for later intake