@pennixrv/trellis 0.7.2-beta.3 → 0.7.2-beta.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.
@@ -0,0 +1,9 @@
1
+ {
2
+ "version": "0.7.2-beta.4",
3
+ "description": "Bounded decision discovery and solution re-evaluation before convergence",
4
+ "breaking": false,
5
+ "recommendMigrate": false,
6
+ "changelog": "Challenge material defaults before decision handoff, reconsider affected choices after answers and evidence, and record completion evidence before requesting overall approval without adding fixed interview rounds.",
7
+ "migrations": [],
8
+ "notes": "Updates the two bundled phase workflow documents and diagrams. Use native trellis update to refresh project skills; no project file migration is required."
9
+ }
@@ -4,10 +4,12 @@
4
4
 
5
5
  需要构造时,梳理决策项及其权限、候选、重要排除项与理由;按需补齐证据、适用约束、标准、阈值、依赖、影响和优先级。证据足够时给出推荐;证据不足则保留未知或待决项,不伪造结论。仅当选择之间存在条件依赖时使用决策树,并标明分支条件、来源、未知路径及其下游影响。互斥、共享依赖或汇合关系可用依赖图;独立候选用比较表或清单即可。
6
6
 
7
- 候选尚未覆盖实质选择时,从不同机制、责任边界或运作方式拓宽,而非只列同一做法的参数变体;适用时纳入维持现状或不做。再以已确认约束、当前实现、外部先例及必要的有界探针筛选,区分不可行、代价较高与证据不足,保留排除理由及依赖后果。重要选择已可比较、未知已定位到受影响的决定时停止;不凑候选数量,不在没有新证据时追加轮次。目标变化回第一阶段,用户保留决定整理给第三阶段,不由辅助 Skill 提前锁定。
7
+ 候选尚未覆盖实质选择时,从不同机制、责任边界或运作方式拓宽,而非只列同一做法的参数变体;适用时纳入维持现状或不做。再以已确认约束、当前实现、外部先例及必要的有界探针筛选,区分不可行、代价较高与证据不足,保留排除理由及依赖后果。移交前还应完成下述重要默认与遗漏分支核对;不凑候选数量,不在没有新证据时追加轮次。目标变化回第一阶段,用户保留决定整理给第三阶段,不由辅助 Skill 提前锁定。
8
8
 
9
9
  新颖机制、重大重构、跨组件边界变化或关键取舍缺少可信本地先例时,进行有界的 `prior-art review`,记录适用性与采纳或排除理由。只读 Teamwork 可按需补充证据;主代理核验报告后归并。将 `DecisionSpace` 或有据跳过记录交由 Trellis CLI 接受,待用户决定交由解决方案设计与收敛阶段处理。
10
10
 
11
+ 移交前,从当前目标的实际使用、失败或交付场景挑战重要默认假设,检查候选之外是否仍有会改变行为、责任或验收的分支。可查事实由代理补证,真实用户取舍交第三阶段处理;尚未满足前置或暂不能精确表述的未知,说明影响哪个决定及后续处理,不能因当前无就绪问题就当作已解决。在现有产物简短保留关键发现、排除依据和未决项的移交方式;重要选择可比较且未知已有处置路径时停止,不穷举理论分支,也不把每个默认都变成用户问题。
12
+
11
13
  ```mermaid
12
14
  flowchart TD
13
15
  input["核对已确认且仍有效的需求基线"] --> material{"差异或条件分支会改变交付、验收、风险或下游选择?"}
@@ -26,8 +28,9 @@ flowchart TD
26
28
  merge --> representation{"候选关系需要条件分支吗?"}
27
29
  representation -->|"是"| tree["建立可追溯决策树并标明相关未知路径"]
28
30
  representation -->|"否"| simple["使用清单、比较表或适用的依赖图"]
29
- tree --> assess["核对证据、覆盖范围、关系与当前 revision"]
30
- simple --> assess
31
+ tree --> challenge["用当前任务场景挑战重要默认,检查遗漏分支与未知处置"]
32
+ simple --> challenge
33
+ challenge --> assess["核对证据、覆盖范围、关系与当前 revision"]
31
34
  assess -->|"目标或范围变化"| goal_exploration_and_requirements["回到目标探索与需求核对阶段,更新基线"]
32
35
  assess -->|"证据或候选仍有缺口"| items
33
36
  assess -->|"可供方案收敛"| output["Trellis CLI 接受 DecisionSpace"]
@@ -40,3 +43,4 @@ flowchart TD
40
43
  - 有实质决策空间时,候选、关键证据、关系、未知项和推荐均能支持下一阶段比较;不要求固定字段数量或同时使用多种图表。
41
44
  - 无实质差异时,跳过记录须能说明当前基线、判断依据和重新进入条件。
42
45
  - 保留用户决定不在本阶段锁定;外部参考不替代项目事实或用户选择。
46
+ - 已检查影响当前目标的重要默认和遗漏分支,关键未知有受影响决定及移交路径;没有就绪问题不单独构成退出依据。
@@ -4,6 +4,8 @@
4
4
 
5
5
  比较适用方案,说明选择依据、重要后果、行为边界、责任、必要依赖、验证方式、停止与恢复条件及实质风险。对新颖核心机制、重大重构、跨组件边界变化或关键不确定性缺少可信本地先例的方案,在结果接受前完成有界 `prior-art review`,记录适用性、采纳或排除理由,或说明没有适用先例。外部材料改变候选、标准或依赖时回到决策空间构造与归并阶段。
6
6
 
7
+ 用户答复、新证据、方案修订或复核发现后,重新筛选受影响的重要选择:是否出现新分支、前置是否满足、原决定是否仍有效。先保存真实答案及其影响,只重开受影响项;可查事实继续补证,用户取舍按依赖提问,不把问完原有列表或当前无就绪问题等同于方案完整。关键未知须有补证、用户决定、明确接受的剩余风险、延期或不继续等处置,不能静默排除。
8
+
7
9
  判断当前结果:分析交付形成 `analysis_conclusion`;不继续形成 `no_go`;延期形成带责任方、触发条件和恢复位置的 `deferred`,留在解决方案设计与收敛阶段;实施路线形成 `implementation_contract`,明确目标、范围和接受条件,并按路线需要补足实施与核验信息。只有交付物具有独立实施或集成边界时才拆分工作包,并说明推进和协作所需的依赖、顺序、责任或集成信息;单一交付不人为拆分工作包。解决方案设计与收敛阶段的结果接受与实施授权分开记录;只有合同及明确批准均有效时,Trellis CLI 才允许进入任务实施与测试验证阶段。
8
10
 
9
11
  合同结果已接受、实施尚未授权时,发现需要返修,应通过 `task.py phase return` 回到本阶段或更早受影响阶段,记录理由和证据。受影响的接受与授权随之失效;修订后重新接受当前产物,再核验实施授权。
@@ -14,22 +16,29 @@
14
16
 
15
17
  研究、原型和协作证据写回现有阶段产物、research 或 execution 自然落点,注明来源与版本、事实和假设、适用性、限制及决定影响。证据足够即停止扩搜;工具、报告或模板不能替代用户决定和 Trellis 原生接受事实。
16
18
 
19
+ 请求整体批准前,落实已有独立复核,在现有产物简短说明关键反例、发现及处置。以当前任务的具体行为或交付物检验端到端可执行性与验收依据;涉及发布安装时,核对本地验证、发布产物和实际运行身份的关系,不能只凭版本字符串认定同一产物。发现未决重要选择就回到筛选,不为没有新发现的情况追加轮次;充分的整体接受和实施授权不重复索取。
20
+
17
21
  ```mermaid
18
22
  flowchart TD
19
- input["核对需求基线与已接受的 DecisionSpace"] --> decisions{"存在尚待用户决定的实质取舍?"}
23
+ input["核对需求基线与已接受的 DecisionSpace"] --> rescreen["复用已定事项,重新筛选重要分支、前置与未知处置"]
24
+ rescreen --> decisions{"存在尚待用户决定的实质取舍?"}
20
25
  decisions -->|"是"| grill["pennix-decision-grill 同步询问;留在解决方案设计与收敛阶段"]
21
26
  grill --> impact{"答复影响哪个范围?"}
22
27
  impact -->|"目标或范围"| goal_exploration_and_requirements["回到目标探索与需求核对阶段"]
23
28
  impact -->|"候选、标准或依赖"| decision_space_construction_and_merging["回到决策空间构造与归并阶段"]
24
- impact -->|"当前候选中的选择"| compare["比较方案和重要后果"]
25
- decisions -->|"否"| compare
29
+ impact -->|"当前候选中的选择;保存答复后重算"| rescreen
30
+ decisions -->|"否;必要证据和未知已有处置"| compare["比较方案和重要后果"]
31
+ decisions -->|"前置或证据尚缺"| repair["补证或修订受影响方案"]
32
+ repair --> rescreen
26
33
  compare --> prior{"触发 prior-art review?"}
27
34
  prior -->|"是"| review["核验相关开源实现或公开提案并记录适用性"]
28
35
  review --> changed{"外部证据改变候选、标准或依赖?"}
29
36
  changed -->|"是"| decision_space_construction_and_merging
30
- changed -->|"否"| assess["核对完整性、风险、验证和恢复条件"]
37
+ changed -->|"否"| newDecisions{"新证据出现未决重要分支?"}
38
+ newDecisions -->|"是"| rescreen
39
+ newDecisions -->|"否"| assess["独立复核完整性、风险、验证、恢复与关键发现处置"]
31
40
  prior -->|"否"| assess
32
- assess -->|"有实质缺口"| compare
41
+ assess -->|"有实质缺口;补证或修订后重算"| repair
33
42
  assess -->|"analysis_conclusion 或 no_go"| reviewResult["Trellis CLI 接受解决方案设计与收敛阶段结果"]
34
43
  assess -->|"deferred"| defer["记录恢复条件并留在解决方案设计与收敛阶段"]
35
44
  assess -->|"implementation_contract"| contract["冻结必要实施合同"]
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@pennixrv/trellis",
3
- "version": "0.7.2-beta.3",
3
+ "version": "0.7.2-beta.4",
4
4
  "description": "AI capabilities grow like ivy — Trellis provides the structure to guide them along a disciplined path",
5
5
  "type": "module",
6
6
  "main": "./dist/index.js",
@@ -35,7 +35,7 @@
35
35
  "inquirer": "^9.3.7",
36
36
  "undici": "^6.21.0",
37
37
  "zod": "^4.4.2",
38
- "@pennixrv/trellis-core": "0.7.2-beta.3"
38
+ "@pennixrv/trellis-core": "0.7.2-beta.4"
39
39
  },
40
40
  "devDependencies": {
41
41
  "@eslint/js": "^9.18.0",