@alessandroraffa/tangyr 0.21.3 → 0.21.4

package/dist/index.js

@@ -25777,7 +25777,11 @@ function compileCursorHooks(sourceHooksJson, mappings, lossReport, sourceLabel)
       }
       const untranslatable = /* @__PURE__ */ new Set();
       hooks[mapping.target_event] = entries.map((entry) => {
-        const matcher = entry.matcher === void 0 ? void 0 : translateCursorMatcher(entry.matcher, untranslatable);
+        const matcher = entry.matcher === void 0 ? void 0 : translateMatcher(
+          entry.matcher,
+          CURSOR_TOOL_NAMES,
+          untranslatable
+        );
         return {
           type: "command",
           command: entry.command,
@@ -25815,6 +25819,23 @@ function compileCursorHooks(sourceHooksJson, mappings, lossReport, sourceLabel)
   }
   return { payload: hooks, translated, dropped, droppedEvents };
 }
+function translateCopilotMatchers(payload, untranslatable) {
+  const entries = Array.isArray(payload) ? payload : [payload];
+  const translated = entries.map((entry) => {
+    if (!isRecord(entry) || typeof entry.matcher !== "string") {
+      return entry;
+    }
+    return {
+      ...entry,
+      matcher: translateMatcher(
+        entry.matcher,
+        COPILOT_TOOL_NAMES,
+        untranslatable
+      )
+    };
+  });
+  return Array.isArray(payload) ? translated : translated[0];
+}
 function compileOpenCodeHooks(sourceHooksJson, lossReport, sourceLabel) {
   const sourceHooks = isRecord(sourceHooksJson) && isRecord(sourceHooksJson.hooks) ? sourceHooksJson.hooks : {};
   for (const eventName of Object.keys(sourceHooks)) {
@@ -25918,8 +25939,22 @@ function compileCopilotHooks(sourceHooksJson, mappings, lossReport, sourceLabel)
       sourceEvent
     );
     if (mapping.status === "mapped" && mapping.target_event) {
-      hooks[mapping.target_event] = payload;
+      const untranslatable = /* @__PURE__ */ new Set();
+      hooks[mapping.target_event] = translateCopilotMatchers(
+        payload,
+        untranslatable
+      );
       translated += 1;
+      if (untranslatable.size > 0) {
+        addInformational(
+          lossReport,
+          "copilot",
+          "hooks",
+          sourceLabel,
+          "warning",
+          `${sourceEvent}: ${[...untranslatable].map((m) => `'${m}'`).join(", ")} ${untranslatable.size === 1 ? "names a tool" : "name tools"} with no known Copilot equivalent and ${untranslatable.size === 1 ? "was" : "were"} written through unchanged. Copilot matches on its own tool names \u2014 measured: bash, view, create, edit, grep \u2014 and the match is a full, case-sensitive regex, so a hook scoped to a name it does not use is accepted and never runs. To fix: add the name to COPILOT_TOOL_NAMES in the compiler once its Copilot equivalent has been measured.`
+        );
+      }
       if (mapping.severity || mapping.reason) {
         addInformational(
           lossReport,
@@ -25963,21 +25998,39 @@ var CURSOR_TOOL_NAMES = {
   Write: "Write",
   Grep: "Grep"
 };
-function translateCursorMatcher(matcher, untranslatable) {
+var COPILOT_TOOL_NAMES = {
+  Bash: "bash",
+  Read: "view",
+  Write: "create",
+  Edit: "edit",
+  MultiEdit: "edit",
+  Grep: "grep",
+  // Copilot's own names map to themselves, so a kit written against this
+  // mapping is not reported as using something unknown.
+  bash: "bash",
+  view: "view",
+  create: "create",
+  edit: "edit",
+  grep: "grep"
+};
+function translateMatcher(matcher, table, untranslatable) {
   const translated = [];
   for (const token of matcher.split("|")) {
     const trimmed = token.trim();
     if (!trimmed) continue;
-    const mapped = CURSOR_TOOL_NAMES[trimmed];
-    if (mapped === void 0) {
-      untranslatable.add(trimmed);
-      if (!translated.includes(trimmed)) translated.push(trimmed);
+    const mapped = table[trimmed];
+    if (mapped !== void 0) {
+      if (!translated.includes(mapped)) translated.push(mapped);
       continue;
     }
-    if (!translated.includes(mapped)) translated.push(mapped);
+    if (PLAIN_TOOL_NAME.test(trimmed)) {
+      untranslatable.add(trimmed);
+    }
+    if (!translated.includes(trimmed)) translated.push(trimmed);
   }
   return translated.join("|");
 }
+var PLAIN_TOOL_NAME = /^[A-Za-z][A-Za-z0-9_-]*$/u;
 function extractHookCommands(payload) {
   const entries = Array.isArray(payload) ? payload : [payload];
   const found = [];

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.3",
+  "version": "0.21.4",
   "description": "CLI for the Tangyr discipline — install and manage operating kits for AI coding tools",
   "license": "MIT",
   "engines": {