@ghl-ai/aw 0.1.44-beta.3 → 0.1.44-beta.4

package/c4/jsonMerge.mjs

@@ -110,9 +110,23 @@ function commandMatchesAnyPattern(command, patterns) {
  * @param {object} opts.newEntry           Entry to append after dedup.
  * @param {string[]} opts.commandPatterns  Substrings; existing entries with
  *                                         a matching `command` field are stripped.
+ * @param {object} [opts.ensureTopLevel]   Optional map of top-level keys to set
+ *                                         on the JSON root (always overwritten).
+ *                                         Used to guarantee schema-required
+ *                                         markers like `{ version: 1 }` for
+ *                                         Cursor's `~/.cursor/hooks.json`.
+ *                                         Without this, Cursor's runtime fails
+ *                                         open and silently skips the hook
+ *                                         (cursor.com/docs/hooks §schema, §979).
  * @returns {{ changed: boolean, prevEntriesRemoved: number }}
  */
-export function jsonMergeWithDedup({ filePath, jsonPointer, newEntry, commandPatterns }) {
+export function jsonMergeWithDedup({
+  filePath,
+  jsonPointer,
+  newEntry,
+  commandPatterns,
+  ensureTopLevel,
+}) {
   if (!filePath || typeof filePath !== 'string') throw new Error('filePath is required');
   if (typeof jsonPointer !== 'string') throw new Error('jsonPointer is required');
   if (newEntry == null || typeof newEntry !== 'object') throw new Error('newEntry must be an object');
@@ -142,6 +156,14 @@ export function jsonMergeWithDedup({ filePath, jsonPointer, newEntry, commandPat
   filtered.push(newEntry);
   parent[key] = filtered;
 
+  // Apply schema-required top-level keys last, so callers can pin invariants
+  // (e.g. `version: 1`) even if a stale on-disk file is missing them.
+  if (ensureTopLevel != null && typeof ensureTopLevel === 'object' && !Array.isArray(ensureTopLevel)) {
+    for (const [k, v] of Object.entries(ensureTopLevel)) {
+      root[k] = v;
+    }
+  }
+
   const serialized = JSON.stringify(root, null, 2) + '\n';
   const changed = atomicWriteIfChanged(filePath, serialized);
 

package/c4/slimRouter.mjs

@@ -497,6 +497,14 @@ function installCursorSlim({ home, escaped }) {
   // Same rationale as installClaudeSlim — escape mode skips the card write.
   ensureDir(dirname(hooksJsonPath));
 
+  // Cursor's hooks.json schema requires `"version": 1` at the top level
+  // (cursor.com/docs/hooks). Without it, the runtime silently fails open
+  // and never invokes our hooks — which is exactly the bug that prevented
+  // the slim card from reaching cursor-cloud agents in 0.1.44-beta.3.
+  // We pin this on every merge call so the file is always schema-valid,
+  // even if a stale or partial file already exists on disk.
+  const cursorHooksTopLevel = { version: 1 };
+
   // (G1) The Node-adapter wrapper that satisfies Cursor's request-rewrite
   // JSON contract. NEVER delegate to shared/user-prompt-submit.sh directly.
   const promptHookCommand =
@@ -524,6 +532,7 @@ function installCursorSlim({ home, escaped }) {
         'aw-slim-session-start.sh',
         '.cursor/hooks/session-start.sh',
       ],
+      ensureTopLevel: cursorHooksTopLevel,
     });
   } else {
     const fullEcc =
@@ -541,6 +550,7 @@ function installCursorSlim({ home, escaped }) {
         'aw-slim-session-start.sh',
         '.cursor/hooks/session-start.sh',
       ],
+      ensureTopLevel: cursorHooksTopLevel,
     });
   }
 
@@ -553,6 +563,7 @@ function installCursorSlim({ home, escaped }) {
       description: 'AW per-prompt rules reminder (ECC Node-adapter)',
     },
     commandPatterns: ['before-submit-prompt.sh'],
+    ensureTopLevel: cursorHooksTopLevel,
   });
 
   return {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ghl-ai/aw",
-  "version": "0.1.44-beta.3",
+  "version": "0.1.44-beta.4",
   "description": "Agentic Workspace CLI — pull, push & manage agents, skills and commands from the registry",
   "type": "module",
   "bin": {