threadnote 0.3.6 → 0.3.7
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +44 -3
- package/config/post-update-migrations.json +23 -0
- package/dist/mcp_server.cjs +252 -53
- package/dist/threadnote.cjs +985 -425
- package/docs/agent-instructions.md +23 -3
- package/package.json +1 -1
|
@@ -36,6 +36,16 @@ logs, or other sensitive data.
|
|
|
36
36
|
Also remember durable workflow facts you discover during work when they would help future agents and are not already in
|
|
37
37
|
canonical docs. Prefer updating checked-in docs for canonical repo rules.
|
|
38
38
|
|
|
39
|
+
Use lifecycle metadata when storing memories:
|
|
40
|
+
|
|
41
|
+
- `kind: durable` for facts future agents should use by default.
|
|
42
|
+
- `kind: handoff` for current work logs and next steps.
|
|
43
|
+
- `project` for the repo/product namespace.
|
|
44
|
+
- `topic` for the active issue or stable fact. Reusing the same project/topic keeps one current memory updated.
|
|
45
|
+
|
|
46
|
+
Archived handoffs are provenance, not default working context. Read them only when current durable memories or active
|
|
47
|
+
handoffs are insufficient.
|
|
48
|
+
|
|
39
49
|
## Memory Compaction
|
|
40
50
|
|
|
41
51
|
When working on the same active issue, prefer keeping one current-state memory updated instead of creating many small
|
|
@@ -43,6 +53,13 @@ progress memories. If an existing memory is clearly the current state for the is
|
|
|
43
53
|
`remember_context({"text":"...","replaceUri":"<uri>"})`, `threadnote remember --replace <uri>`, or
|
|
44
54
|
`threadnote handoff --replace <uri>` so the old memory is removed only after the replacement is stored.
|
|
45
55
|
|
|
56
|
+
When the issue has a stable name, prefer project/topic storage over timestamped memories:
|
|
57
|
+
|
|
58
|
+
```bash
|
|
59
|
+
threadnote remember --kind durable --project my-repo --topic test-workflow --text "..."
|
|
60
|
+
threadnote handoff --project my-repo --topic active-bug --task "..." --tests "..."
|
|
61
|
+
```
|
|
62
|
+
|
|
46
63
|
When recall/read surfaces several memories that describe the same durable fact, incident, branch, or handoff, compact
|
|
47
64
|
them when it is safe:
|
|
48
65
|
|
|
@@ -50,6 +67,8 @@ them when it is safe:
|
|
|
50
67
|
URIs you merged.
|
|
51
68
|
- Remove superseded duplicates with `threadnote forget <uri>` only when they are clearly redundant or stale and contain
|
|
52
69
|
no unique useful detail.
|
|
70
|
+
- Use `threadnote archive <uri>` instead of `forget` when the old handoff still has provenance value but should no
|
|
71
|
+
longer be treated as current context.
|
|
53
72
|
- If the memories disagree or you are not sure what can be deleted, keep them and mention the possible cleanup instead.
|
|
54
73
|
|
|
55
74
|
Never compact secrets, credentials, customer data, raw production logs, or checked-in canonical docs into memory.
|
|
@@ -76,8 +95,9 @@ threadnote start
|
|
|
76
95
|
threadnote recall --query "last handoff for this branch"
|
|
77
96
|
threadnote read viking://agent/threadnote/memories/.abstract.md
|
|
78
97
|
threadnote list viking://agent/threadnote/memories --all --recursive
|
|
79
|
-
threadnote remember --text "Durable engineering note..."
|
|
80
|
-
threadnote remember --replace viking://user/example/memories/
|
|
98
|
+
threadnote remember --kind durable --project example --topic workflow --text "Durable engineering note..."
|
|
99
|
+
threadnote remember --replace viking://user/example/memories/durable/projects/example/workflow.md --text "Updated durable engineering note..."
|
|
100
|
+
threadnote archive viking://user/example/memories/handoffs/active/example/old-issue.md
|
|
81
101
|
threadnote forget viking://user/example/memories/events/duplicate.md
|
|
82
|
-
threadnote handoff --task "short task summary" --tests "checks run" --next-step "what to do next"
|
|
102
|
+
threadnote handoff --project example --topic active-issue --task "short task summary" --tests "checks run" --next-step "what to do next"
|
|
83
103
|
```
|