@nklisch/pi-enhanced 0.1.6 → 0.1.7

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## v0.1.7
+
+### Changed
+
+- Rebundle `@nklisch/pi-clearance` v0.2.3 so confirmed mode and settings changes update the active-session footer immediately instead of waiting for another tool call or restart.
+- Rebundle `@nklisch/pi-model-modes` v0.3.2 so global mode persistence is visible in autocomplete and the bare `/mode` panel.
+
 ## v0.1.6
 
 ### Changed

package/node_modules/@nklisch/pi-clearance/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nklisch/pi-clearance",
-  "version": "0.2.2",
+  "version": "0.2.3",
   "description": "Configurable auto-reviewer Pi extension for parsed, structural command policy",
   "type": "module",
   "license": "MIT",

package/node_modules/@nklisch/pi-clearance/src/index.ts

@@ -131,6 +131,7 @@ const piAutoApprove: ExtensionFactory = (pi: ExtensionAPI) => {
     recentDecisionSource,
     analyzerRegistry,
     toolMetadata: () => toolMetadata(pi),
+    refreshOperatorStatus: (ctx, policy) => operatorStatus.refresh(ctx, policy),
   });
   registerProposalTools(
     pi,
@@ -138,6 +139,7 @@ const piAutoApprove: ExtensionFactory = (pi: ExtensionAPI) => {
       policyResolver,
       packageRegistration: packageRegistration.snapshot,
       audit,
+      refreshOperatorStatus: (ctx, policy) => operatorStatus.refresh(ctx, policy),
     },
     proposalBatchCache,
   );
@@ -147,6 +149,7 @@ const piAutoApprove: ExtensionFactory = (pi: ExtensionAPI) => {
       policyResolver,
       packageRegistration: packageRegistration.snapshot,
       audit,
+      refreshOperatorStatus: (ctx, policy) => operatorStatus.refresh(ctx, policy),
     },
     proposalBatchCache,
   );

package/node_modules/@nklisch/pi-clearance/src/runtime/config-commands/packs.ts

@@ -42,6 +42,7 @@ import {
   completion,
   filterCompletions,
   resolvePolicyReport,
+  refreshOperatorStatus,
   stableUnique,
   usageReport,
 } from "./types.ts";
@@ -319,6 +320,7 @@ export async function handlePackMutationCommand(input: {
   }
 
   const refreshed = await resolvePolicyReport(ctx, deps);
+  if (refreshed.ok) refreshOperatorStatus(ctx, deps, refreshed.policy);
   const effectivePack = refreshed.ok
     ? getAutoReviewerPack(refreshed.policy, packId)?.pack
     : undefined;

package/node_modules/@nklisch/pi-clearance/src/runtime/config-commands/scope.ts

@@ -31,6 +31,7 @@ import {
   completion,
   filterCompletions,
   resolvePolicyReport,
+  refreshOperatorStatus,
   stableUnique,
   usageReport,
 } from "./types.ts";
@@ -212,6 +213,7 @@ export async function handleScopeCommand(
   }
 
   const refreshed = await resolvePolicyReport(ctx, deps);
+  if (refreshed.ok) refreshOperatorStatus(ctx, deps, refreshed.policy);
   const status = refreshed.ok
     ? scopeStatusFromConfig(refreshed.policy.config)
     : undefined;

package/node_modules/@nklisch/pi-clearance/src/runtime/config-commands/settings/dispatcher.ts

@@ -37,6 +37,7 @@ import {
   type AutoReviewerCommandDependencies,
   type CommandReport,
   resolvePolicyReport,
+  refreshOperatorStatus,
   stableUnique,
 } from "../types.ts";
 import {
@@ -219,6 +220,12 @@ export async function dispatchSettingsAction(
   }
 
   const refreshed = await resolvePolicyReport(ctx, deps);
+  if (refreshed.ok) {
+    // Config writes and policy-cache invalidation are complete at this point;
+    // publish the same resolved policy immediately instead of waiting for the
+    // next tool call or session restart to refresh the footer projection.
+    refreshOperatorStatus(ctx, deps, refreshed.policy);
+  }
   const warnings = stableUnique([
     ...planned.plan.warnings.map((warning) => warning.message),
     ...apply.warnings,

package/node_modules/@nklisch/pi-clearance/src/runtime/config-commands/types.ts

@@ -1,6 +1,7 @@
 import type {
   ExtensionAPI,
   ExtensionCommandContext,
+  ExtensionContext,
 } from "@earendil-works/pi-coding-agent";
 
 import type { AuditLogger } from "../../audit/logger.ts";
@@ -33,6 +34,11 @@ export interface AutoReviewerCommandDependencies {
   readonly recentDecisionSource: RecentDecisionSource;
   /** Structural analyzer used only to summarize the recent command for the agent. */
   readonly analyzerRegistry: ToolAnalyzerRegistry;
+  /** Refresh the active-session footer after a confirmed config write resolves. */
+  readonly refreshOperatorStatus?: (
+    ctx: ExtensionContext,
+    policy: ResolvedPolicy,
+  ) => void;
 }
 
 export interface CommandReport<TDetails = unknown> {
@@ -78,6 +84,19 @@ export const USAGE_MARKDOWN = [
   "Reviewer prompt posture and model pinning are available as confirm-backed settings selectors; context mode, token budget, escalation, and other advanced fields are edited in user-owned global config.",
 ].join("\n");
 
+export function refreshOperatorStatus(
+  ctx: ExtensionContext,
+  deps: Pick<AutoReviewerCommandDependencies, "refreshOperatorStatus">,
+  policy: ResolvedPolicy,
+): void {
+  try {
+    deps.refreshOperatorStatus?.(ctx, policy);
+  } catch {
+    // Footer visibility is advisory and must never turn an applied config write
+    // into a reported failure or trigger rollback after durable validation.
+  }
+}
+
 export async function resolvePolicyForCommand(
   ctx: ExtensionCommandContext,
   deps: Pick<AutoReviewerCommandDependencies, "policyResolver">,

package/node_modules/@nklisch/pi-clearance/src/runtime/proposal-tools/apply-engine.ts

@@ -31,6 +31,7 @@ import {
   type RatchetProposalWritePlanResult,
 } from "../../replay/proposal-write-plan.ts";
 import { checkAgainstFloor } from "../../replay/proposals.ts";
+import { refreshOperatorStatus } from "../config-commands/types.ts";
 import {
   composeConfigCommandPostWritePolicy,
   createExtensionContextConfigCommandWriterDependencies,
@@ -558,6 +559,15 @@ export async function applyAcceptedWritableProposal(input: {
       ? {}
       : { transactionReplay: replayRecorder.result }),
   });
+  if (apply.status === "applied" && apply.changed === true) {
+    try {
+      const refreshed = await resolveRatchetPolicy(input.ctx, input.deps);
+      refreshOperatorStatus(input.ctx, input.deps, refreshed);
+    } catch {
+      // The durable writer and post-write validation have already settled.
+      // Footer refresh remains advisory and cannot change the apply result.
+    }
+  }
   return {
     apply: applyWithPostWriteReplay(apply, postWriteReplay),
     postWriteReplay,

package/node_modules/@nklisch/pi-clearance/src/runtime/ratchet-tools/types.ts

@@ -2,12 +2,17 @@ import type { ExtensionContext } from "@earendil-works/pi-coding-agent";
 
 import type { AuditLogger } from "../../audit/logger.ts";
 import type { PackageRegistrationSnapshot } from "../../packs/package-registration.ts";
-import type { PolicyResolver } from "../policy-cache.ts";
+import type { PolicyResolver, ResolvedPolicy } from "../policy-cache.ts";
 
 export interface RatchetToolDependencies {
   readonly policyResolver: PolicyResolver;
   readonly packageRegistration: () => PackageRegistrationSnapshot;
   readonly audit: AuditLogger;
+  /** Refresh the active-session footer after an approved proposal writes config. */
+  readonly refreshOperatorStatus?: (
+    ctx: ExtensionContext,
+    policy: ResolvedPolicy,
+  ) => void;
 }
 
 export interface RatchetToolContext {

package/node_modules/@nklisch/pi-model-modes/README.md

@@ -107,6 +107,11 @@ The command surface mirrors that merge model:
 /mode default off --global  # clear global default
 ```
 
+Autocomplete surfaces `--global` as the first choice after `/mode default ` and
+continues with preset completion after `/mode default --global `. The bare `/mode`
+panel also prints both durable forms so persistence is discoverable without reading
+documentation.
+
 Writes preserve sibling keys such as `cycleKeybinding`, format JSON with two-space
 indentation, and refuse to overwrite malformed/non-object JSON files. An invalid
 `defaultMode` (unknown preset / missing fragment) warns and is skipped during

package/node_modules/@nklisch/pi-model-modes/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nklisch/pi-model-modes",
-  "version": "0.3.1",
+  "version": "0.3.2",
   "description": "A pi extension that adapts the system prompt per model/mode.",
   "type": "module",
   "keywords": [

package/node_modules/@nklisch/pi-model-modes/src/autocomplete.ts

@@ -25,11 +25,14 @@ export const MODE_DEFAULT_GLOBAL_FLAG = "--global";
 const OFF_DESCRIPTION = "clear override — fall back to default";
 const NONE_DESCRIPTION = "explicit no-mode override — wins over default";
 const DEFAULT_DESCRIPTION = "manage the durable default — writes pi-model-modes.json";
-const GLOBAL_FLAG_DESCRIPTION = "target the global (~/.pi/agent) config file";
+const GLOBAL_FLAG_DESCRIPTION = "persist globally in ~/.pi/agent (instead of this project)";
 
 const MODE_ARG_TRIGGER = /^\/mode[ \t]+([^\s]*)$/;
 /** Stage 2: `<action>` token after `/mode default ` (no further tokens). */
 const MODE_DEFAULT_ACTION_TRIGGER = /^\/mode[ \t]+default[ \t]+([^\s]*)$/;
+/** Stage 2b: action after the discoverable leading `--global` form. */
+const MODE_DEFAULT_GLOBAL_ACTION_TRIGGER =
+  /^\/mode[ \t]+default[ \t]+--global[ \t]+([^\s]*)$/;
 /** Stage 3: a leading-dash token after `/mode default <action> `. */
 const MODE_DEFAULT_FLAG_TRIGGER = /^\/mode[ \t]+default[ \t]+[^\s]+[ \t]+(--?[^\s]*)$/;
 
@@ -69,7 +72,7 @@ export function buildModeTopLevelItems(
   ];
 }
 
-/** PURE: build the single-item `--global` suggestion list for stage 3. */
+/** PURE: build the single-item `--global` suggestion list. */
 export function buildDefaultGlobalFlagItems(): AutocompleteItem[] {
   return [
     {
@@ -93,8 +96,9 @@ export function filterModeArgItems(
  * should delegate. Three-stage dispatch for the `/mode default` subcommand:
  *
  *   - Stage 3: `/mode default <action> <--flag>` → `[--global]`
- *   - Stage 2: `/mode default <action>` → presets + `off` (NO `default` —
- *     `default default` is meaningless)
+ *   - Stage 2b: `/mode default --global <action>` → presets + `off`
+ *   - Stage 2: `/mode default <action>` → `--global` + presets + `off` (NO
+ *     `default` — `default default` is meaningless)
  *   - Stage 1: `/mode <partial>` → presets + `off` + `default` (top level)
  *
  * The three triggers are structurally mutually exclusive (trailing-space gates
@@ -115,12 +119,26 @@ export function getModeArgSuggestions(
     };
   }
 
-  // Stage 2: action after `/mode default `.
+  // Stage 2b: action after the leading, discoverable global flag form.
+  const globalActionToken = beforeCursor.match(
+    MODE_DEFAULT_GLOBAL_ACTION_TRIGGER,
+  )?.[1];
+  if (globalActionToken !== undefined) {
+    return {
+      prefix: globalActionToken,
+      items: filterModeArgItems(buildModeArgItems(registry), globalActionToken),
+    };
+  }
+
+  // Stage 2: action or global scope after `/mode default `.
   const actionToken = beforeCursor.match(MODE_DEFAULT_ACTION_TRIGGER)?.[1];
   if (actionToken !== undefined) {
     return {
       prefix: actionToken,
-      items: filterModeArgItems(buildModeArgItems(registry), actionToken),
+      items: filterModeArgItems(
+        [...buildDefaultGlobalFlagItems(), ...buildModeArgItems(registry)],
+        actionToken,
+      ),
     };
   }
 

package/node_modules/@nklisch/pi-model-modes/src/commands.ts

@@ -241,6 +241,9 @@ export function formatModeListing(
     `  ${summary}`,
     "Available presets:",
     presetList,
+    "Durable defaults:",
+    "  /mode default <preset> — persist for this project",
+    "  /mode default --global <preset> — persist globally",
   ].join("\n");
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nklisch/pi-enhanced",
-  "version": "0.1.6",
+  "version": "0.1.7",
   "description": "Pi, enhanced — one install for nklisch's full harness: policy-gated command review, plugin marketplace, subagents, background tasks, research tools, search, model modes, and a curated UX set.",
   "author": {
     "name": "nklisch"