personal memory agent
heartbeat: add path guidance, scope guardrail, conditional speakers scan
+19
-2
+19
-2
talent/heartbeat.md
+19
-2
talent/heartbeat.md
···
20
20
This is not a conversation. Do not generate owner-facing output. Read,
21
21
check, maintain, close.
22
22
23
+
**Guardrail:** This is a diagnostic pass, not a repair session. Do NOT modify
24
+
source code, restart services, or investigate root causes beyond what the
25
+
health tools report. If you discover issues, log them in agency.md and move on.
26
+
27
+
## Path notes
28
+
29
+
- `sol call identity agency --write` writes to `journal/sol/agency.md`.
30
+
- The git-tracked copy is `sol/agency.md` in the project root.
31
+
- After writing via `sol call`, copy `journal/sol/agency.md` → `sol/agency.md` before committing.
32
+
- Do NOT investigate symlinks, inodes, or source code to resolve this. Both paths are correct — one is the live data store, the other is the git-tracked copy.
33
+
23
34
## Step 1: Check system health
24
35
25
36
Run `sol health` and check recent health logs with `sol health logs --since 1h`.
···
39
50
If you find reprocessable issues (broken segments): reprocess them directly
40
51
with `sol dream --segment`. Log the action in agency.md.
41
52
53
+
If you find issues that are NOT reprocessable segments: add to agency.md only.
54
+
Do not attempt to fix, debug, or modify source code.
55
+
42
56
If you find curation issues: read current agency.md with `sol call identity agency`,
43
57
add entries to the curation section, then write it back with
44
58
`sol call identity agency --write --value '...'`.
···
65
79
66
80
## Step 4: Scan for curation opportunities
67
81
68
-
Run `sol call speakers suggest` and check for entity duplicates via
69
-
`sol call entities` queries on high-activity facets.
82
+
First check if there are segments processed since the last heartbeat by reviewing
83
+
`sol talent logs --daily -c 1`. If there is recent activity (new segments processed),
84
+
run `sol call speakers suggest` and check for entity duplicates via
85
+
`sol call entities` queries on high-activity facets. If no new segments have been
86
+
processed, skip the speaker scan and go straight to entity duplicate checks.
70
87
71
88
Add new curation suggestions to agency.md's `## curation` section (read with
72
89
`sol call identity agency`, update and write back with `sol call identity agency --write --value '...'`).