personal memory agent
apps/import: register journal source card and guide page
- Adds journal_archive to SOURCE_METADATA with display name "Journal".
- Adds apps/import/guides/journal_archive.md covering same-machine CLI export, sol-transfer scope note, cross-machine flow, and manual zip fallback.
Co-Authored-By: OpenAI Codex <codex@openai.com>
+49
+38
apps/import/guides/journal_archive.md
+38
apps/import/guides/journal_archive.md
···
1
+
# Exporting Your Journal
2
+
3
+
If you're moving a journal between machines, export it as a `.zip` and bring it here.
4
+
5
+
## On this machine
6
+
7
+
If your other journal is on this same machine:
8
+
9
+
1. Open Terminal.
10
+
2. Run:
11
+
12
+
```bash
13
+
sol call journal export --out ~/Downloads/journal.zip
14
+
```
15
+
16
+
3. Wait for the command to print the archive path.
17
+
4. Upload that `.zip` here.
18
+
19
+
### About sol-transfer
20
+
21
+
`sol transfer` moves raw observations between machines — it doesn't move your merged journal, facets, entities, or import history. Use `sol call journal export` for that.
22
+
23
+
## From another machine
24
+
25
+
1. On the source machine, run `sol call journal export --out <path>`.
26
+
2. Move the `.zip` to this machine however you'd normally move a file.
27
+
3. Upload it under the Journal card on this screen.
28
+
29
+
## Manual fallback
30
+
31
+
If the source machine doesn't have `sol call journal export`, you can `zip` the journal directly:
32
+
33
+
```bash
34
+
cd /path/to/source/solstone
35
+
zip -r journal.zip ./journal
36
+
```
37
+
38
+
The importer accepts either a direct journal-root archive or a single wrapper folder containing `chronicle/`, `entities/`, `facets/`, and `imports/`.
+11
apps/import/routes.py
+11
apps/import/routes.py
···
116
116
"accept": ".txt",
117
117
},
118
118
{
119
+
"name": "journal_archive",
120
+
"display_name": "Journal",
121
+
"emoji": "📓",
122
+
"icon": "book",
123
+
"description": "Import a full journal export from another solstone journal",
124
+
"input_type": "file",
125
+
"upload_prompt": "Upload your journal export .zip file",
126
+
"has_guide": True,
127
+
"accept": ".zip",
128
+
},
129
+
{
119
130
"name": "granola",
120
131
"display_name": "Granola",
121
132
"emoji": "🌾",