@gobing-ai/spur 0.3.98 → 0.4.0

package/plugins/sp/hooks/hooks.json

@@ -1,5 +1,5 @@
 {
-    "description": "Spur (sp) plugin hooks — task corpus write protection + indexed-context token-ledger tracking.",
+    "description": "Spur (sp) plugin hooks — task corpus write protection + indexed-context token-ledger tracking + fleet lifecycle reporting.",
     "hooks": {
         "PreToolUse": [
             {
@@ -32,6 +32,50 @@
                         "type": "command",
                         "command": "superskill hook run sp context-session-start",
                         "timeout": 15
+                    },
+                    {
+                        "type": "command",
+                        "command": "superskill hook run sp agent-lifecycle",
+                        "timeout": 5
+                    }
+                ]
+            }
+        ],
+        "UserPromptSubmit": [
+            {
+                "hooks": [
+                    {
+                        "type": "command",
+                        "command": "superskill hook run sp agent-lifecycle",
+                        "timeout": 5
+                    }
+                ]
+            }
+        ],
+        "Notification": [
+            {
+                "matcher": "permission_prompt",
+                "hooks": [
+                    {
+                        "type": "command",
+                        "command": "superskill hook run sp agent-lifecycle",
+                        "timeout": 5
+                    }
+                ]
+            }
+        ],
+        "Stop": [
+            {
+                "hooks": [
+                    {
+                        "type": "command",
+                        "command": "superskill hook run sp agent-lifecycle",
+                        "timeout": 5
+                    },
+                    {
+                        "type": "command",
+                        "command": "superskill hook run sp fleet-guest-stop",
+                        "timeout": 10
                     }
                 ]
             }

package/plugins/sp/hooks/pi/guard-extension.ts

@@ -10,6 +10,7 @@
  *   - context-post-tool (tool_result → shared recordToolUseEvent)
  *   - context-session-start (session_start → shared recordSessionStart)
  *   - context-session-stop  (session_shutdown → shared recordSessionEnd)
+ *   - agent-lifecycle       (agent_start/agent_settled → shared reportLifecycleHook, G73 R4)
  *
  * The ledger and session cores are shared with the Claude hooks (task 0969): this
  * extension only normalizes Pi event shapes and adapts them to those cores.
@@ -27,6 +28,7 @@ import { homedir } from 'node:os';
 import { isAbsolute, join, resolve } from 'node:path';
 import type { ExtensionAPI } from '@earendil-works/pi-coding-agent';
 import { getEnvVar, getEnvVars } from '../../lib/env';
+import { reportLifecycleHook } from '../agent-lifecycle';
 import { recordToolUseEvent, type ToolPayload } from '../context-post-tool';
 import { recordSessionStart } from '../context-session-start';
 import { recordSessionEnd } from '../context-session-stop';
@@ -266,4 +268,23 @@ export default function (pi: ExtensionAPI): void {
             // fail-open
         }
     });
+
+    // ── agent-lifecycle: fleet lifecycle reporting (G73 R4, task 1080) ──
+    // Pi has no native `blocked` signal (herdr finding P2), so only working/idle are
+    // reported here; a no-op outside a fleet, like every other hook path.
+    pi.on('agent_start', async () => {
+        try {
+            reportLifecycleHook({ hook_event_name: 'agent_start' });
+        } catch {
+            // fail-open
+        }
+    });
+
+    pi.on('agent_settled', async () => {
+        try {
+            reportLifecycleHook({ hook_event_name: 'agent_settled' });
+        } catch {
+            // fail-open
+        }
+    });
 }

package/plugins/sp/lib/history-anatomy.generated.mjs

@@ -261,6 +261,7 @@ var FINDING_CATEGORIES = [
   "telemetry",
   "positive"
 ];
+var FINDING_CONFIDENCES = ["high", "medium", "low"];
 function checkReportStructure(reportMarkdown) {
   const problems = [];
   if (/TODO|PLACEHOLDER|FIXME|^\|\s*\|/im.test(reportMarkdown))
@@ -305,6 +306,10 @@ function checkReportStructure(reportMarkdown) {
       if (!/(^|[\s`])P[123]([\s`.]|$)/.test(block) && !block.includes("symbolic-severity")) {
         problems.push("finding-invalid-severity");
       }
+      const confValue = block.match(/`confidence`\s*[:=]\s*`?([^`\n]*?)`?\s*(?:\n|$)/)?.[1]?.trim();
+      if (confValue !== undefined && confValue !== "" && !FINDING_CONFIDENCES.includes(confValue.toLowerCase())) {
+        problems.push(`finding-invalid-confidence:${confValue}`);
+      }
       const catValue = block.match(/`category`\s*[:=]\s*`?([^`\n]+?)`?\s*(?:\n|$)/)?.[1];
       if (catValue && !FINDING_CATEGORIES.includes(catValue.trim())) {
         problems.push(`finding-invalid-category:${catValue.trim()}`);