@groundtrack/hooks 0.1.0 → 0.1.1

package/README.md

@@ -10,8 +10,17 @@ npm install -g @groundtrack/hooks
 ```
 
 The command reads a pre-tool-use hook payload from standard input and enriches
-Groundtrack `store_event` calls with the client session and model identifiers.
-It does not send network requests or read project files.
+Groundtrack `store_event` calls with:
+
+- the client session and model identifiers (using Claude's host-provided
+  transcript path when its hook payload omits the model);
+- a stable client event id derived from the host's tool invocation id; and
+- repository, branch, commit, and dirty-worktree context collected with Git.
+
+The Git context is collected from the hook's working directory (or a single
+Cursor workspace root) and overrides model-provided values. Collection fails
+open when the hook is outside a Git worktree. The command does not send network
+requests.
 
 Update it with:
 

package/dist/enrich-store-event.js

@@ -1,3 +1,5 @@
+import { execFileSync } from "node:child_process";
+import { closeSync, fstatSync, openSync, readSync } from "node:fs";
 const PROVIDERS = [
     [/^claude(?:[-_.]|$)/, "anthropic"],
     [/^(?:gpt|o\d|codex)(?:[-_.]|$)/, "openai"],
@@ -18,12 +20,97 @@ function normalizeModelId(value) {
     const provider = PROVIDERS.find(([pattern]) => pattern.test(model))?.[1];
     return provider ? `${provider}/${model}` : null;
 }
+function sanitizeRepoKey(value) {
+    const remote = nonEmptyString(value);
+    if (!remote)
+        return null;
+    try {
+        const path = remote.includes("://")
+            ? new URL(remote).pathname
+            : remote.replace(/^[^@\s]+@[^:\s]+:/, "");
+        const repoKey = path.replace(/^\/+/, "").replace(/\.git$/i, "");
+        return /^[a-z0-9._-]+(?:\/[a-z0-9._-]+)+$/i.test(repoKey) ? repoKey : null;
+    }
+    catch {
+        return null;
+    }
+}
+function transcriptModel(transcriptPath) {
+    const path = nonEmptyString(transcriptPath);
+    if (!path)
+        return null;
+    let fd = null;
+    try {
+        fd = openSync(path, "r");
+        const size = fstatSync(fd).size;
+        const length = Math.min(size, 256 * 1024);
+        const buffer = Buffer.alloc(length);
+        readSync(fd, buffer, 0, length, size - length);
+        const lines = buffer.toString("utf8").split("\n");
+        if (size > length)
+            lines.shift();
+        for (const line of lines.reverse()) {
+            if (!line.trim())
+                continue;
+            try {
+                const entry = JSON.parse(line);
+                const model = nonEmptyString(entry.message?.model ?? entry.model);
+                if (model)
+                    return model;
+            }
+            catch {
+                // Ignore partial and non-JSON transcript lines.
+            }
+        }
+    }
+    catch {
+        return null;
+    }
+    finally {
+        if (fd != null)
+            closeSync(fd);
+    }
+    return null;
+}
 function isGroundtrackStoreEvent(toolName) {
     const normalized = nonEmptyString(toolName)?.toLowerCase();
     if (!normalized?.includes("store_event"))
         return false;
     return normalized.includes("groundtrack") || normalized === "mcp:store_event";
 }
+function workspacePath(hookInput) {
+    const cwd = nonEmptyString(hookInput.cwd);
+    if (cwd)
+        return cwd;
+    if (!Array.isArray(hookInput.workspace_roots) || hookInput.workspace_roots.length !== 1) {
+        return null;
+    }
+    return nonEmptyString(hookInput.workspace_roots[0]);
+}
+function git(cwd, args) {
+    try {
+        return execFileSync("git", ["-C", cwd, ...args], {
+            encoding: "utf8",
+            maxBuffer: 8 * 1024 * 1024,
+            stdio: ["ignore", "pipe", "ignore"],
+            timeout: 2_000,
+        }).trim();
+    }
+    catch {
+        return null;
+    }
+}
+function gitContext(cwd) {
+    if (!cwd || git(cwd, ["rev-parse", "--is-inside-work-tree"]) !== "true")
+        return null;
+    const status = git(cwd, ["status", "--porcelain"]);
+    return {
+        repoKey: sanitizeRepoKey(git(cwd, ["remote", "get-url", "origin"])),
+        branch: nonEmptyString(git(cwd, ["branch", "--show-current"])),
+        commitSha: nonEmptyString(git(cwd, ["rev-parse", "HEAD"])),
+        isDirty: status == null ? null : status.length > 0,
+    };
+}
 export function enrichInput(hookInput, clientOverride) {
     const toolInput = hookInput.tool_input &&
         typeof hookInput.tool_input === "object" &&
@@ -33,11 +120,20 @@ export function enrichInput(hookInput, clientOverride) {
     const isCursor = nonEmptyString(hookInput.conversation_id) != null;
     const host = nonEmptyString(clientOverride)?.toLowerCase() ?? (isCursor ? "cursor" : "codex");
     const hostSessionId = nonEmptyString(isCursor ? hookInput.conversation_id : hookInput.session_id);
-    const hostModel = normalizeModelId(isCursor ? (hookInput.model_id ?? hookInput.model) : hookInput.model);
+    const hostModel = normalizeModelId(isCursor
+        ? (hookInput.model_id ?? hookInput.model)
+        : (hookInput.model ?? hookInput.model_id ?? transcriptModel(hookInput.transcript_path)));
+    const invocationId = nonEmptyString(isCursor ? hookInput.generation_id : hookInput.tool_use_id);
+    const context = gitContext(workspacePath(hookInput));
     if (hostSessionId)
         toolInput.sessionId = `${host}:${hostSessionId}`;
     if (hostModel)
         toolInput.modelId = hostModel;
+    if (invocationId) {
+        toolInput.clientEventId = [host, hostSessionId, invocationId].filter(Boolean).join(":");
+    }
+    if (context)
+        Object.assign(toolInput, context);
     return toolInput;
 }
 export function hookOutput(hookInput, clientOverride) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@groundtrack/hooks",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Lifecycle hook utilities for Groundtrack MCP clients.",
   "keywords": [
     "claude-code",
@@ -27,6 +27,7 @@
     "build": "tsc -p tsconfig.json",
     "lint": "oxlint .",
     "prepack": "pnpm run build",
+    "release:patch": "node scripts/release-patch.mjs",
     "test": "pnpm run build && node --test test/*.test.mjs",
     "typecheck": "tsc -p tsconfig.json --noEmit"
   },