@alessandroraffa/tangyr 0.21.2 → 0.21.4

package/mappings/hook-events.yaml

@@ -12,7 +12,7 @@ notes:
   - Source events below are the events the canonical agent-coding kit registers, plus SessionStart.
   - An event a kit registers but this file does not list is not silently dropped — the compilers report it as unmapped and name this file. Keeping the two in step is the point of that report.
   - SessionStart, UserPromptSubmit and PostToolUseFailure were added on 2026-09-04. UserPromptSubmit and PostToolUseFailure were already registered by the kit and were being dropped for every non-claude-code target with no reason attached, because an event absent from this file was indistinguishable from one deliberately dropped.
-  - Copilot event coverage must still be runtime-probed because official pages do not expose a single stable denominator.
+  - Copilot event coverage was settled on 2026-09-07 and no longer needs a probe: the CLI ships a JSON schema (schemas/api.schema.json, definition HookType) enumerating seventeen hook events with descriptions, and one live session confirmed the file is loaded and fires. The note this replaces said no stable denominator was published; the vendor ships one inside the tool.
   - Codex hook support is currently a macOS/Linux baseline; Windows remains unsupported unless vendor documentation changes.
 
 source_events:
@@ -42,53 +42,63 @@ targets:
 
   copilot:
     delivery: mapped
-    requires_probe: true
+    # Measured on 2026-09-07 against GitHub Copilot CLI 1.0.83, which ships a
+    # JSON schema documenting its hook contract — schemas/api.schema.json,
+    # definition HookType — and which was probed live in a real agent turn.
+    # These are results, not a reading of a binary.
+    #
+    # The event enum has seventeen values, all camelCase, each with a written
+    # description: preToolUse, preMcpToolCall, postToolUse, postToolUseFailure,
+    # userPromptSubmitted, userPromptTransformed, sessionStart, sessionEnd,
+    # postResult, prePRDescription, errorOccurred, agentStop, subagentStart,
+    # subagentStop, preCompact, permissionRequest, notification.
+    #
+    # Every source event below has an equivalent. The entries this replaces
+    # said otherwise: six were marked `probe` with the reason "not probeable on
+    # the machine this mapping was last measured on", and PreCompact was a
+    # `drop` claiming "no documented user-level equivalent" for an event the
+    # vendor's own schema documents. `Stop` pointed at sessionEnd — the session
+    # ending — where agentStop is the agent stopping, which is what it means.
+    #
+    # The file shape was already right and is unchanged: Copilot accepts Claude
+    # Code's nested matcher/hooks structure under a top-level `hooks` object,
+    # and its log says so when it does not. What made a kit's hooks reach
+    # Copilot and do nothing is the matcher: Copilot matches on its own tool
+    # names — measured bash, view, create, edit, grep — with a full,
+    # case-sensitive regex, so `Bash` never matched `bash`. Translation lives
+    # in COPILOT_TOOL_NAMES in compiler/hooks.ts.
+    #
+    # One limit worth recording: in prompt mode (-p) repository hooks under
+    # .github/hooks/ load only once the folder is trusted. User-level hooks in
+    # ~/.copilot/hooks/ have no such gate, which is how this was probed.
     source_to_target:
       SessionStart:
-        status: probe
-        reason: >-
-          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.
+        status: mapped
+        target_event: sessionStart
       UserPromptSubmit:
-        status: probe
-        reason: >-
-          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 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.
+        status: mapped
+        target_event: userPromptSubmitted
       PreToolUse:
         status: mapped
         target_event: preToolUse
       PostToolUse:
         status: mapped
         target_event: postToolUse
+      PostToolUseFailure:
+        status: mapped
+        target_event: postToolUseFailure
       PreCompact:
-        status: drop
-        severity: warning
-        reason: No documented user-level equivalent in the active baseline.
+        status: mapped
+        target_event: preCompact
       SubagentStart:
-        status: probe
-        reason: The runtime may expose a related event, but the adapter must not hard-code it as baseline support.
+        status: mapped
+        target_event: subagentStart
       SubagentStop:
-        status: probe
-        reason: The runtime may expose a related event, but the adapter must not hard-code it as baseline support.
+        status: mapped
+        target_event: subagentStop
       Stop:
         status: mapped
-        target_event: sessionEnd
-        severity: warning
-        reason: Closest documented session-end lifecycle event, not a one-to-one semantic equivalent.
+        target_event: agentStop
 
   codex:
     delivery: partial

package/package.json

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