personal memory agent
activities: document participation field and --source filter
Participation shipped 4/18 (commit 101da52e) but skill was never updated.
Adds the schema (name, role ∈ {attendee, mentioned}, source ∈ {voice,
speaker_label, transcript, screen, other}, confidence, context) and a
worked example. Also adds the --source filter flag on list (anticipated,
user, cogitate).
Plus Invoke via Bash line and literal command names in TRIGGER.
Part of skills audit req_loq3e2lk pass 1+2.
+26
-4
+26
-4
apps/activities/talent/activities/SKILL.md
+26
-4
apps/activities/talent/activities/SKILL.md
···
7
7
completed spans, muted activity records, or wants to review or edit an
8
8
activity entry.
9
9
TRIGGER: activity, activities, work session, completed span, mute activity,
10
-
unmute activity, activity record.
10
+
unmute activity, activity record, meeting attendees, participation,
11
+
sol call activities list, sol call activities create,
12
+
sol call activities update, sol call activities mute,
13
+
sol call activities unmute, sol call activities get.
11
14
---
12
15
13
16
# Activities CLI Skill
14
17
15
-
Use these commands to manage completed activity records from the terminal.
18
+
Manage completed activity records. Invoke via Bash: `sol call activities <command> [args...]`.
16
19
17
20
**Environment defaults**: When `SOL_DAY` is set, commands that take `DAY` use it automatically. Same for `SOL_FACET` where `FACET` is accepted.
18
21
···
25
28
## list
26
29
27
30
```bash
28
-
sol call activities list [-d DAY | --from DAY --to DAY] [-f FACET] [-a ACTIVITY] [--entity ENTITY] [--all] [--json]
31
+
sol call activities list [-d DAY | --from DAY --to DAY] [-f FACET] [-a ACTIVITY] [--entity ENTITY] [--source SOURCE] [--all] [--json]
29
32
```
30
33
31
34
List activity records for one day or an inclusive day range.
···
35
38
- `-f, --facet`: optional facet filter. Omit to include all facets.
36
39
- `-a, --activity`: optional activity-type filter.
37
40
- `--entity`: optional active-entity filter.
41
+
- `--source`: optional record-source filter (`anticipated`, `user`, or `cogitate`). Omit to include all sources.
38
42
- `--all`: include hidden activity records.
39
43
- `--json`: emit raw JSON instead of formatted text.
40
44
···
82
86
Stdin JSON requirements:
83
87
84
88
- Required: `title`, `activity`
85
-
- Optional: `description`, `details`
89
+
- Optional: `description`, `details`, `participation`
90
+
91
+
`participation` is an array of participant objects. Each entry must include:
92
+
93
+
- `name`: non-empty string.
94
+
- `role`: `"attendee"` or `"mentioned"`.
95
+
- `source`: one of `"voice"`, `"speaker_label"`, `"transcript"`, `"screen"`, `"other"`.
96
+
- `confidence`: number (typically 0.0-1.0).
97
+
- `context`: string describing where the detection came from.
98
+
99
+
Names are resolved against journal entities after validation; any caller-supplied `entity_id` is ignored.
86
100
87
101
Examples:
88
102
89
103
```bash
90
104
echo '{"title":"Deep work","activity":"coding"}' | sol call activities create -f work
91
105
echo '{"title":"Session review","activity":"coding","details":"Retrospective notes"}' | sol call activities create -f work --since-segment 090000_300 --source cogitate --json
106
+
echo '{
107
+
"title":"Sync with Alicia",
108
+
"activity":"meeting",
109
+
"participation":[
110
+
{"name":"Alicia Chen","role":"attendee","source":"voice","confidence":0.95,"context":"voice detected start of segment"},
111
+
{"name":"You","role":"attendee","source":"screen","confidence":1.0,"context":"screen share"}
112
+
]
113
+
}' | sol call activities create -f work
92
114
```
93
115
94
116
## update