@jmylchreest/aide-plugin 0.1.0 → 0.1.2

package/src/hooks/hud-updater.ts

@@ -9,10 +9,14 @@
  */
 
 import { Logger, debug } from "../lib/logger.js";
-import { readStdin } from "../lib/hook-utils.js";
+import {
+  readStdin,
+  emitHookResult,
+  installHookSafetyNet,
+  findAideBinary,
+} from "../lib/hook-utils.js";
 
 const SOURCE = "hud-updater";
-import { findAideBinary } from "../core/aide-client.js";
 import { updateToolStats } from "../core/tool-tracking.js";
 import { storePartialMemory } from "../core/partial-memory.js";
 import {
@@ -49,7 +53,7 @@ async function main(): Promise<void> {
   try {
     const input = await readStdin();
     if (!input.trim()) {
-      console.log(JSON.stringify({ continue: true }));
+      emitHookResult({ continue: true });
       return;
     }
 
@@ -69,11 +73,7 @@ async function main(): Promise<void> {
     // Update session state (per-agent tracking) — delegates to core
     if (toolName) {
       log.start("updateSessionState");
-      const binary = findAideBinary({
-        cwd,
-        pluginRoot:
-          process.env.AIDE_PLUGIN_ROOT || process.env.CLAUDE_PLUGIN_ROOT,
-      });
+      const binary = findAideBinary(cwd);
       if (binary) {
         updateToolStats(binary, cwd, toolName, agentId);
 
@@ -86,7 +86,6 @@ async function main(): Promise<void> {
           description: data.tool_input?.description,
           success: data.tool_result?.success,
         });
-
       }
       log.end("updateSessionState");
     }
@@ -125,33 +124,16 @@ async function main(): Promise<void> {
     log.flush();
 
     // Always continue
-    console.log(JSON.stringify({ continue: true }));
+    emitHookResult({ continue: true });
   } catch (error) {
     if (log) {
       log.error("HUD update failed", error);
       log.flush();
     }
-    console.log(JSON.stringify({ continue: true }));
+    emitHookResult({ continue: true });
   }
 }
 
-process.on("uncaughtException", (err) => {
-  debug(SOURCE, `UNCAUGHT EXCEPTION: ${err}`);
-  try {
-    console.log(JSON.stringify({ continue: true }));
-  } catch {
-    console.log('{"continue":true}');
-  }
-  process.exit(0);
-});
-process.on("unhandledRejection", (reason) => {
-  debug(SOURCE, `UNHANDLED REJECTION: ${reason}`);
-  try {
-    console.log(JSON.stringify({ continue: true }));
-  } catch {
-    console.log('{"continue":true}');
-  }
-  process.exit(0);
-});
+installHookSafetyNet(SOURCE);
 
 main();

package/src/hooks/permission-handler.ts

@@ -20,7 +20,13 @@
  * - { continue: true } to show normal permission prompt
  */
 
-import { readStdin, findAideBinary, runAide } from "../lib/hook-utils.js";
+import {
+  readStdin,
+  findAideBinary,
+  runAide,
+  emitHookResult,
+  installHookSafetyNet,
+} from "../lib/hook-utils.js";
 import { sanitizeForLog } from "../core/aide-client.js";
 import { debug } from "../lib/logger.js";
 
@@ -106,7 +112,7 @@ async function main(): Promise<void> {
   try {
     const input = await readStdin();
     if (!input.trim()) {
-      console.log(JSON.stringify({ continue: true }));
+      emitHookResult({ continue: true });
       return;
     }
 
@@ -114,7 +120,7 @@ async function main(): Promise<void> {
 
     // Only handle Bash permissions
     if (data.tool_name !== "Bash" || !data.tool_input?.command) {
-      console.log(JSON.stringify({ continue: true }));
+      emitHookResult({ continue: true });
       return;
     }
 
@@ -129,7 +135,7 @@ async function main(): Promise<void> {
         reason:
           "This command has been blocked for safety. It matches a dangerous pattern.",
       };
-      console.log(JSON.stringify(response));
+      emitHookResult(response);
       return;
     }
 
@@ -139,35 +145,18 @@ async function main(): Promise<void> {
       const response: PermissionResponse = {
         allow: true,
       };
-      console.log(JSON.stringify(response));
+      emitHookResult(response);
       return;
     }
 
     // Default: show normal permission prompt
-    console.log(JSON.stringify({ continue: true }));
+    emitHookResult({ continue: true });
   } catch (error) {
     debug(SOURCE, `Hook error: ${error}`);
-    console.log(JSON.stringify({ continue: true }));
+    emitHookResult({ continue: true });
   }
 }
 
-process.on("uncaughtException", (err) => {
-  debug(SOURCE, `UNCAUGHT EXCEPTION: ${err}`);
-  try {
-    console.log(JSON.stringify({ continue: true }));
-  } catch {
-    console.log('{"continue":true}');
-  }
-  process.exit(0);
-});
-process.on("unhandledRejection", (reason) => {
-  debug(SOURCE, `UNHANDLED REJECTION: ${reason}`);
-  try {
-    console.log(JSON.stringify({ continue: true }));
-  } catch {
-    console.log('{"continue":true}');
-  }
-  process.exit(0);
-});
+installHookSafetyNet(SOURCE);
 
 main();

package/src/hooks/persistence.ts

@@ -6,8 +6,12 @@
  * Checks for active modes (autopilot) via aide-memory state.
  */
 
-import { readStdin } from "../lib/hook-utils.js";
-import { findAideBinary } from "../core/aide-client.js";
+import {
+  readStdin,
+  emitHookResult,
+  installHookSafetyNet,
+  findAideBinary,
+} from "../lib/hook-utils.js";
 import { checkPersistence } from "../core/persistence-logic.js";
 import { debug } from "../lib/logger.js";
 
@@ -31,7 +35,7 @@ async function main(): Promise<void> {
   try {
     const input = await readStdin();
     if (!input.trim()) {
-      console.log(JSON.stringify({}));
+      emitHookResult({});
       return;
     }
 
@@ -39,23 +43,19 @@ async function main(): Promise<void> {
     const cwd = data.cwd || process.cwd();
 
     if (data.stop_hook_active) {
-      console.log(JSON.stringify({}));
+      emitHookResult({});
       return;
     }
 
-    const binary = findAideBinary({
-      cwd,
-      pluginRoot:
-        process.env.AIDE_PLUGIN_ROOT || process.env.CLAUDE_PLUGIN_ROOT,
-    });
+    const binary = findAideBinary(cwd);
     if (!binary) {
-      console.log(JSON.stringify({}));
+      emitHookResult({});
       return;
     }
 
     const result = checkPersistence(binary, cwd, data.session_id);
     if (!result) {
-      console.log(JSON.stringify({}));
+      emitHookResult({});
       return;
     }
 
@@ -64,30 +64,14 @@ async function main(): Promise<void> {
       reason: result.reason,
     };
 
-    console.log(JSON.stringify(output));
+    emitHookResult(output);
   } catch (err) {
     debug(SOURCE, `Hook error: ${err}`);
-    console.log(JSON.stringify({}));
+    emitHookResult({});
   }
 }
 
-process.on("uncaughtException", (err) => {
-  debug(SOURCE, `UNCAUGHT EXCEPTION: ${err}`);
-  try {
-    console.log(JSON.stringify({}));
-  } catch {
-    console.log("{}");
-  }
-  process.exit(0);
-});
-process.on("unhandledRejection", (reason) => {
-  debug(SOURCE, `UNHANDLED REJECTION: ${reason}`);
-  try {
-    console.log(JSON.stringify({}));
-  } catch {
-    console.log("{}");
-  }
-  process.exit(0);
-});
+// This Stop hook emits {} (not {continue:true}) as its neutral result.
+installHookSafetyNet(SOURCE, {});
 
 main();

package/src/hooks/pre-compact.ts

@@ -10,8 +10,12 @@
  * - summary_prompt (the prompt used for summarization)
  */
 
-import { readStdin } from "../lib/hook-utils.js";
-import { findAideBinary } from "../core/aide-client.js";
+import {
+  readStdin,
+  emitHookResult,
+  installHookSafetyNet,
+  findAideBinary,
+} from "../lib/hook-utils.js";
 import { saveStateSnapshot as coreSaveStateSnapshot } from "../core/pre-compact-logic.js";
 import {
   buildSessionSummaryFromState,
@@ -22,7 +26,13 @@ import {
   gatherPartials,
   buildSummaryFromPartials,
 } from "../core/partial-memory.js";
+import {
+  buildSessionCheckpoint,
+  getTaskTree,
+  getGitLiveState,
+} from "../core/session-checkpoint-logic.js";
 import { debug } from "../lib/logger.js";
+import { recordObserveEvent } from "../core/read-tracking.js";
 
 const SOURCE = "pre-compact";
 
@@ -37,7 +47,7 @@ async function main(): Promise<void> {
   try {
     const input = await readStdin();
     if (!input.trim()) {
-      console.log(JSON.stringify({ continue: true }));
+      emitHookResult();
       return;
     }
 
@@ -46,12 +56,18 @@ async function main(): Promise<void> {
     const sessionId = data.session_id || "unknown";
 
     // Save state snapshot before compaction — delegates to core
-    const binary = findAideBinary({
-      cwd,
-      pluginRoot:
-        process.env.AIDE_PLUGIN_ROOT || process.env.CLAUDE_PLUGIN_ROOT,
-    });
+    const binary = findAideBinary(cwd);
     if (binary) {
+      // Emit a lifecycle trigger so PreCompact is traceable in the dashboard,
+      // symmetric with session-start and subagent-start/stop.
+      recordObserveEvent(binary, cwd, {
+        kind: "session",
+        name: "pre-compact",
+        category: "lifecycle",
+        subtype: (data as { trigger?: string }).trigger || "compact",
+        session: sessionId,
+      });
+
       coreSaveStateSnapshot(binary, cwd, sessionId);
 
       // Persist a session summary as a memory before context is compacted.
@@ -59,16 +75,33 @@ async function main(): Promise<void> {
       // Uses partials (if available) for a richer summary, falling back to git-only.
       try {
         const partials = gatherPartials(binary, cwd, sessionId);
+        const commits = getSessionCommits(cwd);
         let summary: string | null = null;
+        // `checkpoint` tag marks the richest, structured snapshot so the
+        // session-start resume path can find it; `partial` keeps it out of
+        // normal recall and lets the session-end summary supersede it.
+        let tags = `partial,session-summary,session:${sessionId}`;
 
         if (partials.length > 0) {
-          // Build from partials + git data
-          const commits = getSessionCommits(cwd);
-          summary = buildSummaryFromPartials(partials, commits, []);
-          debug(
-            SOURCE,
-            `Built pre-compact summary from ${partials.length} partials`,
-          );
+          // Structured checkpoint: pulls task tree + live git state from aide's
+          // own stores in addition to the partial roll-up. No LLM needed.
+          summary = buildSessionCheckpoint({
+            sessionId,
+            partials,
+            commits,
+            taskTree: getTaskTree(binary, cwd),
+            liveState: getGitLiveState(cwd),
+          });
+          if (summary) {
+            tags = `partial,checkpoint,session-summary,session:${sessionId}`;
+            debug(
+              SOURCE,
+              `Built structured checkpoint from ${partials.length} partials`,
+            );
+          } else {
+            // Defensive: partials present but checkpoint empty — fall back.
+            summary = buildSummaryFromPartials(partials, commits, []);
+          }
         }
 
         // Fall back to state-only summary if no partials
@@ -77,8 +110,6 @@ async function main(): Promise<void> {
         }
 
         if (summary) {
-          // Tag as partial so the session-end summary supersedes it
-          const tags = `partial,session-summary,session:${sessionId}`;
           (await import("child_process")).execFileSync(
             binary,
             ["memory", "add", "--category=session", `--tags=${tags}`, summary],
@@ -86,7 +117,7 @@ async function main(): Promise<void> {
           );
           debug(
             SOURCE,
-            `Saved pre-compaction partial session summary for ${sessionId.slice(0, 8)}`,
+            `Saved pre-compaction checkpoint for ${sessionId.slice(0, 8)}`,
           );
         }
       } catch (err) {
@@ -98,30 +129,13 @@ async function main(): Promise<void> {
     }
 
     // Always allow compaction to continue
-    console.log(JSON.stringify({ continue: true }));
+    emitHookResult();
   } catch (error) {
     debug(SOURCE, `Hook error: ${error}`);
-    console.log(JSON.stringify({ continue: true }));
+    emitHookResult();
   }
 }
 
-process.on("uncaughtException", (err) => {
-  debug(SOURCE, `UNCAUGHT EXCEPTION: ${err}`);
-  try {
-    console.log(JSON.stringify({ continue: true }));
-  } catch {
-    console.log('{"continue":true}');
-  }
-  process.exit(0);
-});
-process.on("unhandledRejection", (reason) => {
-  debug(SOURCE, `UNHANDLED REJECTION: ${reason}`);
-  try {
-    console.log(JSON.stringify({ continue: true }));
-  } catch {
-    console.log('{"continue":true}');
-  }
-  process.exit(0);
-});
+installHookSafetyNet(SOURCE);
 
 main();

package/src/hooks/pre-tool-enforcer.ts

@@ -10,10 +10,15 @@
  * Core logic is in src/core/tool-enforcement.ts for cross-platform reuse.
  */
 
-import { readStdin } from "../lib/hook-utils.js";
+import {
+  readStdin,
+  emitHookResult,
+  installHookSafetyNet,
+  findAideBinary,
+} from "../lib/hook-utils.js";
 import { debug } from "../lib/logger.js";
 import { evaluateToolUse } from "../core/tool-enforcement.js";
-import { findAideBinary, getState } from "../core/aide-client.js";
+import { getState } from "../core/aide-client.js";
 import { emitInjectionEvent } from "../core/read-tracking.js";
 
 const SOURCE = "pre-tool-enforcer";
@@ -42,7 +47,7 @@ async function main(): Promise<void> {
   try {
     const input = await readStdin();
     if (!input.trim()) {
-      console.log(JSON.stringify({ continue: true }));
+      emitHookResult({ continue: true });
       return;
     }
 
@@ -56,11 +61,7 @@ async function main(): Promise<void> {
     let activeMode: string | null = null;
     let aideBinary: string | null = null;
     try {
-      aideBinary = findAideBinary({
-        cwd,
-        pluginRoot:
-          process.env.AIDE_PLUGIN_ROOT || process.env.CLAUDE_PLUGIN_ROOT,
-      });
+      aideBinary = findAideBinary(cwd);
       if (aideBinary) {
         activeMode = getState(aideBinary, cwd, "mode");
       }
@@ -79,7 +80,7 @@ async function main(): Promise<void> {
         continue: false,
         message: result.denyMessage,
       };
-      console.log(JSON.stringify(output));
+      emitHookResult(output);
       return;
     }
 
@@ -108,33 +109,16 @@ async function main(): Promise<void> {
           additionalContext: result.reminder,
         },
       };
-      console.log(JSON.stringify(output));
+      emitHookResult(output);
     } else {
-      console.log(JSON.stringify({ continue: true }));
+      emitHookResult({ continue: true });
     }
   } catch (error) {
     debug(SOURCE, `Hook error: ${error}`);
-    console.log(JSON.stringify({ continue: true }));
+    emitHookResult({ continue: true });
   }
 }
 
-process.on("uncaughtException", (err) => {
-  debug(SOURCE, `UNCAUGHT EXCEPTION: ${err}`);
-  try {
-    console.log(JSON.stringify({ continue: true }));
-  } catch {
-    console.log('{"continue":true}');
-  }
-  process.exit(0);
-});
-process.on("unhandledRejection", (reason) => {
-  debug(SOURCE, `UNHANDLED REJECTION: ${reason}`);
-  try {
-    console.log(JSON.stringify({ continue: true }));
-  } catch {
-    console.log('{"continue":true}');
-  }
-  process.exit(0);
-});
+installHookSafetyNet(SOURCE);
 
 main();

package/src/hooks/reflect.ts

@@ -9,8 +9,12 @@
  */
 
 import { execFileSync } from "child_process";
-import { readStdin } from "../lib/hook-utils.js";
-import { findAideBinary } from "../core/aide-client.js";
+import {
+  readStdin,
+  emitHookResult,
+  installHookSafetyNet,
+  findAideBinary,
+} from "../lib/hook-utils.js";
 import { debug } from "../lib/logger.js";
 
 const SOURCE = "reflect";
@@ -30,7 +34,7 @@ async function main(): Promise<void> {
 
     const input = await readStdin();
     if (!input.trim()) {
-      console.log(JSON.stringify({}));
+      emitHookResult({});
       return;
     }
 
@@ -38,13 +42,13 @@ async function main(): Promise<void> {
     const cwd = data.cwd || process.cwd();
     const sessionID = data.session_id;
     if (!sessionID) {
-      console.log(JSON.stringify({}));
+      emitHookResult({});
       return;
     }
 
-    const binary = findAideBinary({ cwd });
+    const binary = findAideBinary(cwd);
     if (!binary) {
-      console.log(JSON.stringify({}));
+      emitHookResult({});
       return;
     }
 
@@ -59,11 +63,14 @@ async function main(): Promise<void> {
       debug(SOURCE, `reflect run failed (non-fatal): ${err}`);
     }
 
-    console.log(JSON.stringify({}));
+    emitHookResult({});
   } catch (err) {
     debug(SOURCE, `error: ${err}`);
-    console.log(JSON.stringify({}));
+    emitHookResult({});
   }
 }
 
+// This Stop hook emits {} (not {continue:true}) as its neutral result.
+installHookSafetyNet(SOURCE, {});
+
 void main();

package/src/hooks/search-enrichment.ts

@@ -11,10 +11,14 @@
  * Core logic is in src/core/search-enrichment.ts for cross-platform reuse.
  */
 
-import { readStdin } from "../lib/hook-utils.js";
+import {
+  readStdin,
+  emitHookResult,
+  installHookSafetyNet,
+  findAideBinary,
+} from "../lib/hook-utils.js";
 import { debug } from "../lib/logger.js";
 import { checkSearchEnrichment } from "../core/search-enrichment.js";
-import { findAideBinary } from "../core/aide-client.js";
 import { emitInjectionEvent } from "../core/read-tracking.js";
 
 const SOURCE = "search-enrichment";
@@ -42,7 +46,7 @@ async function main(): Promise<void> {
   try {
     const input = await readStdin();
     if (!input.trim()) {
-      console.log(JSON.stringify({ continue: true }));
+      emitHookResult({ continue: true });
       return;
     }
 
@@ -52,11 +56,7 @@ async function main(): Promise<void> {
     const cwd = data.cwd || process.cwd();
     const sessionId = data.session_id || "";
 
-    const binary = findAideBinary({
-      cwd,
-      pluginRoot:
-        process.env.AIDE_PLUGIN_ROOT || process.env.CLAUDE_PLUGIN_ROOT,
-    });
+    const binary = findAideBinary(cwd);
 
     const result = checkSearchEnrichment(toolName, toolInput, cwd, binary);
 
@@ -87,33 +87,16 @@ async function main(): Promise<void> {
           additionalContext: result.enrichment,
         },
       };
-      console.log(JSON.stringify(output));
+      emitHookResult(output);
     } else {
-      console.log(JSON.stringify({ continue: true }));
+      emitHookResult({ continue: true });
     }
   } catch (error) {
     debug(SOURCE, `Hook error: ${error}`);
-    console.log(JSON.stringify({ continue: true }));
+    emitHookResult({ continue: true });
   }
 }
 
-process.on("uncaughtException", (err) => {
-  debug(SOURCE, `UNCAUGHT EXCEPTION: ${err}`);
-  try {
-    console.log(JSON.stringify({ continue: true }));
-  } catch {
-    console.log('{"continue":true}');
-  }
-  process.exit(0);
-});
-process.on("unhandledRejection", (reason) => {
-  debug(SOURCE, `UNHANDLED REJECTION: ${reason}`);
-  try {
-    console.log(JSON.stringify({ continue: true }));
-  } catch {
-    console.log('{"continue":true}');
-  }
-  process.exit(0);
-});
+installHookSafetyNet(SOURCE);
 
 main();