dominds 1.27.3 → 1.27.4

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.
@@ -15,7 +15,7 @@
15
15
 
16
16
  ### Scenario Description
17
17
 
18
- Use reminders for the current task's current work: next steps, blockers, and volatile details that are not meant to become the team's Taskdoc bulletin board.
18
+ Use reminders for the current task's current work: next steps, blockers, and volatile details that are not meant to become the team's Taskdoc bulletin board. A continuation package prepared before `clear_mind` is resume state for the current dialog, so it must explicitly use `scope=dialog` and state this dialog task goal.
19
19
 
20
20
  ### Example
21
21
 
@@ -31,6 +31,13 @@ add_reminder({
31
31
  scope: 'dialog',
32
32
  });
33
33
 
34
+ // clear_mind continuation packages must explicitly use dialog and state this dialog task goal
35
+ add_reminder({
36
+ content:
37
+ 'Continuation goal: keep reviewing control-manual course-transition guidance; next check whether scenarios/index still imply task scope for continuation packages',
38
+ scope: 'dialog',
39
+ });
40
+
34
41
  // Use agent only for urgent, short-lived, globally visible cues
35
42
  add_reminder({
36
43
  content: 'Urgent: confirm human authorization before deleting any external resource',
@@ -51,8 +58,8 @@ delete_reminder({
51
58
 
52
59
  ### Key Points
53
60
 
54
- - Default to `task` for next steps, temporary blockers, and volatile bridge details under the same Taskdoc
55
- - Use `dialog` only for notes that are truly local to the current dialog
61
+ - Default to `task` for ordinary next steps, temporary blockers, and current-work details under the same Taskdoc
62
+ - Use `dialog` only for notes that are truly local to the current dialog; continuation packages before `clear_mind` must explicitly use `scope=dialog` and state this dialog task goal
56
63
  - Use `agent` only for urgent, short-lived, globally visible cues
57
64
  - If the information should synchronize the whole team's current effective state, put it in Taskdoc `progress` instead
58
65
  - If the note is durable knowledge rather than an active current-work cue, move it to `personal_memory` instead
@@ -45,7 +45,7 @@ Add reminder.
45
45
  Use when:
46
46
 
47
47
  - Adding a new temporary current-work item
48
- - Before `clear_mind`, the Main Dialog first records undocumented discussion details the next course needs to know into Taskdoc, then creates continuation-package notes; a Side Dialog directly maintains sufficiently detailed continuation-package reminders. When Dominds has already warned that context is tight or critical, Side Dialog reminders have no fixed length limit and rough bridge notes are acceptable
48
+ - Before `clear_mind`, first state this dialog task goal in a current-dialog scoped (`scope=dialog`) continuation-package reminder. A Main Dialog records only discussion facts that other dialogs/teammates sharing the same Taskdoc truly need to know into Taskdoc, then keeps resume-critical details for this dialog in `dialog` reminders; a Side Dialog directly maintains sufficiently detailed `dialog` continuation-package reminders. When Dominds has already warned that context is tight or critical, Side Dialog reminders have no fixed length limit and rough bridge notes are acceptable
49
49
  - Record only manually maintained current-work / continuation details; do not put environment state automatically maintained by Dominds, such as background process status, in-flight background asks, or session attachment state, into manual reminders
50
50
 
51
51
  **Parameters:**
@@ -382,8 +382,8 @@ message: <error message>
382
382
  ## Reminder Content Guidance
383
383
 
384
384
  - Normal reminders should stay concise, fresh, and directly actionable; often 1-3 items total
385
- - For a continuation package, use structured notes by default: next step, key pointers, run/verify, easy-to-lose volatile details
386
- - If Dominds has already warned that context is tight or critical: the Main Dialog first records undocumented discussion details the next course needs to know into the appropriate Taskdoc sections, then keeps necessary continuation-package reminders; a Side Dialog must not maintain Taskdoc or draft Taskdoc update proposals, and should directly maintain sufficiently detailed continuation-package reminders with no fixed length limit. Rough multi-reminder bridge notes are acceptable and should be reconciled as the first step only after Dominds actually starts the new course
387
- - Keep only details still not covered by Taskdoc; do not repeat team-shared status. If the team needs “where we are now / which decisions are in effect / what is next / which blockers still hold”, write it back to Taskdoc `progress`
385
+ - For a continuation package, explicitly use `scope=dialog` and structure notes by default: current dialog task goal, next step, key pointers, run/verify, easy-to-lose volatile details
386
+ - If Dominds has already warned that context is tight or critical: the Main Dialog first states this dialog goal in a `dialog` continuation-package reminder, then records only facts that other dialogs/teammates sharing the same Taskdoc truly need into the appropriate Taskdoc sections, and finally keeps necessary resume-critical details for this dialog in continuation-package reminders; a Side Dialog must not maintain Taskdoc or draft Taskdoc update proposals, and should directly maintain sufficiently detailed `dialog` continuation-package reminders with no fixed length limit. Rough multi-reminder bridge notes are acceptable; once the new course starts, continue this dialog from the task goal in `scope=dialog` reminders before reconciling
387
+ - Keep only details still not covered by Taskdoc but easy to lose when resuming this dialog; do not repeat team-shared status. If the team needs “where we are now / which decisions are in effect / what is next / which blockers still hold”, write it back to Taskdoc `progress`
388
388
  - Do not manually record environment state automatically maintained by Dominds, such as whether background processes are still running, in-flight background asks/collaboration, or browser/session attachment state. Manual copies go stale easily and conflict with the Dominds-managed status, creating cognitive noise
389
389
  - Do not paste long logs, large tool outputs, or raw material into reminders
@@ -26,7 +26,7 @@
26
26
 
27
27
  control 是 Dominds 的**对话控制工具集**,用于管理对话状态、提醒、差遣牒,以及跨对话回复收口语义:
28
28
 
29
- - **提醒管理**:提醒分 `dialog` / `task` / `agent` 三个 scope;默认是 `task`,用于同一差遣牒任务下的手头工作;`dialog` 只用于真正对话局部的提醒;`agent` 只用于紧急、短期、全局刺眼提醒
29
+ - **提醒管理**:提醒分 `dialog` / `task` / `agent` 三个 scope;默认是 `task`,用于同一差遣牒任务下的普通手头工作;`dialog` 用于真正对话局部的提醒,准备 `clear_mind` 的接续包必须显式 `scope=dialog` 并写明本路对话任务目标;`agent` 只用于紧急、短期、全局刺眼提醒
30
30
  - **差遣牒操作**:追加、替换或删除任务契约章节(goals/constraints/progress);其中 `progress` 是全队共享、准实时、可扫读的任务公告牌
31
31
  - **上下文维护**:在不丢关键恢复线索的前提下降低认知负载
32
32
  - **回复路由**:在支线/回问语境下,区分回问诉请者、发送最终回贴与普通文本的职责边界
@@ -56,13 +56,13 @@ control 是 Dominds 的**对话控制工具集**,用于管理对话状态、
56
56
  - 标记待处理事项
57
57
  - 追踪当前下一步/阻塞
58
58
  - 记录阻塞问题
59
- - 在 `clear_mind` 前承载接续包;若 Dominds 已提醒当前程吃紧/告急,可先带多条粗略提醒项过桥
59
+ - 在 `clear_mind` 前承载当前对话范围的接续包;若 Dominds 已提醒当前程吃紧/告急,可先带多条粗略提醒项过桥
60
60
 
61
61
  提醒不用于手工复制 Dominds 会自动维护的系统状态,例如后台进程状态、后台进行中诉请/协作、浏览器/会话附件状态等。这些状态以 Dominds 自动维护的提醒、面板和工具输出为准;手工记录很容易过时并造成认知干扰。
62
62
 
63
63
  scope 规则:
64
64
 
65
- - `dialog`:当前对话手头工作
65
+ - `dialog`:当前对话手头工作;准备 `clear_mind` 的接续包必须显式使用这个范围,并写明本路对话任务目标
66
66
  - `task`:当前差遣牒任务下的手头工作,默认范围
67
67
  - `agent`:在由你主理的后续对话里也应继续看到的紧急、短期、全局刺眼提醒
68
68
 
@@ -42,7 +42,7 @@
42
42
  - `agent` 提醒会在由你主理的后续对话里继续可见
43
43
  - 可随时添加、修改、删除
44
44
  - 默认应保持少量、可扫读、可直接指导下一步
45
- - 准备 `clear_mind` 时,主线对话先把应由下一程知会的未落文档讨论细节补进差遣牒,再压缩成结构化接续包提醒项;支线对话直接维护足够详尽的接续包提醒项。若 Dominds 已提醒上下文吃紧/告急,支线提醒项没有固定长度限制,也可先保留多条粗略提醒项过桥
45
+ - 准备 `clear_mind` 时,必须先用当前对话范围(`scope=dialog`)接续包提醒项写明本路对话任务目标;主线对话只把确需同一差遣牒其它对话/队友知会的讨论事实补进差遣牒,再把恢复本路对话容易丢的信息留在 `dialog` 提醒项;支线对话直接维护足够详尽的 `dialog` 接续包提醒项。若 Dominds 已提醒上下文吃紧/告急,支线提醒项没有固定长度限制,也可先保留多条粗略提醒项过桥
46
46
 
47
47
  **与 memory 的区别:**
48
48
  | 特性 | dialog reminder | task reminder | agent reminder | personal memory |
@@ -123,7 +123,7 @@
123
123
 
124
124
  - **当前手头工作**:当前下一步、阻塞、关键定位信息
125
125
  - **易丢细节**:临时路径、id、命令、样例输入
126
- - **换程接续**:在 `clear_mind` 前整理接续包;若 Dominds 已提醒当前程吃紧/告急,可先保留多条粗略提醒项
126
+ - **换程接续**:在 `clear_mind` 前整理当前对话范围(`scope=dialog`)接续包,必须写明本路对话任务目标;若 Dominds 已提醒当前程吃紧/告急,可先保留多条粗略提醒项
127
127
  - **任务延续提示**:如果在当前差遣牒任务内都应该继续看到它,用 `task`
128
128
  - **全局刺眼提示**:如果它应该在由你主理的后续对话里继续看到,而且是短期、紧急、全局刺眼提醒,用 `agent`
129
129
 
@@ -140,7 +140,7 @@
140
140
  - 避免重复系统状态:后台进程状态、后台进行中诉请/协作、浏览器/会话附件状态等 Dominds 会自动维护的信息,不要写进手工提醒项;这些状态以 Dominds 自动维护的提醒、面板和工具输出为准,手工副本容易过时并造成认知干扰
141
141
  - 面向全队:`progress` 应保持可扫读、以“当前仍有效”为准,不要退化成个人日志、流水账、临时便签或历史残影堆积;少量新增用 `mind_more`,需要清旧/重排/压缩时先调用 `recall_taskdoc`,再用 `change_mind` 并携带返回的 `content_hash` 作为 `previous_content_hash`
142
142
  - 按需整理:`mind_more` 不是默认记账动作。若同一主题已有多条阶段性记录,优先用 `change_mind` 合并成当前摘要;把细节放进 rtws 正式文档,并在差遣牒里保留文档定位 pointer。若会冲掉原有内容,必须有直接人类确认,或已按人类认可 SOP/验收标准充分考虑原有内容后再改写
143
- - 换程前收束:主线对话先把尚未落实到文档、且下一程需要知会的讨论细节写入差遣牒合适章节,再整理结构化接续包提醒项;支线对话不要维护差遣牒,也不要整理差遣牒更新提案,直接维护足够详尽的接续包提醒项。若 Dominds 已提醒上下文吃紧/告急,则先保留多条粗略提醒项过桥也可以;当前程只做落文档/保信息 + `clear_mind`(支线只做保信息 + `clear_mind`),Dominds 真正开启新一程后第一步再收敛
143
+ - 换程前收束:主线对话先用 `scope=dialog` 接续包提醒项写明本路对话任务目标,再把确需同一差遣牒其它对话/队友知会的讨论事实写入差遣牒合适章节,最后把恢复本路对话容易丢的信息留在 `dialog` 提醒项;支线对话不要维护差遣牒,也不要整理差遣牒更新提案,直接维护足够详尽的 `dialog` 接续包提醒项。若 Dominds 已提醒上下文吃紧/告急,则先保留多条粗略提醒项过桥也可以;当前程只做保信息 + `clear_mind`,Dominds 真正开启新一程后第一步按 `scope=dialog` 提醒项里的任务目标继续本路对话,再收敛
144
144
  - 拒绝原料堆积:不要把长日志/大段 tool output 直接塞进提醒项
145
145
  - 文档分层:差遣牒写“现在应如何同步/推进”,正式文档写“为什么、怎么做、详细证据和完整过程”。差遣牒需要引用正式文档时,写稳定路径/章节名/相关命令,而不是复制整段内容
146
146
 
@@ -164,5 +164,5 @@
164
164
  1. `dialog` 提醒会随对话结束而结束;`task` 提醒会在当前差遣牒任务内继续可见;`agent` 提醒会在由你主理的后续对话里继续可见
165
165
  2. 缺失差遣牒章节用 `do_mind` 创建;差遣牒少量新增可用 `mind_more` 追加;已有章节整段替换用 `change_mind`,请确保合并已有内容,并先调用 `recall_taskdoc` 取得当前 `content_hash` 作为 `previous_content_hash`;确需删除整章文件时用 `never_mind`。不要把 `mind_more` 当流水账工具;需要整理、去旧、合并同主题记录时先 `recall_taskdoc` 再 `change_mind`
166
166
  3. `do_mind` / `mind_more` / `change_mind` / `never_mind` 不开启新 course
167
- 4. 接续包提醒项只保留差遣牒仍未覆盖、但恢复工作容易丢的细节;主线对话应先把当前对话历史中应由下一程知会的未落文档讨论细节写入差遣牒合适章节;支线对话在吃紧/告急时只维护足够详尽的接续包提醒项
167
+ 4. 接续包提醒项必须是当前对话范围(`scope=dialog`)并写明本路任务目标;主线对话只把确需同一差遣牒其它对话/队友知会的事实写入差遣牒,提醒项保留差遣牒仍未覆盖、但恢复本路对话容易丢的细节;支线对话在吃紧/告急时只维护足够详尽的 `dialog` 接续包提醒项
168
168
  5. 不要把 `task` / `agent` 提醒堆成长期事实仓库;耐久知识应迁到 `personal_memory`
@@ -15,7 +15,7 @@
15
15
 
16
16
  ### 场景描述
17
17
 
18
- 使用 reminders 承接当前任务的手头工作:下一步、临时阻塞、易丢的 bridge 细节,而不是把它写成面向全队同步的 Taskdoc 公告牌。
18
+ 使用 reminders 承接当前任务的手头工作:下一步、临时阻塞、易丢细节,而不是把它写成面向全队同步的 Taskdoc 公告牌。准备 `clear_mind` 的接续包是当前对话恢复线索,必须显式 `scope=dialog` 并写明本路对话任务目标。
19
19
 
20
20
  ### 示例
21
21
 
@@ -31,6 +31,13 @@ add_reminder({
31
31
  scope: 'dialog',
32
32
  });
33
33
 
34
+ // clear_mind 接续包必须显式 dialog,并写明当前这一路对话的任务目标
35
+ add_reminder({
36
+ content:
37
+ '接续目标:继续复核 control 手册换程引导;下一步先检查 scenarios/index 是否还把接续包暗示成 task',
38
+ scope: 'dialog',
39
+ });
40
+
34
41
  // 只有紧急、短期、全局刺眼提醒,才写成 agent
35
42
  add_reminder({
36
43
  content: '紧急:在删除任何外部资源前必须先向用户确认授权',
@@ -51,8 +58,8 @@ delete_reminder({
51
58
 
52
59
  ### 关键点
53
60
 
54
- - 同一差遣牒任务内的下一步、临时阻塞、bridge 细节默认都用 `task`
55
- - 真正只对当前对话有效的提醒才用 `dialog`
61
+ - 同一差遣牒任务内的普通下一步、临时阻塞、手头细节默认用 `task`
62
+ - 真正只对当前对话有效的提醒才用 `dialog`;准备 `clear_mind` 的接续包必须显式 `scope=dialog`,并写明本路对话任务目标
56
63
  - 只有紧急、短期、全局刺眼提醒才用 `agent`
57
64
  - 如果信息需要向全队同步当前有效状态、关键决策、下一步或仍成立阻塞,应写入 Taskdoc `progress`
58
65
  - 如果内容本质上是长期知识而不是当前手头工作提示,应改存到 `personal_memory`
@@ -45,7 +45,7 @@
45
45
  **适用:**
46
46
 
47
47
  - 添加新的临时手头工作条目
48
- - 若准备 `clear_mind`,主线对话先把应由下一程知会的未落文档讨论细节补进差遣牒,再新建接续包提醒项;支线对话直接维护足够详尽的接续包提醒项。若 Dominds 已提醒上下文吃紧/告急,支线提醒项没有固定长度限制,先记粗略过桥信息也可以
48
+ - 若准备 `clear_mind`,必须用 `scope=dialog` 接续包提醒项写明本路对话任务目标;主线对话只把确需同一差遣牒其它对话/队友知会的讨论事实补进差遣牒,再保留恢复本路对话容易丢的信息;支线对话直接维护足够详尽的 `dialog` 接续包提醒项。若 Dominds 已提醒上下文吃紧/告急,支线提醒项没有固定长度限制,先记粗略过桥信息也可以
49
49
  - 只记录需要你手工维护的手头工作/接续细节;不要在手工提醒项里记录后台进程状态、后台进行中诉请、会话附件状态等 Dominds 会自动维护的信息
50
50
 
51
51
  **参数:**
@@ -375,8 +375,8 @@ message: <错误消息>
375
375
  ## 提醒项内容建议
376
376
 
377
377
  - 默认提醒项应保持短、新、能直接指导下一步,常见 1–3 条
378
- - 若用于接续包,默认优先结构化内容:下一步行动、关键定位、运行/验证、容易丢的临时细节
379
- - 若 Dominds 已提醒上下文吃紧/告急:主线对话先把尚未落实到文档、且下一程需要知会的讨论细节写入差遣牒合适章节,再保留必要的接续包提醒项;支线对话不要维护差遣牒,也不要整理差遣牒更新提案,直接维护足够详尽的接续包提醒项,没有固定长度限制;多条粗略提醒项也可以,Dominds 真正开启新一程后第一步再收敛整理
380
- - 接续包只保留差遣牒仍未覆盖的细节;不要重复团队共享状态。要向全队同步“现在到哪了 / 哪些决策已生效 / 下一步是什么 / 哪些阻塞仍成立”,请写回 Taskdoc `progress`
378
+ - 若用于接续包,必须显式 `scope=dialog`,并默认优先结构化内容:当前对话任务目标、下一步行动、关键定位、运行/验证、容易丢的临时细节
379
+ - 若 Dominds 已提醒上下文吃紧/告急:主线对话先用 `dialog` 接续包提醒项写明本路目标,再把确需同一差遣牒其它对话/队友知会的讨论事实写入差遣牒合适章节,最后保留恢复本路对话必要的接续包提醒项;支线对话不要维护差遣牒,也不要整理差遣牒更新提案,直接维护足够详尽的 `dialog` 接续包提醒项,没有固定长度限制;多条粗略提醒项也可以,Dominds 真正开启新一程后第一步按 `scope=dialog` 提醒项里的任务目标继续本路对话,再收敛整理
380
+ - 接续包只保留差遣牒仍未覆盖、但恢复本路对话容易丢的细节;不要重复团队共享状态。要向全队同步“现在到哪了 / 哪些决策已生效 / 下一步是什么 / 哪些阻塞仍成立”,请写回 Taskdoc `progress`
381
381
  - 不要手工记录 Dominds 会自动维护的系统状态,例如后台进程是否仍在运行、后台进行中的诉请/协作、浏览器/会话附件状态等;手工记录很容易过时,并与 Dominds 自动维护的状态冲突,造成认知干扰
382
382
  - 不要把长日志、大段 tool output、原始材料直接塞进提醒项
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "dominds",
3
- "version": "1.27.3",
3
+ "version": "1.27.4",
4
4
  "description": "Dominds CLI and aggregation shell for the LongRun AI kernel/runtime packages.",
5
5
  "type": "commonjs",
6
6
  "publishConfig": {