personal memory agent
docs: sharpen consent flag behavioral guidance in muse docs
Strengthen --consent documentation from informational to prescriptive:
- unified.md: "requires --consent when called by a proactive agent" on
create, rename, delete
- SKILL.md: add when-to-use context (proactive vs direct-response),
onboarding carve-out on create, and agent double-flag guidance on delete
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
+6
-6
+3
-3
muse/journal/SKILL.md
+3
-3
muse/journal/SKILL.md
···
99
99
- `--emoji`: optional icon emoji (default: `📦`).
100
100
- `--color`: optional hex color (default: `#667eea`).
101
101
- `--description`: optional description text.
102
-
- `--consent`: optional flag asserting explicit user approval was obtained; adds `"consent": true` to the audit log entry.
102
+
- `--consent`: asserts that the agent has received a direct user request or explicit user approval before calling this command. Pass when acting proactively (cogitate, suggestion flows) rather than in direct response to a user instruction. Omit for the onboarding muse — onboarding is user-driven by definition. Adds `"consent": true` to the audit log entry.
103
103
104
104
Examples:
105
105
···
138
138
139
139
- `name`: current facet identifier.
140
140
- `new-name`: new facet identifier.
141
-
- `--consent`: optional flag asserting explicit user approval was obtained; adds `"consent": true` to the audit log entry.
141
+
- `--consent`: asserts that the agent has received explicit user approval before performing this structural change. Pass when acting proactively rather than in direct response to a user instruction. Adds `"consent": true` to the audit log entry.
142
142
143
143
Example:
144
144
···
183
183
Delete a facet directory and all its data.
184
184
185
185
- `--yes`: skip confirmation prompt.
186
-
- `--consent`: optional flag asserting explicit user approval was obtained; adds `"consent": true` to the audit log entry.
186
+
- `--consent`: asserts that the agent has received explicit user approval before performing this destructive operation. Agents should always pass both `--consent` and `--yes` when calling delete. Adds `"consent": true` to the audit log entry.
187
187
188
188
Example:
189
189
+3
-3
muse/unified.md
+3
-3
muse/unified.md
···
83
83
### Journal
84
84
- `sol call journal events [DAY] [-f FACET]` — List events with participants, times, and summaries.
85
85
- `sol call journal facet show [name]` — Show facet details.
86
-
- `sol call journal facet create <title> [--emoji EMOJI] [--color COLOR] [--description DESC] [--consent]` — Create a new facet. Pass `--consent` to record explicit user approval in the audit log.
86
+
- `sol call journal facet create <title> [--emoji EMOJI] [--color COLOR] [--description DESC] [--consent]` — Create a new facet. Requires `--consent` when called by a proactive agent (must have explicit user approval before calling).
87
87
- `sol call journal facet update <name> [--title T] [--description D] [--emoji E] [--color C]` — Update facet metadata fields.
88
-
- `sol call journal facet rename <name> <new-name> [--consent]` — Rename a facet. Pass `--consent` to record explicit user approval in the audit log.
88
+
- `sol call journal facet rename <name> <new-name> [--consent]` — Rename a facet. Requires `--consent` when called by a proactive agent (must have explicit user approval before calling).
89
89
- `sol call journal facet mute <name>` — Hide a facet from default listings.
90
90
- `sol call journal facet unmute <name>` — Show a previously muted facet in default listings.
91
-
- `sol call journal facet delete <name> [--yes] [--consent]` — Delete a facet and all its data. Pass `--consent` to record explicit user approval in the audit log.
91
+
- `sol call journal facet delete <name> --yes [--consent]` — Delete a facet and all its data. Requires `--consent` when called by a proactive agent (must have explicit user approval before calling).
92
92
- `sol call journal facets [--all]` — List facets.
93
93
94
94
### Awareness