@alessandroraffa/tangyr 0.21.0 → 0.21.2

package/mappings/hook-events.yaml

@@ -143,81 +143,61 @@ targets:
 
   cursor:
     delivery: native-versioned-object
-    # READ THIS BEFORE TRUSTING THE ENTRIES BELOW.
+    # Measured on 2026-09-06 against cursor-agent 2026.09.02-c22c1a3, by writing a
+    # .cursor/hooks.json, running a real agent turn, and checking whether the hook's
+    # script had run. Every entry below is a result, not a reading of the binary.
     #
-    # On 2026-09-04 the shipped Cursor binary was inspected at
-    # /Applications/Cursor.app/Contents/Resources/app/extensions/cursor-agent-exec/dist/main.js.
-    # Its hook-step enum holds twelve values, all camelCase:
+    # The steps are camelCase and come from a 21-value enum: beforeShellExecution,
+    # beforeMCPExecution, afterShellExecution, afterMCPExecution, beforeReadFile,
+    # afterFileEdit, beforeTabFileRead, afterTabFileEdit, stop, beforeSubmitPrompt,
+    # afterAgentResponse, afterAgentThought, sessionStart, sessionEnd, preCompact,
+    # subagentStart, subagentStop, preToolUse, postToolUse, postToolUseFailure,
+    # workspaceOpen. Every one of this file's source events has an equivalent there.
     #
-    #   afterFileEdit, afterMCPExecution, afterShellExecution, beforeMCPExecution,
-    #   beforeReadFile, beforeShellExecution, postToolUse, postToolUseFailure,
-    #   preCompact, preToolUse, subagentStart, subagentStop
+    # What the 2026-09-04 note above this block got wrong, and how:
     #
-    # The target_event values written below are PascalCase — `PreToolUse`, not `preToolUse` —
-    # and JSON keys are case sensitive. Three consequences follow, none of them verified:
+    #   1. The enum was read from the GUI app and had twelve values. The CLI's has
+    #      twenty-one, sessionStart and beforeSubmitPrompt among them. Two events
+    #      recorded here as having no equivalent do have one.
+    #   2. PascalCase was suspected of being the whole defect. It is not: a file in
+    #      Claude Code's own shape with PascalCase keys and { matcher, hooks: [] }
+    #      entries did not fire either, though the binary carries a detector for
+    #      that shape. Case and shape had to change together.
+    #   3. The entry was thought to hold one command per event, so the compiler
+    #      reported a collapse. It holds an array: three commands on one step all
+    #      ran, in parallel. There is nothing to collapse.
     #
-    #   1. What this CLI writes to .cursor/hooks.json may be inert. The file exists, names real
-    #      scripts, and may match no key Cursor looks up. That is exactly the failure shape this
-    #      mapping is meant to prevent, so it is recorded here rather than left to be discovered.
-    #   2. preCompact, subagentStart and subagentStop ARE in that enum, while the entries below
-    #      say they have "no documented equivalent". That claim is wrong, whatever the case
-    #      question turns out to be.
-    #   3. The same file resolves ~/.claude/settings.json and <project>/.claude/settings.json as
-    #      hook sources alongside ~/.cursor/hooks.json. Cursor may already be reading the
-    #      Claude Code artifact this CLI writes, which would make its own hooks.json redundant.
-    #
-    # Nothing below was changed on this evidence. Minified code read without running it is a
-    # strong hint and not a measurement, and swapping one unverified mapping for another is the
-    # same mistake in the other direction. To settle it: install this kit for cursor, open the
-    # Cursor GUI, run one agent turn that executes a shell command, and check whether the hook
-    # script ran — then repeat with the keys lowercased. Cursor has no CLI on the machine this
-    # was measured on, which is why it stopped here.
+    # One finding has no entry here because it belongs to the compiler: `matcher` is
+    # honoured, alternation included, but against Cursor's tool names. A hook scoped
+    # to "Bash" never runs; "Shell" does. See CURSOR_TOOL_NAMES in compiler/hooks.ts.
     source_to_target:
       SessionStart:
-        status: probe
-        reason: >-
-          Not in the observed enum under any casing, and not probeable without the GUI. See the
-          note above this block.
+        status: mapped
+        target_event: sessionStart
       UserPromptSubmit:
-        status: probe
-        reason: >-
-          Not in the observed enum; the nearest candidate is beforeSubmitPrompt, which is a
-          different contract. See the note above this block.
-      PostToolUseFailure:
-        status: probe
-        reason: >-
-          postToolUseFailure is in the observed enum, camelCased. Unverified. See the note above
-          this block.
+        status: mapped
+        target_event: beforeSubmitPrompt
       PreToolUse:
         status: mapped
-        target_event: PreToolUse
+        target_event: preToolUse
       PostToolUse:
         status: mapped
-        target_event: PostToolUse
+        target_event: postToolUse
+      PostToolUseFailure:
+        status: mapped
+        target_event: postToolUseFailure
       PreCompact:
-        status: probe
-        severity: warning
-        reason: >-
-          preCompact is in the observed enum, camelCased. The previous entry here said there was
-          no documented equivalent, which the enum contradicts. See the note above this block.
+        status: mapped
+        target_event: preCompact
       SubagentStart:
-        status: probe
-        severity: warning
-        reason: >-
-          subagentStart is in the observed enum, camelCased. The previous entry here said there was
-          no documented equivalent, which the enum contradicts. See the note above this block.
+        status: mapped
+        target_event: subagentStart
       SubagentStop:
-        status: probe
-        severity: warning
-        reason: >-
-          subagentStop is in the observed enum, camelCased. The previous entry here said there was
-          no documented equivalent, which the enum contradicts. See the note above this block.
+        status: mapped
+        target_event: subagentStop
       Stop:
-        status: drop
-        severity: warning
-        reason: >-
-          Not in the observed enum. `stop` appears in that file but as an unrelated identifier, so
-          this stays a drop rather than becoming a guess. See the note above this block.
+        status: mapped
+        target_event: stop
 
   # OpenCode and Cline exchange no declarative hook file at all: hooks are
   # plugin code (an OpenCode plugin, a @cline/sdk AgentPlugin), which a kit

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alessandroraffa/tangyr",
-  "version": "0.21.0",
+  "version": "0.21.2",
   "description": "CLI for the Tangyr discipline — install and manage operating kits for AI coding tools",
   "license": "MIT",
   "engines": {