@aliou/pi-guardrails 0.7.5 → 0.7.7

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aliou/pi-guardrails",
-  "version": "0.7.5",
+  "version": "0.7.7",
   "license": "MIT",
   "type": "module",
   "private": false,
@@ -33,22 +33,32 @@
     "@aliou/sh": "^0.1.0"
   },
   "peerDependencies": {
-    "@mariozechner/pi-coding-agent": ">=0.51.0"
+    "@mariozechner/pi-coding-agent": ">=0.51.0",
+    "@mariozechner/pi-tui": ">=0.51.0"
   },
   "devDependencies": {
+    "@aliou/biome-plugins": "^0.3.2",
     "@biomejs/biome": "^2.3.13",
     "@changesets/cli": "^2.27.11",
     "@mariozechner/pi-coding-agent": "0.52.7",
-    "@mariozechner/pi-tui": "0.52.7",
     "@sinclair/typebox": "^0.34.48",
     "@types/node": "^25.0.10",
     "husky": "^9.1.7",
     "typescript": "^5.9.3"
   },
+  "peerDependenciesMeta": {
+    "@mariozechner/pi-coding-agent": {
+      "optional": true
+    },
+    "@mariozechner/pi-tui": {
+      "optional": true
+    }
+  },
   "scripts": {
     "typecheck": "tsc --noEmit",
     "lint": "biome check",
     "format": "biome check --write",
+    "check:lockfile": "pnpm install --frozen-lockfile --ignore-scripts",
     "changeset": "changeset",
     "version": "changeset version",
     "release": "pnpm changeset publish"

package/src/config.ts

@@ -82,6 +82,7 @@ import {
   migrateV0,
   needsMigration,
 } from "./utils/migration";
+import { pendingWarnings } from "./utils/warnings";
 
 /**
  * Config fields removed in the toolchain extraction.
@@ -136,7 +137,7 @@ const migrations: Migration<GuardrailsConfig>[] = [
         | string
         | undefined;
       if (!version || version < TOOLCHAIN_MIGRATION_VERSION) {
-        console.error(
+        pendingWarnings.push(
           "[guardrails] preventBrew, preventPython, enforcePackageManager, and packageManager " +
             "have been removed from guardrails and moved to @aliou/pi-toolchain. " +
             "These fields will be stripped from your config.",

package/src/index.ts

@@ -2,6 +2,7 @@ import type { ExtensionAPI } from "@mariozechner/pi-coding-agent";
 import { registerGuardrailsSettings } from "./commands/settings-command";
 import { configLoader } from "./config";
 import { setupGuardrailsHooks } from "./hooks";
+import { pendingWarnings } from "./utils/warnings";
 
 /**
  * Guardrails Extension
@@ -27,4 +28,10 @@ export default async function (pi: ExtensionAPI) {
 
   setupGuardrailsHooks(pi, config);
   registerGuardrailsSettings(pi);
+
+  pi.on("session_start", (_event, ctx) => {
+    for (const warning of pendingWarnings.splice(0)) {
+      ctx.ui.notify(warning, "warning");
+    }
+  });
 }

package/src/utils/matching.ts

@@ -9,6 +9,7 @@
  */
 
 import type { PatternConfig } from "../config";
+import { pendingWarnings } from "./warnings";
 
 export interface CompiledPattern {
   test: (input: string) => boolean;
@@ -62,7 +63,9 @@ export function compileFilePattern(config: PatternConfig): CompiledPattern {
       const re = new RegExp(config.pattern, "i");
       return { test: (input) => re.test(input), source: config };
     } catch {
-      console.error(`Invalid regex in guardrails config: ${config.pattern}`);
+      pendingWarnings.push(
+        `Invalid regex in guardrails config: ${config.pattern}`,
+      );
       return { test: () => false, source: config };
     }
   }
@@ -89,7 +92,9 @@ export function compileCommandPattern(config: PatternConfig): CompiledPattern {
       const re = new RegExp(config.pattern);
       return { test: (input) => re.test(input), source: config };
     } catch {
-      console.error(`Invalid regex in guardrails config: ${config.pattern}`);
+      pendingWarnings.push(
+        `Invalid regex in guardrails config: ${config.pattern}`,
+      );
       return { test: () => false, source: config };
     }
   }

package/src/utils/migration.ts

@@ -13,6 +13,7 @@ import type {
   GuardrailsConfig,
   PatternConfig,
 } from "../config";
+import { pendingWarnings } from "./warnings";
 
 export const CURRENT_VERSION = "0.6.0-20260204";
 
@@ -129,7 +130,7 @@ export async function backupConfig(configPath: string): Promise<void> {
     try {
       await copyFile(configPath, backupPath);
     } catch (err) {
-      console.warn(`guardrails: could not back up config: ${err}`);
+      pendingWarnings.push(`guardrails: could not back up config: ${err}`);
     }
   }
 }

package/src/utils/warnings.ts

@@ -0,0 +1,7 @@
+/**
+ * Module-level warnings queue for messages that arise before any session
+ * context is available (config loading, migration, pattern compilation).
+ *
+ * Drained and reported via ctx.ui.notify in the session_start handler.
+ */
+export const pendingWarnings: string[] = [];