@groundtrack/hooks 0.1.2 → 0.1.3

package/README.md

@@ -24,6 +24,13 @@ Groundtrack MCP server alias, validates Claude/Codex/Cursor hook configuration,
 checks the managed `AGENTS.md` and `CLAUDE.md` instructions, and simulates a
 hook invocation. It exits non-zero when repair is needed.
 
+The Doctor verifies local configuration and enrichment behavior, but it cannot
+observe whether a coding-agent host loaded or trusted a project hook. A
+`search_experiences` MCP response is the authoritative live check: Groundtrack
+returns a `hook_context_missing` warning when hook-injected session context is
+absent. In Codex, use `/hooks` to review and trust the Groundtrack hook when that
+warning appears.
+
 `doctor --fix` previews the diagnosis, asks before changing anything, updates
 only Groundtrack-owned hook entries and versioned managed instruction blocks,
 then repeats the verification. Use `--yes` for an explicitly authorized

package/dist/doctor.js

@@ -510,18 +510,26 @@ export function runDoctor(options) {
         updated.clientEventId === "claude:doctor-session:doctor-tool";
     checks.push({
         id: "hook-simulation",
-        label: "Hook simulation",
+        label: "Local hook simulation",
         status: simulationHealthy ? "ok" : "issue",
         detail: simulationHealthy
-            ? "session, model, and invocation context enriched"
+            ? "session, model, and invocation context enriched locally"
             : "enrichment failed",
     });
+    checks.push({
+        id: "live-hook-activation",
+        label: "Live hook activation",
+        status: "advisory",
+        detail: clients.includes("codex")
+            ? "not verifiable outside Codex; open /hooks and review and trust the Groundtrack hook"
+            : "not verifiable outside the coding-agent host; Groundtrack MCP calls report missing hook context",
+    });
     return {
         version,
         clients,
         aliases,
         checks,
         changedFiles,
-        healthy: checks.every((check) => check.status === "ok" || check.status === "fixed"),
+        healthy: checks.every((check) => check.status === "ok" || check.status === "fixed" || check.status === "advisory"),
     };
 }

package/dist/groundtrack.js

@@ -43,26 +43,28 @@ function parseArguments(argv) {
         homeDir,
     };
 }
-function printResult(result) {
+function printResult(result, options = {}) {
     stdout.write(`Groundtrack doctor ${result.version}\n`);
     stdout.write(`Clients: ${result.clients.join(", ")}\n`);
     stdout.write(`MCP aliases: ${result.aliases.join(", ")}\n\n`);
     for (const check of result.checks) {
         const icon = check.status === "ok"
             ? "✓"
-            : check.status === "fixed"
-                ? "◆"
-                : check.status === "blocked"
-                    ? "×"
-                    : "!";
+            : check.status === "advisory"
+                ? "i"
+                : check.status === "fixed"
+                    ? "◆"
+                    : check.status === "blocked"
+                        ? "×"
+                        : "!";
         stdout.write(`${icon} ${check.label}: ${check.detail}${check.file ? ` (${check.file})` : ""}\n`);
     }
     if (result.changedFiles.length > 0) {
         stdout.write(`\nUpdated ${result.changedFiles.length} file(s).\n`);
     }
     stdout.write(result.healthy
-        ? "\nGroundtrack integration is healthy.\n"
-        : "\nGroundtrack integration needs attention.\n");
+        ? "\nGroundtrack local configuration is healthy. Live hook activation is verified by Groundtrack MCP calls.\n"
+        : `\nGroundtrack local configuration needs attention.${options.showFixHint ? " Run: groundtrack doctor --fix" : ""}\n`);
 }
 async function confirmFix() {
     const prompt = createInterface({ input: stdin, output: stdout });
@@ -138,7 +140,7 @@ async function main() {
         if (args.json)
             stdout.write(`${JSON.stringify(diagnosis, null, 2)}\n`);
         else
-            printResult(diagnosis);
+            printResult(diagnosis, { showFixHint: true });
         process.exitCode = diagnosis.healthy ? 0 : 1;
         return;
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@groundtrack/hooks",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "description": "Lifecycle hook utilities for Groundtrack MCP clients.",
   "keywords": [
     "claude-code",