@alessandroraffa/tangyr 0.20.0 → 0.21.0

package/mappings/hook-events.yaml

@@ -47,18 +47,27 @@ targets:
       SessionStart:
         status: probe
         reason: >-
-          Not verified against this runtime. Until someone probes it, the adapter must not
-          claim support it has not observed, and must not present the absence as a decision.
+          Not probed, and not probeable on the machine this mapping was last measured on
+          (2026-09-04): no Copilot CLI is installed there, and ~/.copilot/hooks is empty, so no
+          hook can be made to fire from a terminal. To settle it: install the Copilot CLI, register
+          a hook per event that appends its payload to a file, and drive one session that submits a
+          prompt, runs a tool, fails a tool and ends.
       UserPromptSubmit:
         status: probe
         reason: >-
-          Not verified against this runtime. Until someone probes it, the adapter must not
-          claim support it has not observed, and must not present the absence as a decision.
+          Not probed, and not probeable on the machine this mapping was last measured on
+          (2026-09-04): no Copilot CLI is installed there, and ~/.copilot/hooks is empty, so no
+          hook can be made to fire from a terminal. To settle it: install the Copilot CLI, register
+          a hook per event that appends its payload to a file, and drive one session that submits a
+          prompt, runs a tool, fails a tool and ends.
       PostToolUseFailure:
         status: probe
         reason: >-
-          Not verified against this runtime. Claude Code fires this event where PostToolUse does
-          not; whether an equivalent exists here is unknown.
+          Not probed, and not probeable on the machine this mapping was last measured on
+          (2026-09-04): no Copilot CLI is installed there, and ~/.copilot/hooks is empty, so no
+          hook can be made to fire from a terminal. To settle it: install the Copilot CLI, register
+          a hook per event that appends its payload to a file, and drive one session that submits a
+          prompt, runs a tool, fails a tool and ends.
       PreToolUse:
         status: mapped
         target_event: preToolUse
@@ -89,20 +98,20 @@ targets:
       windows: false
     source_to_target:
       SessionStart:
-        status: probe
-        reason: >-
-          Not verified against this runtime. Until someone probes it, the adapter must not
-          claim support it has not observed, and must not present the absence as a decision.
+        status: mapped
+        target_event: SessionStart
       UserPromptSubmit:
-        status: probe
-        reason: >-
-          Not verified against this runtime. Until someone probes it, the adapter must not
-          claim support it has not observed, and must not present the absence as a decision.
+        status: mapped
+        target_event: UserPromptSubmit
       PostToolUseFailure:
-        status: probe
+        status: drop
+        severity: warning
         reason: >-
-          Not verified against this runtime. Claude Code fires this event where PostToolUse does
-          not; whether an equivalent exists here is unknown.
+          Measured, not assumed. A `codex exec` run on 2026-09-04 registered all nine events and
+          deliberately ran a failing command; Codex fired PostToolUse for it and never fired
+          PostToolUseFailure. Claude Code, where PostToolUse does not fire on a failure, is the
+          reason a kit subscribes to both — under Codex the failure arrives on PostToolUse instead,
+          so a hook that only listens to PostToolUseFailure sees nothing here.
       PreToolUse:
         status: mapped
         target_event: PreToolUse
@@ -110,39 +119,75 @@ targets:
         status: mapped
         target_event: PostToolUse
       PreCompact:
-        status: drop
+        status: probe
         severity: warning
-        reason: No documented equivalent in the current baseline.
+        reason: >-
+          Registered in the 2026-09-04 probe and never fired, but that run never compacted, so the
+          measurement is inconclusive rather than negative. To settle it: drive a session past its
+          context limit with the probe hooks installed.
       SubagentStart:
-        status: drop
+        status: probe
         severity: warning
-        reason: No documented equivalent in the current baseline.
+        reason: >-
+          Registered in the 2026-09-04 probe and never fired, but that run spawned no subagent.
+          Inconclusive. To settle it: run a task that delegates, with the probe hooks installed.
       SubagentStop:
-        status: drop
+        status: probe
         severity: warning
-        reason: No documented equivalent in the current baseline.
+        reason: >-
+          Registered in the 2026-09-04 probe and never fired, but that run spawned no subagent.
+          Inconclusive. To settle it: run a task that delegates, with the probe hooks installed.
       Stop:
         status: mapped
         target_event: Stop
 
   cursor:
     delivery: native-versioned-object
+    # READ THIS BEFORE TRUSTING THE ENTRIES BELOW.
+    #
+    # 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:
+    #
+    #   afterFileEdit, afterMCPExecution, afterShellExecution, beforeMCPExecution,
+    #   beforeReadFile, beforeShellExecution, postToolUse, postToolUseFailure,
+    #   preCompact, preToolUse, subagentStart, subagentStop
+    #
+    # 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. 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.
     source_to_target:
       SessionStart:
         status: probe
         reason: >-
-          Not verified against this runtime. Until someone probes it, the adapter must not
-          claim support it has not observed, and must not present the absence as a decision.
+          Not in the observed enum under any casing, and not probeable without the GUI. See the
+          note above this block.
       UserPromptSubmit:
         status: probe
         reason: >-
-          Not verified against this runtime. Until someone probes it, the adapter must not
-          claim support it has not observed, and must not present the absence as a decision.
+          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: >-
-          Not verified against this runtime. Claude Code fires this event where PostToolUse does
-          not; whether an equivalent exists here is unknown.
+          postToolUseFailure is in the observed enum, camelCased. Unverified. See the note above
+          this block.
       PreToolUse:
         status: mapped
         target_event: PreToolUse
@@ -150,21 +195,29 @@ targets:
         status: mapped
         target_event: PostToolUse
       PreCompact:
-        status: drop
+        status: probe
         severity: warning
-        reason: No documented equivalent in the Cursor hooks baseline.
+        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.
       SubagentStart:
-        status: drop
+        status: probe
         severity: warning
-        reason: No documented equivalent in the Cursor hooks baseline.
+        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.
       SubagentStop:
-        status: drop
+        status: probe
         severity: warning
-        reason: No documented equivalent in the Cursor hooks baseline.
+        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.
       Stop:
         status: drop
         severity: warning
-        reason: No documented equivalent in the Cursor hooks baseline.
+        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.
 
   # 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/mappings/platform-paths.yaml

@@ -28,6 +28,7 @@ targets:
       settings_shared_file: ~/.claude/settings.json
       mcp_shared_file: ~/.claude.json
       hooks: ~/.agents/hooks
+      hook_scripts: ~/.agents/hooks
     project:
       instructions: AGENTS.md
       instructions_shim: CLAUDE.md
@@ -40,6 +41,7 @@ targets:
       settings_shared_file: .claude/settings.json
       mcp_shared_file: .claude.json
       hooks: .agents/hooks
+      hook_scripts: .agents/hooks
 
   copilot:
     global:
@@ -47,6 +49,7 @@ targets:
       skills: ~/.copilot/skills
       prompts: $VSCODE_USER_DATA/prompts
       hooks: ~/.copilot/hooks
+      hook_scripts: ~/.agents/hooks
       mcp_shared_file: ~/.copilot/mcp-config.json
       instructions: null
     project:
@@ -54,6 +57,7 @@ targets:
       skills: .github/skills
       prompts: .github/prompts
       hooks: .github/hooks
+      hook_scripts: .agents/hooks
       mcp_shared_file: .vscode/mcp.json
       instructions: .github/copilot-instructions.md
       agents_md: AGENTS.md
@@ -65,6 +69,7 @@ targets:
       rules: ~/.codex/rules
       skills: ~/.agents/skills
       hooks_shared_file: ~/.codex/hooks.json
+      hook_scripts: ~/.agents/hooks
       mcp_shared_file: ~/.codex/config.toml
     project:
       instructions: AGENTS.md
@@ -72,6 +77,7 @@ targets:
       rules: .codex/rules
       skills: .codex/skills
       hooks_shared_file: .codex/hooks.json
+      hook_scripts: .agents/hooks
       mcp_shared_file: .codex/config.toml
 
   opencode:
@@ -98,6 +104,7 @@ targets:
       skills: ~/.cursor/skills
       skills_shared: ~/.agents/skills
       hooks_file: ~/.cursor/hooks.json
+      hook_scripts: ~/.agents/hooks
       mcp_file: ~/.cursor/mcp.json
       permissions_file: ~/.cursor/permissions.json
     project:
@@ -107,6 +114,7 @@ targets:
       skills: .cursor/skills
       skills_shared: .agents/skills
       hooks_file: .cursor/hooks.json
+      hook_scripts: .agents/hooks
       mcp_file: .cursor/mcp.json
       permissions_file: .cursor/permissions.json
 

package/package.json

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