pi-ptc-subagents 6.0.3 → 6.2.0

package/dist/worker.js

@@ -1,6 +1,6 @@
 import { stripTypeScriptTypes } from "node:module";
-import { parentPort, workerData } from "node:worker_threads";
 import { inspect } from "node:util";
+import { parentPort, workerData } from "node:worker_threads";
 // ../ptc/src/compile.ts
 function compileProgram(source) {
 	const stripped = stripTypeScriptTypes(`async function __ptcProgram() {\n${source}\n}`, { mode: "strip" });
@@ -11,7 +11,7 @@ function createWorkflowHelpers(emit) {
 	return {
 		log: (...args) => emit(args.map((a) => typeof a === "string" ? a : JSON.stringify(a)).join(" ")),
 		phase: (name) => emit(`— phase: ${name} —`),
-		parallel: (items) => Promise.all(items.map((run) => run())),
+		parallel: (items) => Promise.allSettled(items.map((run) => run())),
 		pipeline: (items, step) => {
 			const results = [];
 			return items.reduce((chain, item, index) => chain.then(async () => {

package/docs/routes/create-a-task.md

@@ -5,7 +5,7 @@
 - `pi_task_ptc`：PTC 程序内的 binding，程序里 `tools.pi_task_ptc({...})`
 - `pi_task_codemode`：注册的工具（exposure: codemode，模型不可见），codemode 脚本里 `tools.pi_task_codemode({...})`
 
-参数：`task`（必填，孩子要干的活）、`label`、`wait`、`why`、`agent`、`agentScope`、`model`、`thinkingLevel`、`readOnly` 均已生效（`cwd` 待接）；
+参数：`task`（必填，孩子要干的活）、`label`、`wait`、`why`、`agent`、`agentScope`、`model`、`thinkingLevel`、`readOnly`；
 agent 定义里的 `tools / model / thinkingLevel / childReport` 由 frontmatter 钉住。
 
 返回 handle：`{ taskId, label?, status: "queued" }`。默认不等；撞闸（随闸门落地）返回
@@ -13,3 +13,14 @@ agent 定义里的 `tools / model / thinkingLevel / childReport` 由 frontmatter
 
 任务建成后在任务记录里排队（满员排队不拒绝，ADR-0010），经
 `ptc_task_list / ptc_task_output / ptc_task_stop` 查/停。
+
+## Briefing 纪律（省 token，派发前自查）
+
+- **给确切路径、命令、决策**：孩子看不到父会话。task 里写死一个路径，省孩子一轮探索
+  （每轮探索 = 一次工具调用结果 + 推理 token）。
+- **写明最终消息要带回什么**：孩子只回一次。要什么格式、哪些字段，task 里说清。
+- **不确定能否一次搜中才派**：目标明确（已知路径、已知行号）的活别派，主会话直接
+  `tools.read` 更省。
+- **同域的活合并给一个串行孩子**：每个孩子都付一份固定 harness 税（系统提示词 +
+  项目上下文）。多个重叠的小活拆并行 = 同一份探索被付费多次。
+- **孩子不写报告文件**：交付物就是最终消息（含报告 JSON 块），落盘 .md 是浪费。

package/docs/routes/run-a-phased-workflow.md

@@ -6,7 +6,7 @@ script 内额外可用（仅 workflow 面注入）：
 
 - `workflow.log(...)`：阶段内日志
 - `workflow.phase(name)`：阶段标记
-- `workflow.parallel([fn, ...])`：并行执行
+- `workflow.parallel([fn, ...])`：并行执行，返回 `Promise.allSettled` 记录（`{status:"fulfilled", value}` / `{status:"rejected", reason}`）——单边失败不丢兄弟结果（决策 12）；要「一错全拒」语义的自己写 `Promise.all`
 - `workflow.pipeline(items, step)`：顺序流水线
 
 args 必须是可 JSON 序列化的值（进 worker 前校验）。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-ptc-subagents",
-  "version": "6.0.3",
+  "version": "6.2.0",
   "description": "Programmable tool calling (PTC) and subagent fan-out for pi",
   "keywords": [
     "pi",
@@ -30,10 +30,12 @@
     ".": "./dist/index.js"
   },
   "scripts": {
-    "build": "pnpm -r run build",
+    "build": "pnpm -r --filter=!@pi-ptc/website run build",
     "prepack": "pnpm run build && rm -rf dist docs/routes && cp -R packages/entry/dist dist && cp -R packages/routes/docs/routes docs/routes",
-    "check": "pnpm -r run check",
+    "check": "pnpm -r --filter=!@pi-ptc/website run check",
     "lint": "oxlint",
+    "test": "node --test tests/*.test.mjs",
+    "pretest": "pnpm run build",
     "fmt": "oxfmt",
     "fmt:check": "oxfmt --check"
   },