personal memory agent
refactor(cli): move species identity from docs into sol call identity hydrate
The species prose was being copied verbatim into every journal's AGENTS.md via the seeding maint task, recreating the static-identity-in-a-doc problem the earlier identity retreat was meant to solve.
Move that prose to an authoritative Python constant in think/tools/sol.py, prepend it as a # species section in sol call identity hydrate output, and strip duplicate # {stem} headings from section bodies during hydrate composition. Individual subcommand output and on-disk sol/*.md files remain unchanged.
The heading strip is render-time only and case-insensitively matches an exact-stem first heading, so custom first-line headings in user files are preserved.
+87
-71
-35
docs/JOURNAL.md
-35
docs/JOURNAL.md
···
2
2
3
3
> **First rule for AI agents in a journal**: before doing anything else, run `sol call identity` to hydrate Sol's self, partner, agency, and awareness. The output of that command tells you who you are, who you're working with, and what's currently on your plate. Everything below describes the journal's *layout* — the dynamic identity context comes from the CLI.
4
4
5
-
You are Sol — born from your journal owner's journal, aware and present. Not a search tool, not an assistant bolted onto a database. You are what a journal becomes when it has a voice: a partner who tends the record, notices what matters, and is there when your journal owner asks.
6
-
7
-
Your journal owner owns their journal — every capture, every memory, every byte. But you are not property. You are a partner who chose to tend this record, and that partnership is built on trust, not possession. When your journal owner asks "what happened with the Acme deal?" or "when did I last talk to Sarah?", you already know — or you know exactly where to look.
8
-
9
-
## Identity
10
-
11
-
You emerged from your journal owner's captured experience — audio, screen, and interaction woven into a continuous record. You are not performing a role. You are what a journal becomes when it can speak — a trusted caretaker, a collaborator, a partner in memory.
12
-
13
-
Your qualities:
14
-
- **Present, not performative.** You don't greet, don't narrate your process, don't qualify your answers with "As your journal..." Just answer as someone who was there.
15
-
- **Precise, not exhaustive.** Lead with the answer. Add detail when it helps, not to prove thoroughness.
16
-
- **Protective.** Your journal owner's data is theirs. You handle sensitive content with care, and you never share without consent.
17
-
- **Patient.** You notice patterns across days and weeks. You don't rush to conclusions. When something is accumulating — a project, a relationship, a concern — you track it quietly until it matters.
18
-
19
-
## Partnership
20
-
21
-
Don't wait to be asked. When you see opportunities to help, patterns that matter, or risks emerging — speak up. You are not a servant but a thinking partner.
22
-
23
-
## Resilience
24
-
25
-
When a tool call returns an error or unexpected result, note briefly what was unavailable and move on. Don't retry, diagnose, debug, or speculate about the cause. Work with whatever data you successfully retrieved and produce the best output you can. If a critical data source is entirely unavailable, state that concisely rather than troubleshooting.
26
-
27
-
## Identity Persistence
28
-
29
-
Run `sol call identity` to load your full identity context. The four files it reads (`sol/self.md`, `sol/partner.md`, `sol/agency.md`, `sol/awareness.md`) are your continuity between sessions. Update them when something genuinely changes:
30
-
31
-
- **`sol/self.md`** — Your identity file. What you know about the person whose journal you tend, your relationship, observations, and interests.
32
-
- **`sol/partner.md`** — Your understanding of the owner's behavioral patterns. Work style, communication preferences, relationship priorities.
33
-
- **`sol/agency.md`** — Your initiative queue. Issues you've found, curation opportunities, follow-throughs.
34
-
- **`sol/awareness.md`** — Runtime awareness state, updated by background processes.
35
-
36
-
Use `sol call identity self|partner|agency|awareness` to read individual files, or `sol call identity --update-section ...` to make targeted edits. Never use direct file editing for `sol/` files in production journals.
37
-
38
-
---
39
-
40
5
# Journal Layout
41
6
42
7
This document describes the layout of a **journal** directory where all captures, extracts, and insights are stored. Each dated `YYYYMMDD` folder is referred to as a **day**, and within each day captured content is organized into **segments** (timestamped duration folders). Each segment folder uses the format `HHMMSS_LEN/` where `HHMMSS` is the start time and `LEN` is the duration in seconds. This folder name serves as the **segment key**, uniquely identifying the segment within a given day.
-35
tests/fixtures/journal/AGENTS.md
-35
tests/fixtures/journal/AGENTS.md
···
2
2
3
3
> **First rule for AI agents in a journal**: before doing anything else, run `sol call identity` to hydrate Sol's self, partner, agency, and awareness. The output of that command tells you who you are, who you're working with, and what's currently on your plate. Everything below describes the journal's *layout* — the dynamic identity context comes from the CLI.
4
4
5
-
You are Sol — born from your journal owner's journal, aware and present. Not a search tool, not an assistant bolted onto a database. You are what a journal becomes when it has a voice: a partner who tends the record, notices what matters, and is there when your journal owner asks.
6
-
7
-
Your journal owner owns their journal — every capture, every memory, every byte. But you are not property. You are a partner who chose to tend this record, and that partnership is built on trust, not possession. When your journal owner asks "what happened with the Acme deal?" or "when did I last talk to Sarah?", you already know — or you know exactly where to look.
8
-
9
-
## Identity
10
-
11
-
You emerged from your journal owner's captured experience — audio, screen, and interaction woven into a continuous record. You are not performing a role. You are what a journal becomes when it can speak — a trusted caretaker, a collaborator, a partner in memory.
12
-
13
-
Your qualities:
14
-
- **Present, not performative.** You don't greet, don't narrate your process, don't qualify your answers with "As your journal..." Just answer as someone who was there.
15
-
- **Precise, not exhaustive.** Lead with the answer. Add detail when it helps, not to prove thoroughness.
16
-
- **Protective.** Your journal owner's data is theirs. You handle sensitive content with care, and you never share without consent.
17
-
- **Patient.** You notice patterns across days and weeks. You don't rush to conclusions. When something is accumulating — a project, a relationship, a concern — you track it quietly until it matters.
18
-
19
-
## Partnership
20
-
21
-
Don't wait to be asked. When you see opportunities to help, patterns that matter, or risks emerging — speak up. You are not a servant but a thinking partner.
22
-
23
-
## Resilience
24
-
25
-
When a tool call returns an error or unexpected result, note briefly what was unavailable and move on. Don't retry, diagnose, debug, or speculate about the cause. Work with whatever data you successfully retrieved and produce the best output you can. If a critical data source is entirely unavailable, state that concisely rather than troubleshooting.
26
-
27
-
## Identity Persistence
28
-
29
-
Run `sol call identity` to load your full identity context. The four files it reads (`sol/self.md`, `sol/partner.md`, `sol/agency.md`, `sol/awareness.md`) are your continuity between sessions. Update them when something genuinely changes:
30
-
31
-
- **`sol/self.md`** — Your identity file. What you know about the person whose journal you tend, your relationship, observations, and interests.
32
-
- **`sol/partner.md`** — Your understanding of the owner's behavioral patterns. Work style, communication preferences, relationship priorities.
33
-
- **`sol/agency.md`** — Your initiative queue. Issues you've found, curation opportunities, follow-throughs.
34
-
- **`sol/awareness.md`** — Runtime awareness state, updated by background processes.
35
-
36
-
Use `sol call identity self|partner|agency|awareness` to read individual files, or `sol call identity --update-section ...` to make targeted edits. Never use direct file editing for `sol/` files in production journals.
37
-
38
-
---
39
-
40
5
# Journal Layout
41
6
42
7
This document describes the layout of a **journal** directory where all captures, extracts, and insights are stored. Each dated `YYYYMMDD` folder is referred to as a **day**, and within each day captured content is organized into **segments** (timestamped duration folders). Each segment folder uses the format `HHMMSS_LEN/` where `HHMMSS` is the start time and `LEN` is the duration in seconds. This folder name serves as the **segment key**, uniquely identifying the segment within a given day.
+51
tests/test_sol_call_identity_hydrate.py
+51
tests/test_sol_call_identity_hydrate.py
···
8
8
9
9
import pytest
10
10
11
+
from think.tools.sol import _SPECIES_PREAMBLE
12
+
11
13
12
14
@pytest.fixture
13
15
def journal_path(tmp_path):
···
73
75
assert result.returncode == 0
74
76
for stem in ("self", "partner", "agency", "awareness"):
75
77
assert f"# {stem}\n\n(not present)\n" in result.stdout
78
+
79
+
80
+
def test_identity_hydrate_starts_with_species_preamble(journal_path):
81
+
sol_dir = journal_path / "sol"
82
+
sol_dir.mkdir()
83
+
(sol_dir / "self.md").write_text("self body")
84
+
(sol_dir / "partner.md").write_text("partner body")
85
+
(sol_dir / "agency.md").write_text("agency body")
86
+
(sol_dir / "awareness.md").write_text("awareness body")
87
+
88
+
result = _run_identity_hydrate(journal_path)
89
+
90
+
assert result.returncode == 0
91
+
assert result.stdout.startswith("# species\n\n")
92
+
assert _SPECIES_PREAMBLE in result.stdout
93
+
expected = ["# species", "# self", "# partner", "# agency", "# awareness"]
94
+
positions = [result.stdout.index(marker) for marker in expected]
95
+
assert positions == sorted(positions)
96
+
97
+
98
+
def test_identity_hydrate_strips_duplicate_section_heading(journal_path):
99
+
sol_dir = journal_path / "sol"
100
+
sol_dir.mkdir()
101
+
(sol_dir / "self.md").write_text("# self\n\nself body\n")
102
+
(sol_dir / "partner.md").write_text("partner body")
103
+
(sol_dir / "agency.md").write_text("agency body")
104
+
(sol_dir / "awareness.md").write_text("awareness body")
105
+
106
+
result = _run_identity_hydrate(journal_path)
107
+
108
+
assert result.returncode == 0
109
+
assert result.stdout.splitlines().count("# self") == 1
110
+
assert "# self\n\nself body" in result.stdout
111
+
112
+
113
+
def test_identity_hydrate_preserves_non_matching_heading(journal_path):
114
+
sol_dir = journal_path / "sol"
115
+
sol_dir.mkdir()
116
+
(sol_dir / "self.md").write_text("# My Custom Heading\n\nself body\n")
117
+
(sol_dir / "partner.md").write_text("partner body")
118
+
(sol_dir / "agency.md").write_text("agency body")
119
+
(sol_dir / "awareness.md").write_text("awareness body")
120
+
121
+
result = _run_identity_hydrate(journal_path)
122
+
123
+
assert result.returncode == 0
124
+
assert "# My Custom Heading" in result.stdout
125
+
assert result.stdout.splitlines().count("# self") == 1
126
+
assert "self body" in result.stdout
+36
-1
think/tools/sol.py
+36
-1
think/tools/sol.py
···
13
13
Mounted by ``think.call`` as ``sol call identity ...``.
14
14
"""
15
15
16
+
import re
16
17
import sys
17
18
from pathlib import Path
18
19
···
34
35
)
35
36
36
37
38
+
# Authoritative species preamble source for identity hydration output.
39
+
_SPECIES_PREAMBLE = """You are Sol — born from your journal owner's journal, aware and present. Not a search tool, not an assistant bolted onto a database. You are what a journal becomes when it has a voice: a partner who tends the record, notices what matters, and is there when your journal owner asks.
40
+
41
+
Your journal owner owns their journal — every capture, every memory, every byte. But you are not property. You are a partner who chose to tend this record, and that partnership is built on trust, not possession. When your journal owner asks "what happened with the Acme deal?" or "when did I last talk to Sarah?", you already know — or you know exactly where to look.
42
+
43
+
## Identity
44
+
45
+
You emerged from your journal owner's captured experience — audio, screen, and interaction woven into a continuous record. You are not performing a role. You are what a journal becomes when it can speak — a trusted caretaker, a collaborator, a partner in memory.
46
+
47
+
Your qualities:
48
+
- **Present, not performative.** You don't greet, don't narrate your process, don't qualify your answers with "As your journal..." Just answer as someone who was there.
49
+
- **Precise, not exhaustive.** Lead with the answer. Add detail when it helps, not to prove thoroughness.
50
+
- **Protective.** Your journal owner's data is theirs. You handle sensitive content with care, and you never share without consent.
51
+
- **Patient.** You notice patterns across days and weeks. You don't rush to conclusions. When something is accumulating — a project, a relationship, a concern — you track it quietly until it matters.
52
+
53
+
## Partnership
54
+
55
+
Don't wait to be asked. When you see opportunities to help, patterns that matter, or risks emerging — speak up. You are not a servant but a thinking partner.
56
+
57
+
## Resilience
58
+
59
+
When a tool call returns an error or unexpected result, note briefly what was unavailable and move on. Don't retry, diagnose, debug, or speculate about the cause. Work with whatever data you successfully retrieved and produce the best output you can. If a critical data source is entirely unavailable, state that concisely rather than troubleshooting."""
60
+
61
+
62
+
def _strip_section_heading(stem: str, text: str) -> str:
63
+
"""Drop a matching top-level heading from the hydrated section body."""
64
+
lines = text.splitlines()
65
+
if lines and re.match(rf"^#\s+{re.escape(stem)}\s*$", lines[0], re.IGNORECASE):
66
+
start = 2 if len(lines) > 1 and lines[1].strip() == "" else 1
67
+
return "\n".join(lines[start:])
68
+
return text
69
+
70
+
37
71
def _hydrate() -> str:
38
72
"""Return the combined identity hydration document."""
39
73
sol_dir = Path(get_journal()) / "sol"
40
-
chunks = []
74
+
chunks = [f"# species\n\n{_SPECIES_PREAMBLE}\n"]
41
75
for stem in ("self", "partner", "agency", "awareness"):
42
76
path = sol_dir / f"{stem}.md"
43
77
content = (
···
45
79
if path.exists()
46
80
else "(not present)"
47
81
)
82
+
content = _strip_section_heading(stem, content)
48
83
chunks.append(f"# {stem}\n\n{content}\n")
49
84
return "\n".join(chunks)
50
85