pi-warden 0.7.0 → 0.9.0

package/dist/shape.js

@@ -1,6 +1,7 @@
 import { isMode } from "./config.js";
+import { DEFAULT_TEMPLATES } from "./widget.js";
 /** The config layout this extension build expects; compared with the loaded config module's CONFIG_SCHEMA. */
-export const EXPECTED_SCHEMA = 3;
+export const EXPECTED_SCHEMA = 5;
 const off = { enabled: false };
 const proseOff = () => ({ ...off, audience: "technical", threshold: 1, trend: 3, minChars: 1 });
 /**
@@ -30,8 +31,11 @@ export function completeConfig(loaded) {
         done: section("done", { ...off, claimsDone: 1, nudge: false }),
         slop: section("slop", { ...off, threshold: 1, prose: proseOff() }),
         security: section("security", { ...off, threshold: 1 }),
+        rules: section("rules", { ...off, threshold: 1, files: [], fallback: false, maxChars: 500, exclude: [], skip: [], sensitivePaths: {} }),
         context: section("context", { ...off, tailMinChars: 1, confidence: 1, duplicateMinChars: Number.MAX_SAFE_INTEGER, recallTool: "none", formatConfidence: 1 }),
-        widget: section("widget", { ...off, placement: "aboveEditor", shortcut: "", panelWidth: "40%", action: "", stuck: "", done: "", prose: "", security: "", context: "" }),
+        runaway: section("runaway", { ...off, repeats: Number.MAX_SAFE_INTEGER, thinkingRepeats: Number.MAX_SAFE_INTEGER, minChars: Number.MAX_SAFE_INTEGER, recover: false }),
+        notify: section("notify", { ...off, cooldownMs: 0, command: [] }),
+        widget: section("widget", { ...off, placement: "aboveEditor", shortcut: "", panelWidth: "40%", action: "", stuck: "", done: "", prose: "", security: "", context: "", runaway: "", rules: "" }),
     };
     if (typeof config.slop.prose !== "object" || config.slop.prose === null) {
         missing.push("slop.prose");
@@ -44,6 +48,11 @@ export function completeConfig(loaded) {
     }
     if (typeof config.widget.panelWidth !== "string" && typeof config.widget.panelWidth !== "number")
         config.widget = { ...config.widget, panelWidth: "40%" };
+    // The runaway guard added its template later than the other sections; an older widget section renders the default line.
+    if (typeof config.widget.runaway !== "string")
+        config.widget = { ...config.widget, runaway: DEFAULT_TEMPLATES.runaway };
+    if (typeof config.widget.rules !== "string")
+        config.widget = { ...config.widget, rules: DEFAULT_TEMPLATES.rules };
     return { config, missing };
 }
 export function shapeWarning(missing, loadedSchema) {

package/dist/trace.d.ts

@@ -1,8 +1,10 @@
 import type { DoneVerdict } from "./done.js";
 import type { Verdict } from "./guard.js";
 import type { ProseVerdict } from "./prose.js";
+import type { RulesVerdict } from "./rules.js";
+import type { RunawayVerdict } from "./runaway.js";
 import type { Attempt, StuckVerdict } from "./stuck.js";
-export type GuardName = "action" | "stuck" | "done" | "prose" | "security" | "context";
+export type GuardName = "action" | "stuck" | "done" | "prose" | "security" | "context" | "runaway" | "rules";
 export interface TraceEntry {
     at: number;
     guard: GuardName;
@@ -28,4 +30,6 @@ export declare function actionDetails(verdict: Verdict, extra?: {
 }): string[];
 export declare function stuckDetails(verdict: StuckVerdict, attempts: readonly Attempt[], told?: string): string[];
 export declare function doneDetails(verdict: DoneVerdict, finalMessage: string, told?: string): string[];
+export declare function runawayDetails(verdict: RunawayVerdict, told: string | undefined, recovering: boolean): string[];
 export declare function proseDetails(verdict: ProseVerdict, reply: string, audience: string, told?: string): string[];
+export declare function rulesDetails(verdict: RulesVerdict, told?: string): string[];

package/dist/trace.js

@@ -81,6 +81,16 @@ export function doneDetails(verdict, finalMessage, told) {
         lines.push(`agent told: ${clip(told, 400)}`);
     return lines;
 }
+export function runawayDetails(verdict, told, recovering) {
+    const lines = [
+        `repeated: ${clip(verdict.block, 200)}`,
+        `${verdict.count} times in ${verdict.chars} chars of ${verdict.kind}; signal: ${verdict.signal === "block" ? "identical paragraph" : "recurring trailing phrase"}`,
+        recovering ? "run stopped; one follow-up turn started" : "run stopped; not restarted",
+    ];
+    if (told)
+        lines.push(`agent told: ${clip(told, 400)}`);
+    return lines;
+}
 export function proseDetails(verdict, reply, audience, told) {
     const lines = [`reply: ${clip(reply.replace(/\s+/g, " "), 300)}`, `audience: ${audience}`];
     if (verdict.scores)
@@ -93,3 +103,17 @@ export function proseDetails(verdict, reply, audience, told) {
         lines.push(`agent told: ${clip(told, 400)}`);
     return lines;
 }
+export function rulesDetails(verdict, told) {
+    const lines = [`${verdict.tool} ${verdict.path}; rules from ${verdict.sources.join(", ") || "nowhere"}${verdict.aggregate ? " (judged as one document)" : ""}; ${verdict.asked} question${verdict.asked === 1 ? "" : "s"}`];
+    if (verdict.scores?.length)
+        lines.push(`jev: ${verdict.scores.map(score => `${score.name} ${score.outcome.replace(/_/g, " ")} ${percent(score.violation)}`).join(" · ")}${verdict.model ? ` · ${verdict.model} · ${verdict.elapsedMs} ms` : ""}`);
+    if (verdict.findings.length)
+        lines.push(`violations: ${verdict.findings.map(finding => `${finding.name} (${percent(finding.violation)})`).join("; ")}${verdict.editId ? ` in ${verdict.editId.replace("_", " ")}` : ""}`);
+    if (verdict.skippedReason)
+        lines.push(`skipped: ${verdict.skippedReason}`);
+    if (verdict.error)
+        lines.push(`typesafe: ${verdict.error}`);
+    if (told)
+        lines.push(`agent told: ${clip(told, 400)}`);
+    return lines;
+}

package/dist/widget.d.ts

@@ -1,6 +1,8 @@
 import type { DoneVerdict } from "./done.js";
 import type { Verdict } from "./guard.js";
 import type { ProseVerdict } from "./prose.js";
+import type { RulesVerdict } from "./rules.js";
+import type { RunawayVerdict } from "./runaway.js";
 import type { StuckVerdict } from "./stuck.js";
 export type WidgetPlacement = "aboveEditor" | "belowEditor";
 export interface WidgetConfig {
@@ -17,6 +19,8 @@ export interface WidgetConfig {
     prose: string;
     security: string;
     context: string;
+    runaway: string;
+    rules: string;
 }
 export declare const DEFAULT_TEMPLATES: {
     readonly action: "warden · {tool} · irreversible {irreversible} · off-task {offTask} · {scope} · slop: {slop} · patterns: {patterns} · {flags} · {level}";
@@ -25,6 +29,8 @@ export declare const DEFAULT_TEMPLATES: {
     readonly prose: "warden · prose · wordy {wordy} · clichés {cliches} · jargon {jargon} · {flags} · {status}";
     readonly security: "warden · security · {tool} · injection {injection} · exfiltration {exfiltration} · {status}";
     readonly context: "warden · context · {tool} · {retention} · saved {bytesSaved} bytes";
+    readonly runaway: "warden · runaway · {kind} · {count}× repeated · {chars} chars · {signal} · {status}";
+    readonly rules: "warden · rules · {tool} {path} · {asked} rules · {violations} · {status}";
 };
 export declare function defaultWidgetConfig(): WidgetConfig;
 export type Tokens = Record<string, string | undefined>;
@@ -35,12 +41,16 @@ export type Tokens = Record<string, string | undefined>;
 export declare function renderTemplate(template: string, tokens: Tokens): string;
 export declare function actionTokens(verdict: Verdict, at?: number): Tokens;
 export declare function stuckTokens(verdict: StuckVerdict, at?: number): Tokens;
+export declare function runawayTokens(verdict: RunawayVerdict, recovering: boolean, at?: number): Tokens;
 export declare function doneTokens(verdict: DoneVerdict, at?: number): Tokens;
 export declare function proseTokens(verdict: ProseVerdict, at?: number): Tokens;
+export declare function rulesTokens(verdict: RulesVerdict, at?: number): Tokens;
 /** Token names users can put in templates, for /warden status and the README. */
 export declare const TOKEN_NAMES: {
     readonly security: readonly ["tool", "injection", "exfiltration", "status"];
     readonly context: readonly ["tool", "retention", "bytesSaved"];
+    readonly runaway: readonly ["kind", "count", "chars", "signal", "block", "status", "time", "guard"];
+    readonly rules: readonly ["tool", "path", "asked", "violations", "status", "source", "reasons", "model", "ms", "flags", "time", "guard"];
     readonly action: readonly ["tool", "level", "source", "irreversible", "offTask", "scope", "approved", "slop", "slopStub", "slopComments", "slopDead", "slopHedging", "patterns", "reasons", "path", "model", "ms", "flags", "time", "guard"];
     readonly prose: readonly ["wordy", "cliches", "jargon", "status", "reasons", "model", "ms", "flags", "time", "guard"];
     readonly stuck: readonly ["failures", "sameStrategy", "approachChange", "progress", "status", "source", "reasons", "model", "ms", "flags", "time", "guard"];

package/dist/widget.js

@@ -5,6 +5,8 @@ export const DEFAULT_TEMPLATES = {
     prose: "warden · prose · wordy {wordy} · clichés {cliches} · jargon {jargon} · {flags} · {status}",
     security: "warden · security · {tool} · injection {injection} · exfiltration {exfiltration} · {status}",
     context: "warden · context · {tool} · {retention} · saved {bytesSaved} bytes",
+    runaway: "warden · runaway · {kind} · {count}× repeated · {chars} chars · {signal} · {status}",
+    rules: "warden · rules · {tool} {path} · {asked} rules · {violations} · {status}",
 };
 export function defaultWidgetConfig() {
     return { enabled: true, placement: "aboveEditor", shortcut: "ctrl+shift+w", panelWidth: "40%", ...DEFAULT_TEMPLATES };
@@ -81,6 +83,18 @@ export function stuckTokens(verdict, at = Date.now()) {
         flags: flags || undefined,
     };
 }
+export function runawayTokens(verdict, recovering, at = Date.now()) {
+    return {
+        guard: "runaway",
+        time: time(at),
+        kind: verdict.kind,
+        count: String(verdict.count),
+        chars: String(verdict.chars),
+        signal: verdict.signal,
+        block: verdict.block,
+        status: recovering ? "stopped, recovering" : "stopped",
+    };
+}
 export function doneTokens(verdict, at = Date.now()) {
     return {
         guard: "done",
@@ -113,10 +127,28 @@ export function proseTokens(verdict, at = Date.now()) {
         flags: verdict.error ? "typesafe error" : undefined,
     };
 }
+export function rulesTokens(verdict, at = Date.now()) {
+    return {
+        guard: "rules",
+        time: time(at),
+        tool: verdict.tool,
+        path: verdict.path,
+        asked: verdict.source === "skipped" ? undefined : String(verdict.asked),
+        violations: verdict.findings.length ? verdict.findings.map(finding => `${finding.name} ${finding.violation.toFixed(2)}`).join(", ") : verdict.scores ? "none" : undefined,
+        status: verdict.source === "error" ? "typesafe error" : verdict.source === "skipped" ? "skipped" : verdict.findings.length ? "violation" : "ok",
+        source: verdict.source,
+        reasons: verdict.skippedReason ?? (verdict.findings.length ? verdict.findings.map(finding => finding.name).join("; ") : undefined),
+        model: verdict.model,
+        ms: verdict.elapsedMs === undefined ? undefined : String(verdict.elapsedMs),
+        flags: verdict.error ? "typesafe error" : undefined,
+    };
+}
 /** Token names users can put in templates, for /warden status and the README. */
 export const TOKEN_NAMES = {
     security: ["tool", "injection", "exfiltration", "status"],
     context: ["tool", "retention", "bytesSaved"],
+    runaway: ["kind", "count", "chars", "signal", "block", "status", "time", "guard"],
+    rules: ["tool", "path", "asked", "violations", "status", "source", "reasons", "model", "ms", "flags", "time", "guard"],
     action: ["tool", "level", "source", "irreversible", "offTask", "scope", "approved", "slop", "slopStub", "slopComments", "slopDead", "slopHedging", "patterns", "reasons", "path", "model", "ms", "flags", "time", "guard"],
     prose: ["wordy", "cliches", "jargon", "status", "reasons", "model", "ms", "flags", "time", "guard"],
     stuck: ["failures", "sameStrategy", "approachChange", "progress", "status", "source", "reasons", "model", "ms", "flags", "time", "guard"],

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "pi-warden",
-  "version": "0.7.0",
-  "description": "Guardrails for Pi built on pi-typesafe that steer the agent instead of interrupting you: Jev judges irreversible and off-task tool calls before they run, detects stuck loops, checks unverified done claims, and flags slop.",
+  "version": "0.9.0",
+  "description": "Guardrails for Pi built on pi-typesafe that steer the agent instead of interrupting you: Jev judges irreversible and off-task tool calls before they run, checks written code against your project rules, detects stuck loops, checks unverified done claims, and flags slop.",
   "type": "module",
   "license": "MIT",
   "author": "Ryan Gapac",