memtrace-skills 1.1.4 → 1.1.6

package/dist/transformers/claude.d.ts

@@ -20,21 +20,41 @@ export interface SettingsMutationResult {
  * Never overwrites a malformed file — backs it up and returns registered=false.
  */
 export declare function registerMcpInSettingsAt(settingsPath: string, memtraceBinary: string): SettingsMutationResult;
+/**
+ * The Claude Code PreToolUse hook command.
+ *
+ * POSIX hosts POST the hook payload to the running daemon's in-process router
+ * (`POST /api/rail/hook`) with one `curl` — ~5ms of process instead of the
+ * full memtrace binary (node shim + native pair, ~59MB alive for ~0.5s) per
+ * Grep/Glob/Bash call. Fail-open is structural: no daemon (connection
+ * refused, bounded by `--connect-timeout`) or an old daemon without the
+ * endpoint (`-f` on 404) produces no output, and `|| true` exits 0 — Claude
+ * Code treats that as allow-with-no-decision. The full binary is NEVER the
+ * fallback. The agent session's `MEMTRACE_RAIL` / `MEMTRACE_RAW_SEARCH` ride
+ * along as query params, so per-session mode/escape semantics are identical
+ * to the spawn era; `MEMTRACE_RAIL_SEARCH_URL` / `MEMTRACE_UI_PORT` override
+ * the endpoint the same way they steered the binary's own daemon lookup.
+ *
+ * Windows keeps the gen-1 binary spawn: hook commands there do not run under
+ * a POSIX shell, so the env-forwarding one-liner has no portable equivalent.
+ */
+export declare function claudeRailHookCommand(memtraceBinary: string, platform?: NodeJS.Platform): string;
 /**
  * Register the Memtrace Rail PreToolUse hook in a Claude settings.json.
  *
  * This is what makes Rail "part of memtrace" rather than a manual install:
  * `memtrace install` wires a PreToolUse hook that pipes every Grep/Glob/Bash
- * attempt through `memtrace route --hook`. The hook defaults to **observe**
- * (zero behavior change) — `MEMTRACE_RAIL=nudge|rail|strict` opts into more.
- * Mode is intentionally NOT baked into the command so the user can change it
- * via env without re-installing.
+ * attempt through the Rail router (see {@link claudeRailHookCommand} for the
+ * transport). The hook defaults to **observe** (zero behavior change) —
+ * `MEMTRACE_RAIL=nudge|rail|strict` opts into more. Mode is intentionally NOT
+ * baked into the command so the user can change it via env without
+ * re-installing.
  *
- * Idempotent: any prior Rail entry (identified by {@link RAIL_HOOK_MARKER}) is
- * replaced, and unrelated PreToolUse hooks are preserved. Never overwrites a
- * malformed file.
+ * Idempotent: any prior Rail entry (identified by {@link RAIL_HOOK_MARKERS})
+ * is replaced, and unrelated PreToolUse hooks are preserved. Never overwrites
+ * a malformed file.
  */
-export declare function registerRailHookInSettingsAt(settingsPath: string, memtraceBinary: string): SettingsMutationResult;
+export declare function registerRailHookInSettingsAt(settingsPath: string, memtraceBinary: string, platform?: NodeJS.Platform): SettingsMutationResult;
 /**
  * Remove the Memtrace Rail PreToolUse hook from a Claude settings.json.
  * Preserves unrelated hooks; prunes empty containers. Never touches a

package/dist/transformers/claude.js

@@ -214,26 +214,58 @@ export function registerMcpInSettingsAt(settingsPath, memtraceBinary) {
 const RAIL_HOOK_MATCHER = 'Grep|Glob|Bash';
 /** Substring that identifies a memtrace-owned Rail hook entry (for idempotent
  * re-register + clean removal). */
-const RAIL_HOOK_MARKER = 'route --hook';
+const RAIL_HOOK_MARKERS = [
+    // gen-1: the hook spawned the full memtrace binary per tool call.
+    'route --hook',
+    // gen-2: the hook POSTs the payload to the running daemon's in-process
+    // router (one curl, no binary spawn).
+    '/api/rail/hook',
+];
 const LEGACY_HOOK_SCRIPT_BASENAMES = [
     'userprompt-claude.sh',
     'posttool-mcp-telemetry.sh',
 ];
+/**
+ * The Claude Code PreToolUse hook command.
+ *
+ * POSIX hosts POST the hook payload to the running daemon's in-process router
+ * (`POST /api/rail/hook`) with one `curl` — ~5ms of process instead of the
+ * full memtrace binary (node shim + native pair, ~59MB alive for ~0.5s) per
+ * Grep/Glob/Bash call. Fail-open is structural: no daemon (connection
+ * refused, bounded by `--connect-timeout`) or an old daemon without the
+ * endpoint (`-f` on 404) produces no output, and `|| true` exits 0 — Claude
+ * Code treats that as allow-with-no-decision. The full binary is NEVER the
+ * fallback. The agent session's `MEMTRACE_RAIL` / `MEMTRACE_RAW_SEARCH` ride
+ * along as query params, so per-session mode/escape semantics are identical
+ * to the spawn era; `MEMTRACE_RAIL_SEARCH_URL` / `MEMTRACE_UI_PORT` override
+ * the endpoint the same way they steered the binary's own daemon lookup.
+ *
+ * Windows keeps the gen-1 binary spawn: hook commands there do not run under
+ * a POSIX shell, so the env-forwarding one-liner has no portable equivalent.
+ */
+export function claudeRailHookCommand(memtraceBinary, platform = process.platform) {
+    if (platform === 'win32')
+        return `${memtraceBinary} route --hook`;
+    const endpoint = '${MEMTRACE_RAIL_SEARCH_URL:-http://127.0.0.1:${MEMTRACE_UI_PORT:-3030}}';
+    const query = 'host=claude-code&mode=${MEMTRACE_RAIL:-}&escape=${MEMTRACE_RAW_SEARCH:-}';
+    return `curl -sf --connect-timeout 0.05 --max-time 2 --data-binary @- "${endpoint}/api/rail/hook?${query}" 2>/dev/null || true`;
+}
 /**
  * Register the Memtrace Rail PreToolUse hook in a Claude settings.json.
  *
  * This is what makes Rail "part of memtrace" rather than a manual install:
  * `memtrace install` wires a PreToolUse hook that pipes every Grep/Glob/Bash
- * attempt through `memtrace route --hook`. The hook defaults to **observe**
- * (zero behavior change) — `MEMTRACE_RAIL=nudge|rail|strict` opts into more.
- * Mode is intentionally NOT baked into the command so the user can change it
- * via env without re-installing.
+ * attempt through the Rail router (see {@link claudeRailHookCommand} for the
+ * transport). The hook defaults to **observe** (zero behavior change) —
+ * `MEMTRACE_RAIL=nudge|rail|strict` opts into more. Mode is intentionally NOT
+ * baked into the command so the user can change it via env without
+ * re-installing.
  *
- * Idempotent: any prior Rail entry (identified by {@link RAIL_HOOK_MARKER}) is
- * replaced, and unrelated PreToolUse hooks are preserved. Never overwrites a
- * malformed file.
+ * Idempotent: any prior Rail entry (identified by {@link RAIL_HOOK_MARKERS})
+ * is replaced, and unrelated PreToolUse hooks are preserved. Never overwrites
+ * a malformed file.
  */
-export function registerRailHookInSettingsAt(settingsPath, memtraceBinary) {
+export function registerRailHookInSettingsAt(settingsPath, memtraceBinary, platform = process.platform) {
     const { value, corrupted, backupPath } = safeReadJson(settingsPath);
     if (corrupted) {
         console.warn(`memtrace: ${settingsPath} is malformed; backed up to ${backupPath}. Skipped Rail hook registration.`);
@@ -252,7 +284,7 @@ export function registerRailHookInSettingsAt(settingsPath, memtraceBinary) {
         hooks: [
             {
                 type: 'command',
-                command: `${memtraceBinary} route --hook`,
+                command: claudeRailHookCommand(memtraceBinary, platform),
             },
         ],
     });
@@ -260,9 +292,9 @@ export function registerRailHookInSettingsAt(settingsPath, memtraceBinary) {
     writeJsonAtomic(settingsPath, settings);
     return { registered: true };
 }
-/** True when a PreToolUse entry is a memtrace-owned Rail hook. */
+/** True when a PreToolUse entry is a memtrace-owned Rail hook (any generation). */
 function isRailHookEntry(entry) {
-    return hookCommands(entry).some((command) => command.includes(RAIL_HOOK_MARKER));
+    return hookCommands(entry).some((command) => RAIL_HOOK_MARKERS.some((marker) => command.includes(marker)));
 }
 function isLegacyMemtraceHookEntry(entry) {
     return hookCommands(entry).some((command) => (LEGACY_HOOK_SCRIPT_BASENAMES.some((basename) => command.includes(basename))));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "memtrace-skills",
-  "version": "1.1.4",
+  "version": "1.1.6",
   "description": "Memtrace skills for AI coding agents — codebase exploration, temporal evolution, impact analysis, and more.",
   "type": "module",
   "bin": {