pi-warden 0.2.1 → 0.4.0

package/dist/widget.js

@@ -0,0 +1,120 @@
+export const DEFAULT_TEMPLATES = {
+    action: "warden · {tool} · irreversible {irreversible} · off-task {offTask} · {scope} · slop: {slop} · patterns: {patterns} · {flags} · {level}",
+    stuck: "warden · stuck · {failures} failures · same strategy {sameStrategy} · change {approachChange} · progress {progress} · {flags} · {status}",
+    done: "warden · done-check · {changes} changes · {checksPassed}/{checks} checks passed · claims done {claimsDone} · claims verified {claimsVerified} · checks apply {checksApply} · {outcome} · {status}",
+    prose: "warden · prose · wordy {wordy} · clichés {cliches} · jargon {jargon} · {flags} · {status}",
+};
+export function defaultWidgetConfig() {
+    return { enabled: true, placement: "aboveEditor", shortcut: "ctrl+shift+w", ...DEFAULT_TEMPLATES };
+}
+const SEPARATOR = " · ";
+const TOKEN = /\{([a-zA-Z]+)\}/g;
+/**
+ * Fill `{token}` placeholders. The template is split on " · "; a segment is dropped when any of its tokens is empty,
+ * so optional information disappears together with its label. Unknown tokens render as empty (and drop their segment).
+ */
+export function renderTemplate(template, tokens) {
+    const segments = [];
+    for (const segment of template.split(SEPARATOR)) {
+        let missing = false;
+        const rendered = segment.replace(TOKEN, (_match, name) => {
+            const value = tokens[name];
+            if (value === undefined || value === "")
+                missing = true;
+            return value ?? "";
+        });
+        if (!missing && rendered.trim())
+            segments.push(rendered.trim());
+    }
+    return segments.join(SEPARATOR);
+}
+const fixed = (value, digits = 2) => (value === undefined ? undefined : value.toFixed(digits));
+const time = (at) => new Date(at).toTimeString().slice(0, 8);
+export function actionTokens(verdict, at = Date.now()) {
+    const flags = [
+        verdict.approvedByUser ? "user approved" : undefined,
+        verdict.source === "error" ? "typesafe error" : undefined,
+        verdict.source === "read-only" ? "read-only" : undefined,
+    ].filter(Boolean).join(", ");
+    return {
+        guard: "action",
+        time: time(at),
+        tool: verdict.summary.tool,
+        level: verdict.level,
+        source: verdict.source,
+        irreversible: fixed(verdict.judgment?.irreversible),
+        offTask: fixed(verdict.judgment?.offTask),
+        scope: verdict.judgment?.scope.replace(/_/g, " "),
+        approved: fixed(verdict.judgment?.approved),
+        slop: verdict.slopSymptoms?.length ? verdict.slopSymptoms.map(symptom => `${symptom} ${verdict.slop[symptom].toFixed(2)}`).join(", ") : verdict.slop ? "none" : undefined,
+        slopStub: fixed(verdict.slop?.stub),
+        slopComments: fixed(verdict.slop?.comments),
+        slopDead: fixed(verdict.slop?.dead),
+        slopHedging: fixed(verdict.slop?.hedging),
+        patterns: verdict.patterns.length ? verdict.patterns.map(hit => hit.id).join(", ") : undefined,
+        reasons: verdict.reasons.length ? verdict.reasons.join("; ") : undefined,
+        path: verdict.summary.path,
+        model: verdict.judgment?.model,
+        ms: verdict.judgment ? String(verdict.judgment.elapsedMs) : undefined,
+        flags: flags || undefined,
+    };
+}
+export function stuckTokens(verdict, at = Date.now()) {
+    const flags = [
+        verdict.source === "repeat" && verdict.stuck ? "exact repeat" : undefined,
+        verdict.source === "error" ? "typesafe error" : undefined,
+    ].filter(Boolean).join(", ");
+    return {
+        guard: "stuck",
+        time: time(at),
+        failures: String(verdict.failures),
+        sameStrategy: fixed(verdict.judgment?.sameStrategy),
+        approachChange: verdict.judgment ? `${verdict.judgment.approachChange.toFixed(1)}/2` : undefined,
+        progress: fixed(verdict.judgment?.progress),
+        status: verdict.stuck ? "stuck" : "ok",
+        source: verdict.source,
+        reasons: verdict.reasons.length ? verdict.reasons.join("; ") : undefined,
+        model: verdict.judgment?.model,
+        ms: verdict.judgment ? String(verdict.judgment.elapsedMs) : undefined,
+        flags: flags || undefined,
+    };
+}
+export function doneTokens(verdict, at = Date.now()) {
+    return {
+        guard: "done",
+        time: time(at),
+        changes: String(verdict.evidence.mutations),
+        checks: String(verdict.evidence.checks.length),
+        checksPassed: String(verdict.evidence.checks.filter(check => check.passed).length),
+        claimsDone: fixed(verdict.judgment?.claimsDone),
+        claimsVerified: fixed(verdict.judgment?.claimsVerified),
+        checksApply: fixed(verdict.judgment?.verificationApplies),
+        outcome: verdict.judgment?.outcome,
+        status: verdict.falseClaim ? "false claim" : verdict.unverified ? "unverified" : "ok",
+        reasons: verdict.reasons.length ? verdict.reasons.join("; ") : undefined,
+        model: verdict.judgment?.model,
+        ms: verdict.judgment ? String(verdict.judgment.elapsedMs) : undefined,
+        flags: verdict.error ? "typesafe error" : undefined,
+    };
+}
+export function proseTokens(verdict, at = Date.now()) {
+    return {
+        guard: "prose",
+        time: time(at),
+        wordy: fixed(verdict.scores?.wordy),
+        cliches: fixed(verdict.scores?.cliches),
+        jargon: fixed(verdict.scores?.jargon),
+        status: verdict.nudged ? "nudged" : verdict.flagged.length ? verdict.flagged.join(", ") : "ok",
+        reasons: verdict.flagged.length ? verdict.flagged.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 = {
+    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"],
+    done: ["changes", "checks", "checksPassed", "claimsDone", "claimsVerified", "checksApply", "outcome", "status", "reasons", "model", "ms", "flags", "time", "guard"],
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-warden",
-  "version": "0.2.1",
+  "version": "0.4.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.",
   "type": "module",
   "license": "MIT",