@groundtrack/hooks 0.1.4 → 0.1.6

package/dist/agent-instructions.js

@@ -1,10 +1,47 @@
 import { readFileSync } from "node:fs";
-const VERSION_PATTERN = /^<!-- groundtrack:start version=(\d+) -->/;
+import { join } from "node:path";
+const VERSION_PATTERN = /<!-- groundtrack:start version=(\d+) -->/;
 /** Canonical managed Groundtrack policy, packaged with the CLI. */
 export const AGENT_INSTRUCTION_BODY = readFileSync(new URL("../templates/AGENTS.md", import.meta.url), "utf8").trim();
 const versionMatch = VERSION_PATTERN.exec(AGENT_INSTRUCTION_BODY);
 if (!versionMatch) {
     throw new Error("Canonical Groundtrack AGENTS.md template is missing its version marker.");
 }
+const AGENT_INSTRUCTION_START_MARKER = versionMatch[0];
 /** Version is derived from the canonical template marker; never define it separately. */
 export const AGENT_INSTRUCTION_TEMPLATE_VERSION = Number(versionMatch[1]);
+function readInstructions(path) {
+    try {
+        return readFileSync(path, "utf8");
+    }
+    catch {
+        return null;
+    }
+}
+function instructionVersion(content) {
+    const match = content ? VERSION_PATTERN.exec(content) : null;
+    return match ? Number(match[1]) : null;
+}
+/** Detect the managed policy version available to a client in one repository. */
+export function detectAgentInstructionsVersion(repoDir, client) {
+    const agents = readInstructions(join(repoDir, "AGENTS.md"));
+    const agentsVersion = instructionVersion(agents);
+    if (client !== "claude")
+        return agentsVersion;
+    const claude = readInstructions(join(repoDir, "CLAUDE.md"));
+    if (!claude)
+        return null;
+    if (/^@AGENTS\.md\s*$/m.test(claude)) {
+        const bridgeVersion = instructionVersion(claude);
+        if (agentsVersion == null)
+            return null;
+        return bridgeVersion == null ? agentsVersion : Math.min(bridgeVersion, agentsVersion);
+    }
+    const inlineVersion = instructionVersion(claude);
+    if (inlineVersion != null)
+        return inlineVersion;
+    const unmarkedCurrentInstructions = AGENT_INSTRUCTION_BODY.replace(AGENT_INSTRUCTION_START_MARKER, "")
+        .replace("<!-- groundtrack:end -->", "")
+        .trim();
+    return claude.includes(unmarkedCurrentInstructions) ? AGENT_INSTRUCTION_TEMPLATE_VERSION : null;
+}

package/dist/doctor.js

@@ -267,14 +267,12 @@ function removeLegacyAgentInstructions(content) {
     return lines.join("\n");
 }
 function upsertManagedContent(content, desired, migrateLegacyAgentInstructions = false) {
-    const existing = migrateLegacyAgentInstructions
-        ? removeLegacyAgentInstructions(content ?? "")
-        : (content ?? "");
+    const existing = content ?? "";
     const managed = /<!-- groundtrack:start version=\d+ -->[\s\S]*?<!-- groundtrack:end -->/;
     if (managed.test(existing)) {
         return `${existing.replace(managed, desired).trimEnd()}\n`;
     }
-    const base = existing.trimEnd();
+    const base = (migrateLegacyAgentInstructions ? removeLegacyAgentInstructions(existing) : existing).trimEnd();
     return `${base}${base ? "\n\n" : ""}${desired}\n`;
 }
 function versionParts(version) {

package/dist/enrich-store-event.js

@@ -1,5 +1,6 @@
 import { execFileSync } from "node:child_process";
 import { closeSync, fstatSync, openSync, readSync } from "node:fs";
+import { detectAgentInstructionsVersion, } from "./agent-instructions.js";
 const PROVIDERS = [
     [/^claude(?:[-_.]|$)/, "anthropic"],
     [/^(?:gpt|o\d|codex)(?:[-_.]|$)/, "openai"],
@@ -120,6 +121,11 @@ function gitContext(cwd) {
         isDirty: status == null ? null : status.length > 0,
     };
 }
+function repositoryRoot(cwd) {
+    if (!cwd)
+        return null;
+    return git(cwd, ["rev-parse", "--show-toplevel"]) ?? cwd;
+}
 export function enrichInput(hookInput, clientOverride, tool = "store_event") {
     const toolInput = hookInput.tool_input &&
         typeof hookInput.tool_input === "object" &&
@@ -133,7 +139,8 @@ export function enrichInput(hookInput, clientOverride, tool = "store_event") {
         ? (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));
+    const cwd = workspacePath(hookInput);
+    const context = gitContext(cwd);
     if (hostSessionId)
         toolInput.sessionId = `${host}:${hostSessionId}`;
     if (hostModel)
@@ -141,6 +148,11 @@ export function enrichInput(hookInput, clientOverride, tool = "store_event") {
     if (tool === "store_event" && invocationId) {
         toolInput.clientEventId = [host, hostSessionId, invocationId].filter(Boolean).join(":");
     }
+    if (tool === "search_experiences") {
+        const client = host === "claude" || host === "cursor" ? host : "codex";
+        const root = repositoryRoot(cwd);
+        toolInput.agentInstructionsVersion = root ? detectAgentInstructionsVersion(root, client) : null;
+    }
     if (context)
         Object.assign(toolInput, context);
     return toolInput;

package/package.json

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

package/templates/AGENTS.md

@@ -1,4 +1,4 @@
-<!-- groundtrack:start version=2 -->
+<!-- groundtrack:start version=3 -->
 
 ## Groundtrack
 
@@ -12,6 +12,5 @@ Use Groundtrack as the shared engineering memory for this repository.
 - After a non-obvious discovery, decision, workaround, correction, or failed approach that would help a future agent, call `store_event` promptly with a concise title and an explanation of what happened and why it matters.
 - Do not store routine implementation details, obvious facts, unrestricted transcripts, or secrets.
 - Keep the raw-event ids returned by `store_event`. When the related work lands in a commit or pull request, call `link_outcomes` with those ids and the explicit commit SHA and/or pull-request number. Never infer an outcome from worktree HEAD.
-- When recurring engineering friction may support or oppose an existing initiative, call `search_initiatives` before storing the event and link it to the matching initiative with the appropriate direction. Propose a new initiative only when explicitly recommending organizational change and no existing initiative matches.
 
 <!-- groundtrack:end -->