pi-ultracode 0.6.0 → 0.7.0

package/README.zh-CN.md

@@ -66,10 +66,15 @@ Pi 会自行判断工作流是否有帮助。小任务仍可继续使用普通
 | `/ultracode deep` | 固定使用高保障深度验证 |
 | `/ultracode off` | 关闭且不改变父代理 effort |
 | `/ultracode status` | 查看配置的语义深度模式 |
+| `/ultracode default on` | 全局默认开启，新会话使用 `auto` |
+| `/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`。
+
 按 `Esc` 可取消正在运行的工作流。在 Pi 的 fullscreen TUI 中，请在工作流详情内使用 `Ctrl+PageUp`、`Ctrl+PageDown` 和 `Ctrl+End`。
 
 ## 分析深度

package/extensions/ultracode.ts

@@ -9,6 +9,7 @@ import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
 import { createWorkflowTool, type WorkflowToolDeps } from "../src/workflow/tool.ts";
 import { UltracodeMode, type ThinkingPreferenceStore } from "../src/mode.ts";
 import { registerCommands } from "../src/commands.ts";
+import { UltracodePreferences, type UltracodePreferenceStore } from "../src/preferences.ts";
 import { WorkflowRegistry } from "../src/workflow/registry.ts";
 
 export interface ThinkingPreferenceContext {
@@ -17,6 +18,7 @@ export interface ThinkingPreferenceContext {
 }
 
 export interface UltracodeExtensionDeps extends Partial<WorkflowToolDeps> {
+  preferences?: UltracodePreferenceStore;
   /** @deprecated Parent effort is user-owned; retained for source compatibility. */
   createThinkingPreferenceStore?: (
     context: ThinkingPreferenceContext,
@@ -27,6 +29,7 @@ export default function extension(pi: ExtensionAPI, extraDeps: UltracodeExtensio
   const mode = new UltracodeMode("workflow");
   const {
     createThinkingPreferenceStore: _unusedThinkingPreferenceStore,
+    preferences = new UltracodePreferences(),
     ...workflowDeps
   } = extraDeps;
 
@@ -38,7 +41,7 @@ export default function extension(pi: ExtensionAPI, extraDeps: UltracodeExtensio
   });
   pi.registerTool(workflowTool);
 
-  registerCommands(pi, mode, registry);
+  registerCommands(pi, mode, registry, preferences);
 
   // Opt-in via CLI flag: `pi --ultracode`.
   pi.registerFlag("ultracode", {
@@ -65,16 +68,23 @@ export default function extension(pi: ExtensionAPI, extraDeps: UltracodeExtensio
 
   pi.on("session_start", async (_event, ctx) => {
     // Restore persisted mode state across reload / resume / fork.
+    let hasSavedMode = true;
     try {
       // Mode entries are branch-local; discarded future branches must not win.
-      mode.restore(pi, ctx.sessionManager.getBranch() as any);
+      hasSavedMode = mode.restore(pi, ctx.sessionManager.getBranch() as any);
     } catch {
-      // ignore
+      // Do not apply a startup default when branch restoration failed.
     }
     if (!mode.isEnabled() && pi.getFlag?.("ultracode") === true) {
       mode.enable(pi, "auto");
+    } else if (!hasSavedMode && !mode.isEnabled()) {
+      try {
+        if (preferences.getDefaultEnabled()) mode.enable(pi, "auto");
+      } catch (error) {
+        ctx.ui.notify(`Failed to read Ultracode default: ${String(error)}`, "warning");
+      }
     }
-    // Registration makes extension tools discoverable; activation remains opt-in.
+    // Registration makes tools discoverable; activation follows the chosen mode.
     mode.syncWorkflowTool(pi);
     if (ctx.hasUI) {
       ctx.ui.setStatus(

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-ultracode",
-  "version": "0.6.0",
+  "version": "0.7.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": [

package/src/commands.ts

@@ -5,15 +5,21 @@
 import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
 import { ACTIVE_ULTRACODE_MODES, isActiveUltracodeMode } from "./depth.ts";
 import type { UltracodeMode } from "./mode.ts";
+import type { UltracodePreferenceStore } from "./preferences.ts";
 import type { WorkflowRegistry } from "./workflow/registry.ts";
 import { workflowRunsDir } from "./workflow/tool.ts";
 import { openWorkflowOverlay } from "./workflow/workflow-overlay.ts";
 
-export function registerCommands(pi: ExtensionAPI, mode: UltracodeMode, registry: WorkflowRegistry): void {
+export function registerCommands(
+  pi: ExtensionAPI,
+  mode: UltracodeMode,
+  registry: WorkflowRegistry,
+  preferences: UltracodePreferenceStore,
+): void {
   pi.registerCommand("ultracode", {
-    description: "Toggle adaptive Ultracode, or select a fixed semantic depth: auto|focused|standard|deep|off|status",
+    description: "Toggle Ultracode, select auto|focused|standard|deep|off|status, or set default on|off",
     getArgumentCompletions(prefix: string) {
-      return [...ACTIVE_ULTRACODE_MODES, "off", "status"]
+      return [...ACTIVE_ULTRACODE_MODES, "off", "status", "default", "default on", "default off"]
         .filter((value) => value.startsWith(prefix))
         .map((value) => ({ value, label: value }));
     },
@@ -37,6 +43,25 @@ export function registerCommands(pi: ExtensionAPI, mode: UltracodeMode, registry
         return;
       }
 
+      if (sub === "default") {
+        const value = parts[1]?.toLowerCase();
+        if (parts.length > 2 || (value !== undefined && value !== "on" && value !== "off")) {
+          ctx.ui.notify("Usage: /ultracode default [on|off]", "error");
+          return;
+        }
+        try {
+          if (value !== undefined) preferences.setDefaultEnabled(value === "on");
+          const enabled = preferences.getDefaultEnabled();
+          ctx.ui.notify(
+            `Ultracode default ${enabled ? "on (auto)" : "off"} — global startup preference; current session unchanged.`,
+            "info",
+          );
+        } catch (error) {
+          ctx.ui.notify(`Failed to ${value === undefined ? "read" : "save"} Ultracode default: ${String(error)}`, "error");
+        }
+        return;
+      }
+
       if (parts.length > 1) {
         ctx.ui.notify(ultracodeUsage(), "error");
         return;
@@ -102,5 +127,5 @@ export function registerCommands(pi: ExtensionAPI, mode: UltracodeMode, registry
 }
 
 function ultracodeUsage(): string {
-  return "Usage: /ultracode [auto|focused|standard|deep|off|status]";
+  return "Usage: /ultracode [auto|focused|standard|deep|off|status] or /ultracode default [on|off]";
 }

package/src/mode.ts

@@ -152,17 +152,15 @@ export class UltracodeMode {
 
   /** Turn Ultracode off without changing the parent thinking level. */
   disable(pi: ExtensionAPI): void {
-    if (!this.isEnabled()) {
-      this.syncWorkflowTool(pi);
-      return;
-    }
+    // Persist an explicit off even when already disabled, so startup defaults
+    // cannot override this session's choice on reload or resume.
     this.mode = "off";
     this.suspended = false;
     this.syncWorkflowTool(pi);
     this.persist(pi);
   }
 
-  /** Restore mode state from the active session branch without touching effort. */
+  /** Restore branch-local state; return whether a saved mode was found. */
   restore(
     pi: ExtensionAPI,
     entries: Array<{
@@ -171,7 +169,7 @@ export class UltracodeMode {
       data?: unknown;
       thinkingLevel?: unknown;
     }>,
-  ): void {
+  ): boolean {
     let latestData: unknown;
     for (const entry of entries) {
       if (entry.type === "custom" && entry.customType === MODE_ENTRY_TYPE && entry.data) {
@@ -179,9 +177,11 @@ export class UltracodeMode {
       }
     }
 
-    this.mode = parsePersistedModeState(latestData)?.mode ?? "off";
+    const state = parsePersistedModeState(latestData);
+    this.mode = state?.mode ?? "off";
     this.suspended = false;
     this.syncWorkflowTool(pi);
+    return state !== undefined;
   }
 
   /** Append the configured semantic-depth policy to the turn's system prompt. */

package/src/preferences.ts

@@ -0,0 +1,50 @@
+/** Global Ultracode startup preferences, separate from Pi's own settings. */
+import { randomUUID } from "node:crypto";
+import { mkdirSync, readFileSync, renameSync, rmSync, writeFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { getAgentDir } from "@earendil-works/pi-coding-agent";
+
+export interface UltracodePreferenceStore {
+  getDefaultEnabled(): boolean;
+  setDefaultEnabled(enabled: boolean): void;
+}
+
+export class UltracodePreferences implements UltracodePreferenceStore {
+  private readonly path: string;
+
+  constructor(path = join(getAgentDir(), "ultracode.json")) {
+    this.path = path;
+  }
+
+  getDefaultEnabled(): boolean {
+    return this.read().defaultEnabled === true;
+  }
+
+  setDefaultEnabled(enabled: boolean): void {
+    const settings = { ...this.read(), defaultEnabled: enabled };
+    mkdirSync(dirname(this.path), { recursive: true });
+    const temporaryPath = `${this.path}.${randomUUID()}.tmp`;
+    try {
+      writeFileSync(temporaryPath, `${JSON.stringify(settings, null, 2)}\n`, { flag: "wx", mode: 0o600 });
+      renameSync(temporaryPath, this.path);
+    } finally {
+      rmSync(temporaryPath, { force: true });
+    }
+  }
+
+  private read(): Record<string, unknown> {
+    let content: string;
+    try {
+      content = readFileSync(this.path, "utf8");
+    } catch (error) {
+      if ((error as NodeJS.ErrnoException).code === "ENOENT") return {};
+      throw error;
+    }
+    const value: unknown = JSON.parse(content);
+    if (!value || typeof value !== "object" || Array.isArray(value)
+      || ("defaultEnabled" in value && typeof value.defaultEnabled !== "boolean")) {
+      throw new Error(`Invalid Ultracode preferences in ${this.path}: expected an object with a boolean defaultEnabled.`);
+    }
+    return value as Record<string, unknown>;
+  }
+}