pi-delegation-policy 0.1.2 → 0.2.0

package/CHANGELOG.md

@@ -2,6 +2,17 @@
 
 ## Unreleased
 
+## 0.2.0 - 2026-08-26
+
+### Added
+
+- Added optional global intensity with session-branch overrides and a built-in `off` fallback.
+- Added **Use global default** to the intensity selector.
+
+### Fixed
+
+- Replaced the terminal-ambiguous `Ctrl+Shift+D` shortcut with `Ctrl+Alt+D`.
+
 ## 0.1.2 - 2026-08-26
 
 ### Fixed

package/README.md

@@ -2,14 +2,14 @@
 
 A local Pi extension that lets you choose delegation intensity and exact model references for Small, Medium, Large, and an optional UI Design role. It guides the main agent; it does not run, route, or enforce delegated work.
 
-> **Status:** Version 0.1.2 is available from npm. Every new session starts at `off`.
+> **Status:** Version 0.2.0 is available from npm.
 >
 > **Documentation:** Read the [documentation site](https://yivas.github.io/pi-delegation-policy/).
 
 ## What it does
 
-- Sets delegation intensity to `off`, `normal`, or `aggressive` for the current session branch.
-- Keeps global defaults for model references, preference, and the optional UI Design role.
+- Sets delegation intensity to `off`, `normal`, or `aggressive` globally or for the current session branch.
+- Keeps global defaults for intensity, model references, preference, and the optional UI Design role.
 - Stores session changes in Pi's session branch, so they survive reload, resume, and tree navigation.
 - Uses Pi's scoped models when configured, otherwise its available authenticated models.
 - Injects one policy block through Pi's public `before_agent_start` event when the active configuration is valid.
@@ -39,7 +39,7 @@ It supports Pi `0.84.1`. Restart Pi or run `/reload` after installation. To inst
 /delegate reset                   Reset this session branch to off
 ```
 
-`Ctrl+Shift+D` opens the selector when the shortcut is available. There is no separate off shortcut; use `/delegate off` or choose `off` in the selector. Changes apply to the next agent run. An agent already running keeps the system prompt it started with.
+`Ctrl+Alt+D` opens the selector when the shortcut is available. There is no separate off shortcut; use `/delegate off` or choose `off` in the selector. Changes apply to the next agent run. An agent already running keeps the system prompt it started with.
 
 The footer shows `D:OFF`, `D:NORM`, `D:AGG`, or `D:ERR` without replacing Pi's own status.
 
@@ -51,11 +51,12 @@ Global defaults live at:
 ~/.pi/agent/delegation-policy.json
 ```
 
-They use schema version 2. The file stores model references, preference, and an optional UI Design model. It never stores intensity or thinking.
+They use schema version 2. The file stores optional intensity, model references, preference, and an optional UI Design model. It never stores thinking.
 
 ```json
 {
   "schemaVersion": 2,
+  "intensity": "normal",
   "preference": "standard",
   "small": {
     "provider": "example-provider",
@@ -82,9 +83,9 @@ Schema version 1 is inactive and is not migrated automatically. Open `/delegate`
 
 ### Global defaults and session branches
 
-A new session with no delegation entry starts at `off`. A branch restores the latest valid delegation entry in its active history, so a fork created after `normal`, `aggressive`, or `off` inherits that state until the branch records another change. Global model references and preference apply until the session branch overrides their matching fields. Selecting **Save effective configuration as defaults** copies the current roles, preference, and UI Design setting to the global file without copying intensity.
+A session branch inherits global intensity, model references, preference, and UI Design until it records matching overrides. If global intensity is absent, the built-in default is `off`. A fork restores the latest valid delegation entry in its active history. The intensity selector can return a branch to **Use global default**.
 
-`/delegate reset` writes a session state with `off` and returns non-intensity fields to their global defaults.
+Selecting **Save effective configuration as defaults** copies the complete effective configuration, including intensity, to the global file. `/delegate reset` remains an explicit safety action: it writes a branch state with `off` and returns every other field to its global default.
 
 ### Intensity
 
@@ -117,7 +118,7 @@ UI Design is optional. When configured, it is limited to visual design direction
 
 ## Security and privacy
 
-The extension stores provider and model identifiers in local configuration and session entries. It does not store credentials, send telemetry, or make network requests. Review configuration before using it and remove credentials, prompts, personal paths, session files, and unredacted logs from reports.
+The extension stores intensity, preference, and provider/model identifiers in local configuration and session entries. It does not store credentials, send telemetry, or make network requests. Review configuration before using it and remove credentials, prompts, personal paths, session files, and unredacted logs from reports.
 
 Read [`SECURITY.md`](SECURITY.md) for reporting guidance.
 

package/SECURITY.md

@@ -14,4 +14,4 @@ Include the affected version or commit, operating system, Pi version, reproducti
 
 ## Supported versions
 
-Only the latest published version is supported. Version 0.1.2 is the current supported release.
+Only the latest published version is supported. Version 0.2.0 is the current supported release.

package/examples/global.json

@@ -1,5 +1,6 @@
 {
   "schemaVersion": 2,
+  "intensity": "normal",
   "preference": "standard",
   "small": {
     "provider": "example-provider",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-delegation-policy",
-  "version": "0.1.2",
+  "version": "0.2.0",
   "private": false,
   "description": "A Pi extension for configurable delegation intensity and exact subagent role model references.",
   "type": "module",

package/schema/delegation-policy.schema.json

@@ -6,6 +6,7 @@
   "required": ["schemaVersion"],
   "properties": {
     "schemaVersion": { "const": 2 },
+    "intensity": { "enum": ["off", "normal", "aggressive"] },
     "preference": { "enum": ["efficient", "standard", "intensive"] },
     "small": { "$ref": "#/$defs/modelRef" },
     "medium": { "$ref": "#/$defs/modelRef" },

package/src/config.ts

@@ -67,8 +67,17 @@ function copyModelRef(value: ModelRef | undefined): ModelRef | undefined {
 export function parseConfig(value: unknown): GlobalDefaults | undefined {
   if (
     !isRecord(value) ||
-    !hasOnlyKeys(value, ["schemaVersion", "preference", "small", "medium", "large", "uiDesign"]) ||
+    !hasOnlyKeys(value, [
+      "schemaVersion",
+      "intensity",
+      "preference",
+      "small",
+      "medium",
+      "large",
+      "uiDesign",
+    ]) ||
     value.schemaVersion !== 2 ||
+    (value.intensity !== undefined && !isIntensity(value.intensity)) ||
     (value.preference !== undefined && !isPreference(value.preference))
   )
     return undefined;
@@ -88,6 +97,7 @@ export function parseConfig(value: unknown): GlobalDefaults | undefined {
 
   return {
     schemaVersion: 2,
+    ...(value.intensity ? { intensity: value.intensity } : {}),
     ...(value.preference ? { preference: value.preference } : {}),
     ...(small ? { small } : {}),
     ...(medium ? { medium } : {}),
@@ -109,7 +119,7 @@ export function parseSessionState(value: unknown): SessionDelegateState | undefi
       "uiDesign",
     ]) ||
     value.schemaVersion !== 2 ||
-    !isIntensity(value.intensity) ||
+    (value.intensity !== undefined && !isIntensity(value.intensity)) ||
     (value.preference !== undefined && !isPreference(value.preference))
   )
     return undefined;
@@ -132,7 +142,7 @@ export function parseSessionState(value: unknown): SessionDelegateState | undefi
 
   return {
     schemaVersion: 2,
-    intensity: value.intensity,
+    ...(value.intensity ? { intensity: value.intensity } : {}),
     ...(value.preference ? { preference: value.preference } : {}),
     ...(small ? { small } : {}),
     ...(medium ? { medium } : {}),
@@ -218,14 +228,14 @@ export function resolveDelegateState(
         : copyModelRef(session.uiDesign);
 
   return {
-    intensity: session.intensity,
+    intensity: session.intensity ?? defaults.intensity ?? "off",
     preference: session.preference ?? defaults.preference ?? "standard",
     small: copyModelRef(session.small ?? defaults.small),
     medium: copyModelRef(session.medium ?? defaults.medium),
     large: copyModelRef(session.large ?? defaults.large),
     ...(uiDesign ? { uiDesign } : {}),
     source: {
-      intensity: "session",
+      intensity: sourceFor(session.intensity, defaults.intensity),
       preference: sourceFor(session.preference, defaults.preference),
       small: sourceFor(session.small, defaults.small),
       medium: sourceFor(session.medium, defaults.medium),
@@ -238,6 +248,7 @@ export function resolveDelegateState(
 export function defaultsFromEffectiveState(state: EffectiveDelegateState): GlobalDefaults {
   return {
     schemaVersion: 2,
+    intensity: state.intensity,
     preference: state.preference,
     ...(state.small ? { small: { ...state.small } } : {}),
     ...(state.medium ? { medium: { ...state.medium } } : {}),

package/src/index.ts

@@ -49,14 +49,19 @@ function updateStatus(ctx: ExtensionContext, state: RuntimeState): void {
   ctx.ui.setStatus(STATUS_KEY, ctx.ui.theme.fg("dim", statusLabel(state)));
 }
 
+async function openEditor(pi: ExtensionAPI, ctx: ExtensionContext): Promise<void> {
+  await openDelegateEditor(ctx, pi);
+  updateStatus(ctx, await refresh(ctx));
+}
+
 function configuredLabel(value: unknown): string {
   return value ? "configured" : "unset";
 }
 
-function statusText(state: RuntimeState): string {
+export function statusText(state: RuntimeState): string {
   const { effective } = state;
   const details = [
-    `${statusLabel(state)} intensity=${effective.intensity}`,
+    `${statusLabel(state)} intensity=${effective.intensity} (${effective.source.intensity})`,
     `preference=${effective.preference} (${effective.source.preference})`,
     `small=${configuredLabel(effective.small)} (${effective.source.small})`,
     `medium=${configuredLabel(effective.medium)} (${effective.source.medium})`,
@@ -99,7 +104,7 @@ export default function piDelegationPolicy(pi: ExtensionAPI): void {
     handler: async (args, ctx) => {
       const action = parseCommand(args);
       if (action.kind === "open") {
-        await openDelegateEditor(ctx, pi);
+        await openEditor(pi, ctx);
         return;
       }
       if (action.kind === "status") {
@@ -120,9 +125,9 @@ export default function piDelegationPolicy(pi: ExtensionAPI): void {
     },
   });
 
-  pi.registerShortcut("ctrl+shift+d", {
+  pi.registerShortcut("ctrl+alt+d", {
     description: "Open delegation policy",
-    handler: async (ctx) => openDelegateEditor(ctx, pi),
+    handler: async (ctx) => openEditor(pi, ctx),
   });
 
   pi.on("session_start", async (_event, ctx) => {

package/src/types.ts

@@ -24,6 +24,7 @@ export type ModelRef = {
 
 export type GlobalDefaults = {
   schemaVersion: 2;
+  intensity?: Intensity;
   preference?: Preference;
   small?: ModelRef;
   medium?: ModelRef;
@@ -33,7 +34,7 @@ export type GlobalDefaults = {
 
 export type SessionDelegateState = {
   schemaVersion: 2;
-  intensity: Intensity;
+  intensity?: Intensity;
   preference?: Preference;
   small?: ModelRef;
   medium?: ModelRef;
@@ -52,7 +53,7 @@ export type EffectiveDelegateState = {
   large?: ModelRef;
   uiDesign?: ModelRef;
   source: {
-    intensity: "session";
+    intensity: ValueSource;
     preference: ValueSource;
     small: ValueSource;
     medium: ValueSource;
@@ -73,5 +74,5 @@ export function emptyGlobalDefaults(): GlobalDefaults {
 }
 
 export function emptySessionState(): SessionDelegateState {
-  return { schemaVersion: 2, intensity: "off" };
+  return { schemaVersion: 2 };
 }

package/src/ui.ts

@@ -13,7 +13,6 @@ import {
   type RuntimeState,
 } from "./runtime.ts";
 import {
-  emptySessionState,
   INTENSITIES,
   MODEL_ROLES,
   PREFERENCES,
@@ -109,8 +108,13 @@ async function selectUiDesign(ctx: ExtensionContext, draft: SessionDelegateState
 }
 
 async function selectIntensity(ctx: ExtensionContext, draft: SessionDelegateState): Promise<void> {
-  const selected = await selectOrCancel(ctx, "Delegation intensity", [...INTENSITIES]);
-  if (selected) draft.intensity = selected as Intensity;
+  const selected = await selectOrCancel(ctx, "Delegation intensity", [
+    USE_GLOBAL_DEFAULT,
+    ...INTENSITIES,
+  ]);
+  if (!selected) return;
+  if (selected === USE_GLOBAL_DEFAULT) delete draft.intensity;
+  else draft.intensity = selected as Intensity;
 }
 
 async function selectPreference(ctx: ExtensionContext, draft: SessionDelegateState): Promise<void> {
@@ -194,7 +198,7 @@ export async function openDelegateEditor(ctx: ExtensionContext, pi: ExtensionAPI
         await writeConfig(getGlobalConfigPath(), defaults);
         state.global = defaults;
         state.diagnostics = [];
-        ctx.ui.notify("Saved effective role settings as global defaults.", "info");
+        ctx.ui.notify("Saved effective delegation settings as global defaults.", "info");
       } catch {
         ctx.ui.notify(
           "Could not save global defaults. Session settings were not changed.",
@@ -203,7 +207,7 @@ export async function openDelegateEditor(ctx: ExtensionContext, pi: ExtensionAPI
       }
     }
     if (selected === RESET_SESSION) {
-      draft = emptySessionState();
+      draft = { schemaVersion: 2, intensity: "off" };
     }
   }
 }