@elinpf/dsh-ops-tool-trace 0.2.1 → 0.4.0

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.
Files changed (6) hide show
  1. package/README.md +1 -0
  2. package/lib/doctrine.d.ts +2 -0
  3. package/lib/doctrine.d.ts.map +1 -1
  4. package/lib/doctrine.js +5 -0
  5. package/lib/doctrine.js.map +1 -1
  6. package/package.json +3 -3
package/README.md CHANGED
@@ -13,6 +13,7 @@ The agent maintains the tree through the `trace` model tool. Every call appends
13
13
  - **`link`** records causal edges (`caused_by`) without changing status — proof is `complete` with a summary, not a link
14
14
  - **`resolve(goal)` is hard-gated**: every non-root node must be decided (`done`/`dead_end`) first. `force: true` is the escape hatch for ABANDONING an investigation mid-way — the result's WARN names every node it shelved and marks the closure an unverified assertion
15
15
  - **`view`** renders the full tree (default) or an indented outline (`format: tree`); **`help`** progressively discloses the full doctrine
16
+ - **Knowledge precipitation** — after `resolve(goal)` closes an investigation, the doctrine (help text) points at `@elinpf/dsh-ops-knowledge`: when the root cause and fix are reusable, search for a near-duplicate case first, then `knowledge_record` the distilled conclusion (or update the old case by id)
16
17
 
17
18
  ## The one structural rule
18
19
 
package/lib/doctrine.d.ts CHANGED
@@ -39,6 +39,8 @@ export declare function resolveGateError(undecided: Array<{
39
39
  }>): string;
40
40
  /** Where the full documentation lives. */
41
41
  export declare const HELP_POINTER = "\u5B8C\u6574\u7528\u6CD5\u4E0E\u7EAA\u5F8B: \u8C03 `trace` action=help\u3002";
42
+ /** Post-resolve knowledge precipitation, quoted by HELP_TEXT. */
43
+ export declare const KNOWLEDGE_PRECIPITATION = "\u5168\u6848\u6536\u53E3\u540E, \u82E5\u6839\u56E0+\u4FEE\u590D\u6709\u53EF\u590D\u7528\u4EF7\u503C\u4E14 knowledge \u5DE5\u5177\u53EF\u7528: \u5148 knowledge_search \u67E5\u91CD, \u518D knowledge_record \u6C89\u6DC0(\u6709\u8FD1\u4F3C\u65E7\u75C5\u4F8B\u5219\u5E26 id \u66F4\u65B0)";
42
44
  /**
43
45
  * Soft hint for add_step: the parent is a milestone that already has
44
46
  * completed steps with findings, so the new step may belong under one of
package/lib/doctrine.d.ts.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"doctrine.d.ts","sourceRoot":"","sources":["../src/doctrine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAIH,qCAAqC;AACrC,eAAO,MAAM,cAAc,8JACyB,CAAA;AAEpD;wBACwB;AACxB,eAAO,MAAM,qBAAqB,8EAAkB,CAAA;AAEpD,8EAA8E;AAC9E,eAAO,MAAM,oBAAoB,sLAC+B,CAAA;AAEhE;8BAC8B;AAC9B,eAAO,MAAM,iBAAiB,sTACyC,CAAA;AAEvE,4EAA4E;AAC5E,eAAO,MAAM,eAAe,+DAAqB,CAAA;AAEjD;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,KAAK,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,GAAG,MAAM,CAGzF;AAED,0CAA0C;AAC1C,eAAO,MAAM,YAAY,iFAAoC,CAAA;AAE7D;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,MAAM,CAEnE;AAID,mDAAmD;AACnD,eAAO,MAAM,gBAAgB,+aACiD,CAAA;AAE9E;;;;;GAKG;AACH,eAAO,MAAM,aAAa,QAKd,CAAA;AAEZ;;;;GAIG;AACH,eAAO,MAAM,SAAS,QAyCV,CAAA"}
1
+ {"version":3,"file":"doctrine.d.ts","sourceRoot":"","sources":["../src/doctrine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAIH,qCAAqC;AACrC,eAAO,MAAM,cAAc,8JACyB,CAAA;AAEpD;wBACwB;AACxB,eAAO,MAAM,qBAAqB,8EAAkB,CAAA;AAEpD,8EAA8E;AAC9E,eAAO,MAAM,oBAAoB,sLAC+B,CAAA;AAEhE;8BAC8B;AAC9B,eAAO,MAAM,iBAAiB,sTACyC,CAAA;AAEvE,4EAA4E;AAC5E,eAAO,MAAM,eAAe,+DAAqB,CAAA;AAEjD;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,KAAK,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,GAAG,MAAM,CAGzF;AAED,0CAA0C;AAC1C,eAAO,MAAM,YAAY,iFAAoC,CAAA;AAE7D,iEAAiE;AACjE,eAAO,MAAM,uBAAuB,+RACiE,CAAA;AAErG;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,MAAM,CAEnE;AAID,mDAAmD;AACnD,eAAO,MAAM,gBAAgB,+aACiD,CAAA;AAE9E;;;;;GAKG;AACH,eAAO,MAAM,aAAa,QAKd,CAAA;AAEZ;;;;GAIG;AACH,eAAO,MAAM,SAAS,QA4CV,CAAA"}
package/lib/doctrine.js CHANGED
@@ -40,6 +40,8 @@ export function resolveGateError(undecided) {
40
40
  }
41
41
  /** Where the full documentation lives. */
42
42
  export const HELP_POINTER = '完整用法与纪律: 调 `trace` action=help。';
43
+ /** Post-resolve knowledge precipitation, quoted by HELP_TEXT. */
44
+ export const KNOWLEDGE_PRECIPITATION = '全案收口后, 若根因+修复有可复用价值且 knowledge 工具可用: 先 knowledge_search 查重, 再 knowledge_record 沉淀(有近似旧病例则带 id 更新)';
43
45
  /**
44
46
  * Soft hint for add_step: the parent is a milestone that already has
45
47
  * completed steps with findings, so the new step may belong under one of
@@ -107,6 +109,9 @@ export const HELP_TEXT = [
107
109
  '- 没有(已到物理/基础设施层事实: 磁盘满、内存耗尽、网络分区…) → 这一步收敛',
108
110
  '没有新报错指引方向时, 回到最近一个还悬着 "为什么" 的节点继续。',
109
111
  '',
112
+ '### 收口后的知识沉淀',
113
+ `${KNOWLEDGE_PRECIPITATION}。`,
114
+ '',
110
115
  '### 其他',
111
116
  '- 死路 abandon, 保留在树上; 迷失方向先 view; 每 5 步排查至少更新 1 次 trace。',
112
117
  '- link 只表达 parent 无法表达的因果边(跨分支); 父子关系已隐含触发链, 不重复 link。',
package/lib/doctrine.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"doctrine.js","sourceRoot":"","sources":["../src/doctrine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,gFAAgF;AAEhF,qCAAqC;AACrC,MAAM,CAAC,MAAM,cAAc,GACzB,kDAAkD,CAAA;AAEpD;wBACwB;AACxB,MAAM,CAAC,MAAM,qBAAqB,GAAG,eAAe,CAAA;AAEpD,8EAA8E;AAC9E,MAAM,CAAC,MAAM,oBAAoB,GAC/B,8DAA8D,CAAA;AAEhE;8BAC8B;AAC9B,MAAM,CAAC,MAAM,iBAAiB,GAC5B,qBAAqB,qBAAqB,IAAI,oBAAoB,GAAG,CAAA;AAEvE,4EAA4E;AAC5E,MAAM,CAAC,MAAM,eAAe,GAAG,kBAAkB,CAAA;AAEjD;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,SAAgD;IAC/E,MAAM,IAAI,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACrE,OAAO,aAAa,SAAS,CAAC,MAAM,6BAA6B,IAAI,6FAA6F,CAAA;AACpK,CAAC;AAED,0CAA0C;AAC1C,MAAM,CAAC,MAAM,YAAY,GAAG,iCAAiC,CAAA;AAE7D;;;;;;GAMG;AACH,MAAM,UAAU,qBAAqB,CAAC,WAAqB;IACzD,OAAO,gCAAgC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,oFAAoF,CAAA;AACnJ,CAAC;AAED,gFAAgF;AAEhF,mDAAmD;AACnD,MAAM,CAAC,MAAM,gBAAgB,GAC3B,GAAG,cAAc,6CAA6C,YAAY,EAAE,CAAA;AAE9E;;;;;GAKG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,gBAAgB;IAChB,wDAAwD,eAAe,iBAAiB;IACxF,iBAAiB;IACjB,YAAY;CACb,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AAEZ;;;;GAIG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,oBAAoB;IACpB,EAAE;IACF,gCAAgC;IAChC,EAAE;IACF,aAAa;IACb,gDAAgD;IAChD,4EAA4E;IAC5E,kEAAkE;IAClE,8EAA8E;IAC9E,wJAAwJ;IACxJ,4CAA4C;IAC5C,4DAA4D;IAC5D,EAAE;IACF,4BAA4B;IAC5B,iCAAiC,qBAAqB,GAAG;IACzD,iDAAiD;IACjD,sCAAsC;IACtC,kCAAkC;IAClC,8BAA8B;IAC9B,EAAE;IACF,aAAa;IACb,+EAA+E;IAC/E,EAAE;IACF,2BAA2B;IAC3B,YAAY,eAAe,YAAY;IACvC,0DAA0D;IAC1D,sCAAsC;IACtC,qEAAqE;IACrE,yCAAyC;IACzC,EAAE;IACF,WAAW;IACX,8CAA8C;IAC9C,wCAAwC;IACxC,4CAA4C;IAC5C,oCAAoC;IACpC,EAAE;IACF,QAAQ;IACR,yDAAyD;IACzD,wDAAwD;IACxD,oKAAoK;CACrK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA"}
1
+ {"version":3,"file":"doctrine.js","sourceRoot":"","sources":["../src/doctrine.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,gFAAgF;AAEhF,qCAAqC;AACrC,MAAM,CAAC,MAAM,cAAc,GACzB,kDAAkD,CAAA;AAEpD;wBACwB;AACxB,MAAM,CAAC,MAAM,qBAAqB,GAAG,eAAe,CAAA;AAEpD,8EAA8E;AAC9E,MAAM,CAAC,MAAM,oBAAoB,GAC/B,8DAA8D,CAAA;AAEhE;8BAC8B;AAC9B,MAAM,CAAC,MAAM,iBAAiB,GAC5B,qBAAqB,qBAAqB,IAAI,oBAAoB,GAAG,CAAA;AAEvE,4EAA4E;AAC5E,MAAM,CAAC,MAAM,eAAe,GAAG,kBAAkB,CAAA;AAEjD;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,SAAgD;IAC/E,MAAM,IAAI,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACrE,OAAO,aAAa,SAAS,CAAC,MAAM,6BAA6B,IAAI,6FAA6F,CAAA;AACpK,CAAC;AAED,0CAA0C;AAC1C,MAAM,CAAC,MAAM,YAAY,GAAG,iCAAiC,CAAA;AAE7D,iEAAiE;AACjE,MAAM,CAAC,MAAM,uBAAuB,GAClC,mGAAmG,CAAA;AAErG;;;;;;GAMG;AACH,MAAM,UAAU,qBAAqB,CAAC,WAAqB;IACzD,OAAO,gCAAgC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,oFAAoF,CAAA;AACnJ,CAAC;AAED,gFAAgF;AAEhF,mDAAmD;AACnD,MAAM,CAAC,MAAM,gBAAgB,GAC3B,GAAG,cAAc,6CAA6C,YAAY,EAAE,CAAA;AAE9E;;;;;GAKG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,gBAAgB;IAChB,wDAAwD,eAAe,iBAAiB;IACxF,iBAAiB;IACjB,YAAY;CACb,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AAEZ;;;;GAIG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,oBAAoB;IACpB,EAAE;IACF,gCAAgC;IAChC,EAAE;IACF,aAAa;IACb,gDAAgD;IAChD,4EAA4E;IAC5E,kEAAkE;IAClE,8EAA8E;IAC9E,wJAAwJ;IACxJ,4CAA4C;IAC5C,4DAA4D;IAC5D,EAAE;IACF,4BAA4B;IAC5B,iCAAiC,qBAAqB,GAAG;IACzD,iDAAiD;IACjD,sCAAsC;IACtC,kCAAkC;IAClC,8BAA8B;IAC9B,EAAE;IACF,aAAa;IACb,+EAA+E;IAC/E,EAAE;IACF,2BAA2B;IAC3B,YAAY,eAAe,YAAY;IACvC,0DAA0D;IAC1D,sCAAsC;IACtC,qEAAqE;IACrE,yCAAyC;IACzC,EAAE;IACF,WAAW;IACX,8CAA8C;IAC9C,wCAAwC;IACxC,4CAA4C;IAC5C,oCAAoC;IACpC,EAAE;IACF,cAAc;IACd,GAAG,uBAAuB,GAAG;IAC7B,EAAE;IACF,QAAQ;IACR,yDAAyD;IACzD,wDAAwD;IACxD,oKAAoK;CACrK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@elinpf/dsh-ops-tool-trace",
3
- "version": "0.2.1",
3
+ "version": "0.4.0",
4
4
  "description": "Investigation tree tool for ops mode — replaces todo_write with a diverge-converge tree of steps, milestones, dead ends, and a resolved terminal.",
5
5
  "type": "module",
6
6
  "main": "lib/index.js",
@@ -41,7 +41,7 @@
41
41
  "@deepseek-ai/cordis": "^4.0.1",
42
42
  "@deepseek-ai/dsh-invariants": "^0.1.0-rc.8",
43
43
  "@deepseek-ai/dsh-llm": "^0.1.0-rc.8",
44
- "@elinpf/dsh-ops-prompts": "^0.2.1",
44
+ "@elinpf/dsh-ops-prompts": "^0.4.0",
45
45
  "@deepseek-ai/dsh-session": "^0.1.0-rc.8",
46
46
  "@deepseek-ai/dsh-session-projection": "^0.1.0-rc.8 || ^0.1.1-rc.1",
47
47
  "@deepseek-ai/dsh-system-prompt": "^0.1.0-rc.8",
@@ -60,7 +60,7 @@
60
60
  "@deepseek-ai/dsh-tools": "0.0.1-rc.1",
61
61
  "typescript": "^5.4.0",
62
62
  "vitest": "^4.1.11",
63
- "@elinpf/dsh-ops-prompts": "0.2.1"
63
+ "@elinpf/dsh-ops-prompts": "0.4.0"
64
64
  },
65
65
  "license": "MIT",
66
66
  "publishConfig": {