pi-ultracode 0.7.0 → 0.8.0

package/README.md

@@ -29,7 +29,7 @@ pi --ultracode
 
 > `pi-ultracode` registers a tool named `workflow`. If `pi-dynamic-workflows` is installed, remove it first with `pi remove npm:pi-dynamic-workflows`.
 
-Current releases are tested with Pi 0.84.
+**Pi ≥ 0.86.0**
 
 ## Core features
 

package/README.zh-CN.md

@@ -29,7 +29,7 @@ pi --ultracode
 
 > `pi-ultracode` 会注册名为 `workflow` 的工具。如果已安装 `pi-dynamic-workflows`，请先运行 `pi remove npm:pi-dynamic-workflows`。
 
-当前版本已在 Pi 0.84 上验证。
+需要 Pi 0.86.0 或更高版本。模式提示词通过独立分区更新，不再替换整段系统提示词。
 
 ## 核心特性
 
@@ -66,14 +66,14 @@ Pi 会自行判断工作流是否有帮助。小任务仍可继续使用普通
 | `/ultracode deep` | 固定使用高保障深度验证 |
 | `/ultracode off` | 关闭且不改变父代理 effort |
 | `/ultracode status` | 查看配置的语义深度模式 |
-| `/ultracode default on` | 全局默认开启，新会话使用 `auto` |
+| `/ultracode default on` | 全局默认开启，并立即开启当前会话；已开启时保留当前深度 |
 | `/ultracode default off` | 取消默认开启 |
 | `/ultracode default` | 查看全局启动默认值 |
 | `/workflows` 或 `F6` | 打开工作流浏览器 |
 | `/workflows <runId>` | 打开指定运行 |
 | `/workflows abort` | 中止活动运行 |
 
-`/ultracode default on|off` 只修改启动默认值，不切换当前会话的模式，也不改变 effort。设置保存在 `~/.pi/agent/ultracode.json`（遵循 `PI_CODING_AGENT_DIR`），跨项目和重启生效；未设置时默认关闭。启动时，只有当前分支没有保存 Ultracode 模式才应用默认值，已有的 `off` 或深度选择在 reload、resume、fork 后继续保留。显式 `pi --ultracode` 仍可启用 `auto`。如需立即开启当前会话，执行 `/ultracode auto`。
+`/ultracode default on` 保存全局启动默认值，并立即将关闭的当前会话切换为 `auto`；当前已开启时保留所选深度。`/ultracode default off` 只取消默认开启，不关闭当前会话；关闭当前会话请用 `/ultracode off`。这些操作均不改变 effort。设置保存在 `~/.pi/agent/ultracode.json`（遵循 `PI_CODING_AGENT_DIR`），跨项目和重启生效；未设置时默认关闭。启动时，只有当前分支没有保存 Ultracode 模式才应用默认值，已有的 `off` 或深度选择在 reload、resume、fork 后继续保留。显式 `pi --ultracode` 仍可启用 `auto`。
 
 按 `Esc` 可取消正在运行的工作流。在 Pi 的 fullscreen TUI 中，请在工作流详情内使用 `Ctrl+PageUp`、`Ctrl+PageDown` 和 `Ctrl+End`。
 

package/extensions/ultracode.ts

@@ -111,9 +111,9 @@ export default function extension(pi: ExtensionAPI, extraDeps: UltracodeExtensio
   });
 
   pi.on("before_agent_start", async (event) => {
-    // Reconcile tool availability and append the standing policy on every
-    // enforcing turn, even when another active-tool writer caused drift.
+    // Reconcile tool availability and update our prompt section on every turn,
+    // including removal when the mode is off or suspended.
     mode.syncWorkflowTool(pi);
-    return mode.beforeAgentStart(event);
+    mode.beforeAgentStart(event);
   });
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-ultracode",
-  "version": "0.7.0",
+  "version": "0.8.0",
   "description": "Adaptive semantic-depth workflow orchestration for Pi, with focused, standard, and deep modes, isolated subagents, worktree delivery, structured output, and durable resume.",
   "type": "module",
   "keywords": [
@@ -53,10 +53,10 @@
     "acorn": "^8.11.0"
   },
   "devDependencies": {
-    "@earendil-works/pi-agent-core": "^0.84.0",
-    "@earendil-works/pi-ai": "^0.84.0",
-    "@earendil-works/pi-coding-agent": "^0.84.0",
-    "@earendil-works/pi-tui": "^0.84.0",
+    "@earendil-works/pi-agent-core": "^0.86.0",
+    "@earendil-works/pi-ai": "^0.86.0",
+    "@earendil-works/pi-coding-agent": "^0.86.0",
+    "@earendil-works/pi-tui": "^0.86.0",
     "@types/node": "^24.12.4",
     "typebox": "1.3.7",
     "typescript": "^5.9.3"
@@ -64,7 +64,7 @@
   "peerDependencies": {
     "@earendil-works/pi-agent-core": "*",
     "@earendil-works/pi-ai": "*",
-    "@earendil-works/pi-coding-agent": "*",
+    "@earendil-works/pi-coding-agent": ">=0.86.0",
     "@earendil-works/pi-tui": "*",
     "typebox": "*"
   },

package/src/commands.ts

@@ -52,8 +52,13 @@ export function registerCommands(
         try {
           if (value !== undefined) preferences.setDefaultEnabled(value === "on");
           const enabled = preferences.getDefaultEnabled();
+          if (value === "on") {
+            if (!mode.isEnabled()) mode.enable(pi, "auto");
+            ctx.ui.setStatus("ultracode", mode.statusLine((label) => ctx.ui.theme.fg("accent", label)));
+          }
+          const sessionStatus = value === "on" ? `current session: ${mode.getMode()}` : "current session unchanged";
           ctx.ui.notify(
-            `Ultracode default ${enabled ? "on (auto)" : "off"} — global startup preference; current session unchanged.`,
+            `Ultracode default ${enabled ? "on (auto)" : "off"} — global startup preference; ${sessionStatus}.`,
             "info",
           );
         } catch (error) {

package/src/mode.ts

@@ -184,11 +184,14 @@ export class UltracodeMode {
     return state !== undefined;
   }
 
-  /** Append the configured semantic-depth policy to the turn's system prompt. */
-  beforeAgentStart(event: { systemPrompt: string }): { systemPrompt: string } | undefined {
-    if (!this.isEnforcing() || !isActiveUltracodeMode(this.mode)) return undefined;
-    const block = ultracodeSystemBlock(this.mode);
-    return { systemPrompt: `${event.systemPrompt}\n\n${block}\n\n${ULTRACODE_ACTIVE_REMINDER}` };
+  /** Update only our prompt section so Pi can persist and diff it across turns. */
+  beforeAgentStart(event: { systemPromptOptions: { sections: Record<string, string> } }): void {
+    const { sections } = event.systemPromptOptions;
+    if (!this.isEnforcing() || !isActiveUltracodeMode(this.mode)) {
+      delete sections.ultracode;
+      return;
+    }
+    sections.ultracode = `${ultracodeSystemBlock(this.mode)}\n\n${ULTRACODE_ACTIVE_REMINDER}`;
   }
 
   statusLine(styleLabel: (label: string) => string = (label) => label): string {

package/src/prompts.ts

@@ -6,13 +6,12 @@ import type { ActiveUltracodeMode } from "./depth.ts";
 export const ULTRACODE_TAGLINE = "semantic-depth workflow orchestration";
 
 /**
- * The standing system-prompt block injected on every turn while Ultracode is
- * active. The parent model performs the semantic routing itself; starting a
+ * The standing system-prompt section body (Pi adds the XML wrapper). Injected
+ * on every active turn. The parent model performs semantic routing; starting a
  * separate agent merely to classify depth would defeat the focused path.
  */
 export function ultracodeSystemBlock(mode: ActiveUltracodeMode = "deep"): string {
   return [
-    "<ultracode>",
     `Configured mode: ${mode}.`,
     "Analysis depth is a semantic quality decision, never a wall-clock decision. Do not use elapsed time, deadlines, or duration limits to choose, lower, or stop analysis depth.",
     "Use the smallest depth that can establish a correct answer. Depth is controlled by research rounds, independent perspectives, verification strength, evidence requirements, skeptic count, and per-agent reasoning effort.",
@@ -34,7 +33,6 @@ export function ultracodeSystemBlock(mode: ActiveUltracodeMode = "deep"): string
     "- Avoid a separate synthesis agent when deterministic merging or parent synthesis is enough. Use an adjudicator only when a material conflict remains.",
     "- Select each workflow agent's effort from its task: use a per-call model suffix such as :medium for bounded discovery/synthesis, :high for substantive analysis or implementation, and :max only for deep or decisive high-risk verification. If omitted, the child session uses its normal user/model configuration.",
     "- When a workflow runs, log `analysis-depth: <level> — <reason>` before launching agents, `analysis-escalation: ...` for each semantic escalation, and `analysis-stop: ...` for the final evidence-based stop reason. Never use time as an escalation or stop reason.",
-    "</ultracode>",
   ].join("\n");
 }