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

package/README.md

@@ -201,7 +201,7 @@ No external watchdog plugin needed.
 /glla                                # open the settings UI
 /glla model=provider/id              # auditor model override → GLOBAL
 /glla thinking=high                  # auditor thinking → GLOBAL
-/glla notify='cmd "$1"'              # push on complete/pause/stop → GLOBAL
+/glla notify='cmd "$1"'              # custom push cmd · unset = auto-detect (notify-send/osascript) · off = silent → GLOBAL
 /glla tokenlimit=10000000            # per-goal token budget (default: off) → GLOBAL
 /glla tokenlimit=0                   # explicitly no cap (the default)
 /glla wedgealert=30                  # hung-command alert minutes (default: 30, 0 = off)
@@ -233,15 +233,14 @@ activates the moment the agent proposes it, with a notification and a
 `draft_autoaccepted` ledger entry (auto-accept is never silent). The seed
 carries the intent. Pair with `autoresume=on` for fully unattended rigs.
 
-## Subagents (`@tintinweb/pi-subagents`)
+## Subagents
 
-Subagent sessions bind extensions too, so glla loads there — by design the
-**main session owns the goal/loop/list; subagents are workers** (v0.23.8):
+glla's guarantees here come from glla itself (session-handle
+discrimination), not from any specific subagent plugin — any Agent-tool
+provider gets them. Subagent sessions bind extensions too, so glla loads
+there — by design the **main session owns the goal/loop/list; subagents
+are workers** (v0.23.8):
 
-- Read-only agents (Explore, Plan) get no glla tools (pi-subagents gates
-  them); general-purpose agents see them but state-mutating calls
-  (`complete_goal`, `propose_*`, `list_add`, `pause_goal`, …) are refused
-  with "report back to the main agent".
 - A subagent session never clobbers the loop's session handle, never runs
   the restore gate, and never drives continuation — so the heartbeat,
   wedge alert, and auto-resume machinery always act on the main session.
@@ -249,6 +248,11 @@ Subagent sessions bind extensions too, so glla loads there — by design the
   is the discriminator.)
 - Subagent tool activity counts as activity for the wedge clock — a long
   subagent run is work, not a hang.
+- With `@tintinweb/pi-subagents` specifically (the one we test against):
+  read-only agents (Explore, Plan) get no glla tools; general-purpose
+  agents see them but state-mutating calls (`complete_goal`, `propose_*`,
+  `list_add`, `pause_goal`, …) are refused with "report back to the main
+  agent".
 
 ## Token guard
 
@@ -287,17 +291,25 @@ contradictory turns. One driver at a time:
   fine to keep, never run a ralph loop while a goal/list/loop is active.
 
 **Goes well with it**: `@juicesharp/rpiv-ask-user-question` (drafting uses its
-structured forms), `@tintinweb/pi-subagents` (spawn research/review subagents
-inside goal work), `@tintinweb/pi-tasks` (session-wide DAGs vs our goal-scoped
-task lists — different granularity), `pi-chrome` (the research/search path for
-goals — logged-in browsing with no extra services; standalone search skills
-like `mmx-cli`/`pi-search-skill` are optional conveniences for bulk queries,
-not requirements).
+structured forms), any subagent provider — e.g. `@tintinweb/pi-subagents` —
+(spawn research/review subagents inside goal work), `pi-chrome` (the
+research/search path for goals — logged-in browsing with no extra services;
+standalone search skills like `mmx-cli`/`pi-search-skill` are optional
+conveniences for bulk queries, not requirements).
+
+**Overlaps — pick one**: `@tintinweb/pi-tasks` is a second task list next to
+`/list`, and in practice the glla list *is* the task list (queue, statuses,
+per-item audit trail) while the todos end up the weaker copy. We ran both
+and removed pi-tasks. If you truly need session-wide dependency DAGs beyond
+one ordered queue, it exists — but installing both is not the ideal combo.
 
 **Two footnotes**: (1) extension-registered providers work in the main session
 but not the auditor's extension-less session — if audits fail auth, set the
-override once with `/glla model=`. (2) `pi-notify-agent` notifies on every turn;
-`/glla notify=` fires only on goal complete/pause/loop stop.
+override once with `/glla model=`. (2) `pi-notify-agent` notifies on every
+turn; glla pushes fire only where there is something to DO (pauses, verdicts,
+storms, wedge) and work out of the box — with no `notify=` configured glla
+auto-detects `notify-send`/`osascript`; `notify=off` silences, `notify='<cmd>'`
+customizes.
 
 ## Files
 

package/extensions/loops/goal.ts

@@ -1932,15 +1932,44 @@ function addSingleItem(ctx: ExtensionContext, raw: string): void {
 }
 
 /**
- * Config-gated push notification: if settings.notifyCmd is set, shell out
- * with the message as $1. Fire-and-forget — a broken notify command never
- * blocks the loop. /glla notify='<cmd>' to configure.
+ * Push notification, folded IN by default (v0.28.34 — user: "leaving it to
+ * the user to set up sucks, cause then they won't have it"). Resolution:
+ *   notifyCmd === "off"   → silent (explicit opt-out)
+ *   notifyCmd set         → that command, message passed as $1
+ *   notifyCmd unset       → auto-detect ONCE per session: notify-send
+ *                           (Linux) or osascript (macOS); none → silent.
+ * Pushes fire only where there is something to DO — pauses, auditor
+ * verdicts, storms, wedge, persistence degradation — never per-turn noise.
+ * Fire-and-forget: a broken notifier never blocks the loop.
  */
+let autoNotifyCmd: string | null | undefined; // undefined = not probed yet
+
+function probeAutoNotify(ctx: ExtensionContext): void {
+  if (autoNotifyCmd !== undefined || !extensionApi) return;
+  autoNotifyCmd = null; // probing sentinel — drops at most the first push
+  void extensionApi
+    .exec("bash", ["-c", "command -v notify-send || command -v osascript || true"], { cwd: ctx.cwd })
+    .then((r) => {
+      const found = String((r as { stdout?: string }).stdout ?? "").trim();
+      if (found.endsWith("notify-send")) autoNotifyCmd = `notify-send "pi-goal-list-loop-audit" "$1"`;
+      // env-var handoff: the message never touches AppleScript quoting.
+      else if (found.endsWith("osascript")) autoNotifyCmd = `GLLA_MSG="$1" osascript -e 'display notification (system attribute "GLLA_MSG") with title "pi-goal-list-loop-audit"'`;
+      else autoNotifyCmd = null;
+    })
+    .catch(() => {
+      autoNotifyCmd = null;
+    });
+}
+
 function notifyExternal(ctx: ExtensionContext, message: string): void {
   try {
     const settings = loadSettings(ctx.cwd);
-    const cmd = settings.notifyCmd;
-    if (!cmd || !extensionApi) return;
+    if (settings.notifyCmd === "off" || !extensionApi) return;
+    const cmd = settings.notifyCmd ?? autoNotifyCmd;
+    if (!cmd) {
+      if (settings.notifyCmd === undefined && autoNotifyCmd === undefined) probeAutoNotify(ctx);
+      return;
+    }
     void extensionApi.exec("bash", ["-c", cmd, "pi-goal-list-loop-audit", message], { cwd: ctx.cwd }).catch(() => {});
   } catch {
     // non-fatal by design
@@ -3892,7 +3921,7 @@ export async function handleSettingChoice(id: string, ctx: ExtensionContext): Pr
       // current effective subagent models. Treat as no-op.
       return;
     case "notifyCmd": {
-      const v = await ctx.ui.input("Notify command — the event message is passed as $1", "e.g. a desktop-notification or push command; empty = off");
+      const v = await ctx.ui.input("Notify command — the event message is passed as $1", "custom command · empty = auto-detect (notify-send/osascript) · 'off' = silent");
       if (v !== undefined) saveSettings("global", ctx.cwd, { notifyCmd: v.trim() || undefined });
       return;
     }

package/extensions/settings-menu.ts

@@ -323,9 +323,9 @@ export function buildSettingsRows(
       id: "notifyCmd",
       section: "other",
       label: "Notify command",
-      valueText: show("notifyCmd", "off"),
+      valueText: show("notifyCmd", "auto"),
       sourceText: src("notifyCmd"),
-      description: "desktop push command; the event message is passed as $1",
+      description: "custom command ($1 = message) · unset = auto-detect notify-send/osascript · 'off' = silent",
     },
     {
       id: "tokenLimit",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-goal-list-loop-audit",
-  "version": "0.28.33",
+  "version": "0.28.34",
   "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",