pi-goal-list-loop-audit 0.28.34 → 0.29.0

package/README.md

@@ -66,6 +66,7 @@ matches `/list show`.
 /loop                              # draft the loop (agent grills; measure is test-run before you confirm)
 /loop start "keep polishing the UI"                          # infinite metricless loop (v0.23.6): no plateau, no cap — ends at time=/tokens= or /loop stop
 /loop respec                                                  # infinite metricless loop reconciling the codebase against the root SPEC.md / spec.md (v0.24.3) — 2 specs = you pick, 0 specs = drafting, 1 spec = auto-start (v0.24.4)
+/loop audit                                                    # project-audit loop (v0.29.0): each iteration audits fresh, appends findings to .pi-glla/audit-loop/findings.md, fixes the top ones — the orchestrator counts open findings and the plateau stop ends it when the well is dry
 /loop start "reduce TODOs" measure="grep -c TODO src.txt | head -1" direction=min
 /loop start "shrink the bundle" measure="..." direction=min time=4 tokens=500000   # arbitrary bounds
 /loop start "reduce TODOs" measure="..." direction=min branch=1   # scratch-branch mode

package/extensions/goal-loop-forever.ts

@@ -389,3 +389,36 @@ export function resolveSpecFile(cwd: string): string | null {
 export function respecTarget(specName: string): string {
   return `Reconcile the codebase against ${specName} (the project spec in the root). Read the spec critically first: if a requirement is stale, contradictory, or wrong for the current codebase, report the discrepancy and move on — never force the code to match a bad spec. Otherwise pick the next gap between spec and code and close it. Rotate: one iteration implements a missing or outdated spec item, the next audits something already "implemented" against the spec and fixes what drifted.`;
 }
+
+// ---- /loop audit (v0.29.0) ----
+
+/**
+ * The audit loop's findings file — checkbox lines, append-only. The agent
+ * appends new findings and checks off fixed ones; the ORCHESTRATOR counts
+ * open boxes every iteration. The agent never self-reports progress.
+ */
+export const AUDIT_FINDINGS_REL = ".pi-glla/audit-loop/findings.md";
+
+/**
+ * The audit-loop measure command: count open findings. Prints exactly one
+ * number in every file state (missing file / zero matches → 0). This is
+ * what respec (metricless) and the reviewer cascade (no termination) both
+ * lacked: an honest metric the plateau stop can believe — audits that stop
+ * surfacing new findings = the well is dry = the loop ends.
+ */
+export function auditMeasureCmd(): string {
+  return `c=$(grep -cE '^- \\[ \\]' ${AUDIT_FINDINGS_REL} 2>/dev/null); echo \${c:-0}`;
+}
+
+/**
+ * The audit target. User's design (2026-07-29): "the looper running audits
+ * to see where to progress and what to fix" — the thing that fires at the
+ * end of goals and lists, finds the next batch of work, and works it.
+ * Each iteration: fresh audit pass → append NEW findings → fix the top
+ * open ones → check them off with the fix commit. Honesty laws: never
+ * fabricate findings, never rewrite the file's history, never check a box
+ * without the fix commit existing.
+ */
+export function auditTarget(): string {
+  return `Audit the project for real problems and fix them, iteration by iteration. Every iteration: (1) run a FRESH audit pass over the codebase — spawn Explore subagents for breadth — hunting real issues: bugs, broken flows, regressions, drift between docs and code, dead code, security holes. Not style nits, not speculative refactors. (2) Append every NEW finding as one checkbox line "- [ ] SEVERITY: short description (file:line)" to ${AUDIT_FINDINGS_REL} (create the file on the first finding; append-only — never delete, rewrite, or reorder existing lines; never re-report a finding already listed). (3) Fix the highest-severity OPEN finding(s) — real fixes, committed — then check the box: "- [x] … — fixed in <commit>". (4) Honesty law: never fabricate findings to look busy; never mark a finding fixed without the fix commit existing. When a full audit pass surfaces nothing new AND no open findings remain, say so plainly — the orchestrator counts open findings every iteration and the plateau stop ends the loop when the well is dry.`;
+}

package/extensions/loops/goal.ts

@@ -161,6 +161,8 @@ import {
   LOOP_DEFAULTS,
   resolveSpecFiles,
   respecTarget,
+  auditMeasureCmd,
+  auditTarget,
   HELD_ON_RESTORE,
   type LoopState,
 } from "../goal-loop-forever.js";
@@ -978,7 +980,12 @@ function archiveCurrentGoal(ctx: ExtensionContext, status: Status, stopReason?:
   if (goal.policy === "list" && status === "complete") {
     const advanced = activateNextListItem(ctx);
     // v0.26.0: the queue just EMPTIED on a completion → list-complete.
-    if (!advanced) fireReviewer(ctx, { kind: "list", goalId: goal.id, objective: goal.objective, terminal: "goal-complete" });
+    if (!advanced) {
+      fireReviewer(ctx, { kind: "list", goalId: goal.id, objective: goal.objective, terminal: "goal-complete" });
+      // v0.29.0: the well ran dry — point at the project-audit loop. A
+      // suggestion, not an action: consent, never auto-start (v0.28.28).
+      ctx.ui.notify("List complete. /loop audit to sweep the project for the next batch of work.", "info");
+    }
     return;
   }
   // v0.26.0: a /goal (non-list) reached a terminal state → maybe fire.
@@ -2510,6 +2517,34 @@ async function cmdLoop(args: string, ctx: ExtensionContext): Promise<void> {
     return;
   }
 
+  if (sub === "audit") {
+    // v0.29.0: the project-audit loop (user design: "the looper running
+    // audits to see where to progress and what to fix — the thing that
+    // fires at the end of goals and lists"). Unlike respec this is a
+    // METRIC loop: the orchestrator counts open findings every iteration,
+    // direction=min, and the plateau stop is the termination — audits that
+    // stop surfacing new findings = the well is dry. User typed the
+    // command = the act (same auto-start rule as respec).
+    if (state.goal && state.goal.status === "active") {
+      ctx.ui.notify("A goal is active — /goal cancel or /goal pause it before starting a loop.", "warning");
+      return;
+    }
+    if (isLoopActive()) {
+      ctx.ui.notify("A loop is already active. /loop stop first.", "warning");
+      return;
+    }
+    await startLoopFromConfig(ctx, {
+      target: auditTarget(),
+      measureCmd: auditMeasureCmd(),
+      direction: "min",
+      plateauWindow: LOOP_DEFAULTS.plateauWindow,
+      maxIterations: 0,
+      branch: false,
+      force: false,
+    });
+    return;
+  }
+
   if (sub === "respec") {
     // v0.24.3: reconcile the codebase against the root spec, forever.
     // Same auto-start path as /loop start (the user typed the command —
@@ -4850,6 +4885,7 @@ export default function (pi: ExtensionAPI): void {
     getArgumentCompletions: completions([
       ["start", "skip drafting: /loop start \"<target>\" measure=\"<cmd>\" direction=min|max [window=5] [max=50]"],
       ["respec", "infinite metricless loop reconciling the codebase against the root SPEC.md"],
+      ["audit", "project-audit loop: each iteration audits fresh, appends findings, fixes the top ones — plateau stops when the well is dry (v0.29.0)"],
       ["status", "show metric, iteration, best/last values, stall count"],
       ["stop", "end the loop (keeps the best state)"],
       ["cancel", "alias of /loop stop — end the loop"],

package/extensions/reviewer.ts

@@ -40,7 +40,7 @@ export const DEFAULT_REVIEWER_CONFIG: ReviewerConfig = {
   mode: "on",
   fireOn: ["goal-complete", "list-complete"],
   doNotFireOn: ["goal-aborted", "goal-paused"],
-  cascade: ["convert-findings-to-list", "queue-leftovers", "fire-audit-on-clean", "notify-and-idle"],
+  cascade: ["convert-findings-to-list", "queue-leftovers", "notify-and-idle"],
   auditCadence: "every-clean-completion",
   auditScope: "regression-scan",
   leverageMode: "fix-without-confirm",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-goal-list-loop-audit",
-  "version": "0.28.34",
+  "version": "0.29.0",
   "description": "Goal. Loop. Audit. Done. \u2014 a pi-coding-agent extension that supervises long-running work, with isolated auditor on each completion. Beat bamboozling by design: the auditor runs in a fresh session with no extensions, no skills, no editor \u2014 only the read tools needed to verify your goal.",
   "license": "MIT",
   "author": "dracon",