@hasna/hooks 0.9.5 → 0.9.6

package/bin/index.js

@@ -2075,6 +2075,7 @@ var init_registry = __esm(() => {
     },
     {
       name: "workspace-repos-guard",
+      timeoutSeconds: 10,
       displayName: "Workspace Repos Guard",
       description: "Blocks writes and deletes that break the protected repo-checkout structure (~/.hasna/repos/clones canonical, plus legacy ~/workspace/repos during the migration window): writes to a protected root, top-level entry creation, non-org folders, and any delete under a protected root",
       version: "0.1.0",
@@ -2093,7 +2094,7 @@ var init_registry = __esm(() => {
       matcher: "^(Bash|apply_patch|ApplyPatch|functions\\.apply_patch)$",
       tags: ["rm", "delete", "trash", "recoverable", "guard", "safety", "bash"],
       rewritesInput: true,
-      timeoutSeconds: 5
+      timeoutSeconds: 10
     },
     {
       name: "checktests",
@@ -4500,6 +4501,139 @@ var init_resolve = __esm(() => {
   init_manifest();
 });
 
+// src/lib/native-safety.ts
+import { createHash } from "crypto";
+import { closeSync, constants, existsSync as existsSync7, fstatSync, lstatSync, openSync, readFileSync as readFileSync2, realpathSync as realpathSync2 } from "fs";
+import { dirname as dirname3, isAbsolute as isAbsolute2, join as join8 } from "path";
+import { homedir as homedir3 } from "os";
+function isNativeSafetyName(name) {
+  return name === "trash-guard" || name === "workspace-repos-guard";
+}
+function validateBinding(b) {
+  if (!b || !isNativeSafetyName(b.name) || ![b.runtime, b.worker, b.home].every((p) => typeof p === "string" && isAbsolute2(p) && !/[\0\r\n]/.test(p)) || ![b.runtimeSHA256, b.workerSHA256].every((h) => /^[0-9a-f]{64}$/.test(h)) || typeof b.path !== "string" || b.path.split(":").some((p) => !isAbsolute2(p) || /[\0\r\n]/.test(p)))
+    throw new Error("Invalid native safety binding");
+}
+function buildNativeSafetyCommand(binding) {
+  validateBinding(binding);
+  const encoded = Buffer.from(JSON.stringify(binding)).toString("base64url");
+  return prefix + [encoded, binding.runtime, binding.home, binding.path].map(quote).join(" ");
+}
+function nativeSafetyRegistration(command) {
+  if (!command.startsWith(prefix))
+    return;
+  const encoded = command.slice(prefix.length).match(/^'([A-Za-z0-9_-]+)' /)?.[1];
+  if (!encoded || encoded.length > 16384)
+    return;
+  try {
+    const binding = JSON.parse(Buffer.from(encoded, "base64url").toString("utf8"));
+    return buildNativeSafetyCommand(binding) === command ? binding.name : undefined;
+  } catch {
+    return;
+  }
+}
+function pinEligibleFile(file, maximum, executable = false) {
+  if (!isAbsolute2(file) || realpathSync2(file) !== file)
+    throw new Error("Native safety requires canonical files");
+  for (let parent = dirname3(file);; ) {
+    const s = lstatSync(parent);
+    if (!s.isDirectory() || ![0, process.getuid()].includes(s.uid) || s.mode & 18)
+      throw new Error("Native safety requires trusted, non-writable file ancestry");
+    if (parent === dirname3(parent))
+      break;
+    parent = dirname3(parent);
+  }
+  const fd = openSync(file, constants.O_RDONLY | constants.O_NOFOLLOW);
+  try {
+    const s = fstatSync(fd);
+    if (!s.isFile() || ![0, process.getuid()].includes(s.uid) || s.mode & 18 || s.size > maximum || executable && !(s.mode & 64))
+      throw new Error("Native safety requires an eligible installed file");
+    const bytes = readFileSync2(fd);
+    if (bytes.length > maximum)
+      throw new Error("Native safety file exceeds its bound");
+    return createHash("sha256").update(bytes).digest("hex");
+  } finally {
+    closeSync(fd);
+  }
+}
+function installedNativeSafetyCommand(name) {
+  const home = realpathSync2(homedir3());
+  const runtime = realpathSync2(process.execPath);
+  const candidates = [join8(import.meta.dir, "../../bin/native-safety-entry.js"), join8(import.meta.dir, "../bin/native-safety-entry.js"), join8(import.meta.dir, "native-safety-entry.js")];
+  const worker = candidates.find(existsSync7);
+  if (!worker)
+    throw new Error("Bundled native safety runner is missing; build or reinstall @hasna/hooks before installing its guards.");
+  const canonicalWorker = realpathSync2(worker);
+  return buildNativeSafetyCommand({ name, runtime, runtimeSHA256: pinEligibleFile(runtime, 200000000, true), worker: canonicalWorker, workerSHA256: pinEligibleFile(canonicalWorker, 256000), home, path: `${dirname3(runtime)}:${join8(home, ".bun/bin")}:/usr/local/bin:/usr/bin:/bin` });
+}
+var supervisorSource, quote = (value) => "'" + value.replaceAll("'", "'\\''") + "'", program2, shell, prefix;
+var init_native_safety = __esm(() => {
+  supervisorSource = String.raw`async function supervise(encoded) {
+  const fs = require("node:fs");
+  const path = require("node:path");
+  const crypto = require("node:crypto");
+  const cp = require("node:child_process");
+  const fail = () => { process.stderr.write("Native safety guard refused: verification or execution failed.\n"); process.exit(2); };
+  try {
+    const b = JSON.parse(Buffer.from(encoded, "base64url").toString("utf8"));
+    const check = (file, hash, maximum) => {
+      if (!path.isAbsolute(file) || fs.realpathSync(file) !== file) throw Error();
+      for (let parent = path.dirname(file);;) {
+        const s = fs.lstatSync(parent);
+        if (!s.isDirectory() || ![0, process.getuid()].includes(s.uid) || (s.mode & 0o022)) throw Error();
+        if (parent === path.dirname(parent)) break;
+        parent = path.dirname(parent);
+      }
+      const fd = fs.openSync(file, fs.constants.O_RDONLY | fs.constants.O_NOFOLLOW);
+      try {
+        const s = fs.fstatSync(fd);
+        if (!s.isFile() || ![0, process.getuid()].includes(s.uid) || (s.mode & 0o022) || s.size > maximum) throw Error();
+        const bytes = fs.readFileSync(fd);
+        if (crypto.createHash("sha256").update(bytes).digest("hex") !== hash) throw Error();
+        return bytes;
+      } finally { fs.closeSync(fd); }
+    };
+    check(b.runtime, b.runtimeSHA256, 200_000_000);
+    const bytes = check(b.worker, b.workerSHA256, 256_000);
+    const deadline = setTimeout(fail, 1500);
+    const chunks = []; let size = 0;
+    for await (const chunk of process.stdin) {
+      size += chunk.length;
+      if (size > 1_048_576) throw Error();
+      chunks.push(chunk);
+    }
+    clearTimeout(deadline);
+    const input = Buffer.concat(chunks);
+    const child = cp.spawnSync(b.runtime, ["--config=/dev/null", "--no-env-file", "--no-macros", "--no-install", "--eval", bytes.toString("utf8"), b.name], {
+      input, env: { HOME: b.home, PATH: b.path }, cwd: "/", timeout: 2500, killSignal: "SIGKILL", maxBuffer: 1_048_576,
+    });
+    if (child.error || child.status !== 0 || child.signal || child.stderr.length) throw Error();
+    const result = JSON.parse(child.stdout.toString("utf8"));
+    if (!result || Array.isArray(result) || Object.keys(result).length !== 1) throw Error();
+    if (result.verdict === null) return;
+    const output = result.verdict?.hookSpecificOutput;
+    if (!output || Object.keys(result.verdict).length !== 1 || output.hookEventName !== "PreToolUse") throw Error();
+    if (output.permissionDecision === "deny") {
+      if (Object.keys(output).sort().join() !== "hookEventName,permissionDecision,permissionDecisionReason" || typeof output.permissionDecisionReason !== "string" || !output.permissionDecisionReason.trim()) throw Error();
+    } else if (output.permissionDecision === "allow") {
+      if (b.name !== "trash-guard" || Object.keys(output).sort().join() !== "hookEventName,permissionDecision,updatedInput" || !output.updatedInput || typeof output.updatedInput.command !== "string" || !output.updatedInput.command.trim()) throw Error();
+    } else throw Error();
+    process.stdout.write(JSON.stringify(result.verdict));
+  } catch { fail(); }
+}`;
+  program2 = `(${supervisorSource})(process.argv[1]);`;
+  shell = `cd / || exit 2
+exec 3<&0 || exit 2
+/usr/bin/env -i HOME="$3" PATH="$4" "$2" --config=/dev/null --no-env-file --no-macros --no-install --eval ${quote(program2)} "$1" <&3 3<&- 2>/dev/null &
+runner=$!
+exec 3<&-
+(trap 'kill "$sleeper" 2>/dev/null; exit 0' TERM; /bin/sleep 6 & sleeper=$!; wait "$sleeper"; kill -KILL "$runner" 2>/dev/null) &
+watchdog=$!
+wait "$runner"; result=$?
+kill "$watchdog" 2>/dev/null; wait "$watchdog" 2>/dev/null
+if [ "$result" -ne 0 ]; then printf '%s\\n' 'Native safety guard refused: verification or execution failed.' >&2; exit 2; fi`;
+  prefix = `/usr/bin/env -i /bin/sh -c ${quote(shell)} hasna-native-safety-v1 `;
+});
+
 // src/lib/mementos-options.ts
 function validateMementosRegistration(name, value) {
   if (value === undefined)
@@ -4570,6 +4704,9 @@ function mementosRunEnvironment(env, value) {
 function registrationName(command) {
   if (typeof command !== "string")
     return;
+  const native = nativeSafetyRegistration(command);
+  if (native)
+    return native;
   if (/^hooks run mementos-context(?:\s|$)/.test(command.trim())) {
     try {
       retainedMementosRegistration([command.trim()]);
@@ -4662,8 +4799,7 @@ function hookRegisteredInSettings(settings, name, eventSpec, hookMatcher) {
   if (!Array.isArray(hooks))
     return false;
   return hooks.some((entry) => entry?.hooks?.some((h) => {
-    const match = h?.command?.match(/^hooks run ([\w-]+)/);
-    if (!match || match[1] !== name)
+    if (registrationName(h?.command) !== name)
       return false;
     if (!matcher)
       return true;
@@ -4675,6 +4811,7 @@ function hookRegisteredInSettings(settings, name, eventSpec, hookMatcher) {
 }
 var REGISTRATION_COMMAND_RE;
 var init_registration = __esm(() => {
+  init_native_safety();
   init_resolve();
   REGISTRATION_COMMAND_RE = /^(?:hooks run ([\w-]+)(?:\s+--profile\s+[\w-]+)?|hook-([\w-]+))$/;
 });
@@ -4873,9 +5010,9 @@ var init_migrations = __esm(() => {
 });
 
 // src/db/legacy-import.ts
-import { existsSync as existsSync7, readdirSync as readdirSync2, readFileSync as readFileSync2 } from "fs";
-import { join as join8 } from "path";
-import { homedir as homedir3 } from "os";
+import { existsSync as existsSync8, readdirSync as readdirSync2, readFileSync as readFileSync3 } from "fs";
+import { join as join9 } from "path";
+import { homedir as homedir4 } from "os";
 function ensureMetaTable(db) {
   db.exec(`
     CREATE TABLE IF NOT EXISTS _meta (
@@ -4898,7 +5035,7 @@ function nanoid() {
 function importJsonlFile(db, filePath) {
   let count = 0;
   try {
-    const lines = readFileSync2(filePath, "utf-8").split(`
+    const lines = readFileSync3(filePath, "utf-8").split(`
 `).filter(Boolean);
     for (const line of lines) {
       try {
@@ -4924,7 +5061,7 @@ function importJsonlFile(db, filePath) {
 function importErrorsLog(db, filePath) {
   let count = 0;
   try {
-    const lines = readFileSync2(filePath, "utf-8").split(`
+    const lines = readFileSync3(filePath, "utf-8").split(`
 `).filter(Boolean);
     const linePattern = /^\[(.+?)\]\s+(?:\[session:(\S+)\]\s+)?(.+?)\s+\u2014\s+(.+)$/;
     for (const line of lines) {
@@ -4949,25 +5086,25 @@ function importErrorsLog(db, filePath) {
   } catch {}
   return count;
 }
-function runLegacyImport(db, homeDir = homedir3()) {
+function runLegacyImport(db, homeDir = homedir4()) {
   try {
     if (isAlreadyDone(db))
       return;
     let total = 0;
-    const claudeProjectsDir = join8(homeDir, ".claude", "projects");
-    if (existsSync7(claudeProjectsDir)) {
+    const claudeProjectsDir = join9(homeDir, ".claude", "projects");
+    if (existsSync8(claudeProjectsDir)) {
       try {
         const projectDirs = readdirSync2(claudeProjectsDir);
         for (const dir of projectDirs) {
-          const projectDir = join8(claudeProjectsDir, dir);
+          const projectDir = join9(claudeProjectsDir, dir);
           try {
             const files = readdirSync2(projectDir);
             for (const file of files) {
               if (file.match(/^session-log-\d{4}-\d{2}-\d{2}\.jsonl$/)) {
-                total += importJsonlFile(db, join8(projectDir, file));
+                total += importJsonlFile(db, join9(projectDir, file));
               }
               if (file === "errors.log") {
-                total += importErrorsLog(db, join8(projectDir, file));
+                total += importErrorsLog(db, join9(projectDir, file));
               }
             }
           } catch {}
@@ -5014,8 +5151,8 @@ __export(exports_db, {
   allowLocalStore: () => allowLocalStore
 });
 import { Database } from "bun:sqlite";
-import { existsSync as existsSync8, mkdirSync as mkdirSync2, cpSync } from "fs";
-import { join as join9 } from "path";
+import { existsSync as existsSync9, mkdirSync as mkdirSync2, cpSync } from "fs";
+import { join as join10 } from "path";
 function refuseLocalStore(message) {
   localStoreRefusal = message;
 }
@@ -5030,8 +5167,8 @@ function localStoreRefusalMessage() {
 }
 function resolveDataDir() {
   const effective = getEffectiveDataRoot();
-  const oldDir = join9(getHomeDir(), ".hooks");
-  if (!existsSync8(effective) && existsSync8(oldDir)) {
+  const oldDir = join10(getHomeDir(), ".hooks");
+  if (!existsSync9(effective) && existsSync9(oldDir)) {
     mkdirSync2(effective, { recursive: true });
     cpSync(oldDir, effective, { recursive: true });
   }
@@ -5042,11 +5179,11 @@ function getDbPath() {
   if (explicitDb)
     return explicitDb;
   const dataDir3 = resolveDataDir();
-  return join9(dataDir3, "hooks.db");
+  return join10(dataDir3, "hooks.db");
 }
 function ensureDir(dbPath) {
   const dir = dbPath.substring(0, dbPath.lastIndexOf("/"));
-  if (dir && !existsSync8(dir)) {
+  if (dir && !existsSync9(dir)) {
     mkdirSync2(dir, { recursive: true });
   }
 }
@@ -5056,7 +5193,7 @@ function getDb() {
   if (instance)
     return instance;
   const dbPath = getDbPath();
-  const isNew = dbPath === ":memory:" || !existsSync8(dbPath);
+  const isNew = dbPath === ":memory:" || !existsSync9(dbPath);
   ensureDir(dbPath);
   instance = new Database(dbPath);
   instance.exec("PRAGMA busy_timeout=5000");
@@ -5118,12 +5255,12 @@ __export(exports_store, {
   checkScriptHash: () => checkScriptHash,
   LockFileError: () => LockFileError
 });
-import { createHash } from "crypto";
-import { existsSync as existsSync9, mkdirSync as mkdirSync3, readFileSync as readFileSync3, writeFileSync as writeFileSync2, renameSync } from "fs";
+import { createHash as createHash2 } from "crypto";
+import { existsSync as existsSync10, mkdirSync as mkdirSync3, readFileSync as readFileSync4, writeFileSync as writeFileSync2, renameSync } from "fs";
 import { readFile as readFile2 } from "fs/promises";
 import { randomBytes } from "crypto";
 function sha256Of(input) {
-  return createHash("sha256").update(input).digest("hex");
+  return createHash2("sha256").update(input).digest("hex");
 }
 async function sha256File(path) {
   const buf = await readFile2(path);
@@ -5184,11 +5321,11 @@ function assertLockShape(parsed, path) {
 }
 function readLock() {
   const path = getLockPath();
-  if (!existsSync9(path))
+  if (!existsSync10(path))
     return { hooks: {} };
   let raw;
   try {
-    raw = readFileSync3(path, "utf-8");
+    raw = readFileSync4(path, "utf-8");
   } catch {
     throw new LockFileError(`hooks.lock (${path}) could not be read. Repair: fix permissions or move the file aside and run 'hooks sync'.`);
   }
@@ -5291,7 +5428,7 @@ async function verifyScriptHash(name, scriptPath) {
   return checkScriptHash(name, await sha256File(scriptPath));
 }
 function retrustHook(name, scriptPath, version, source) {
-  const actual = sha256Of(readFileSync3(scriptPath));
+  const actual = sha256Of(readFileSync4(scriptPath));
   const db = storeDb();
   if (db) {
     upsertHookRecord(db, {
@@ -5318,15 +5455,15 @@ var init_store = __esm(() => {
 });
 
 // src/lib/codex-settings.ts
-import { closeSync, existsSync as existsSync10, lstatSync, mkdirSync as mkdirSync4, openSync, readFileSync as readFileSync4, renameSync as renameSync2, unlinkSync, writeFileSync as writeFileSync3 } from "fs";
-import { dirname as dirname3 } from "path";
+import { closeSync as closeSync2, existsSync as existsSync11, lstatSync as lstatSync2, mkdirSync as mkdirSync4, openSync as openSync2, readFileSync as readFileSync5, renameSync as renameSync2, unlinkSync, writeFileSync as writeFileSync3 } from "fs";
+import { dirname as dirname4 } from "path";
 import { randomUUID as randomUUID3 } from "crypto";
 function current(path) {
   try {
-    const stat = lstatSync(path);
+    const stat = lstatSync2(path);
     if (!stat.isFile() || stat.isSymbolicLink() || stat.size > 1048576)
       throw new Error("invalid_file");
-    return readFileSync4(path, "utf8");
+    return readFileSync5(path, "utf8");
   } catch (error) {
     if (error.code === "ENOENT")
       return null;
@@ -5358,11 +5495,11 @@ function writeCodexSettings(path, settings) {
   const snapshot = snapshots.get(settings);
   if (!snapshot || snapshot.path !== path)
     throw new Error("Codex settings require a complete current read before writing.");
-  mkdirSync4(dirname3(path), { recursive: true });
+  mkdirSync4(dirname4(path), { recursive: true });
   const lock = `${path}.hooks-write.lock`;
   let fd;
   try {
-    fd = openSync(lock, "wx", 384);
+    fd = openSync2(lock, "wx", 384);
   } catch {
     throw new Error("Codex settings are being edited; retry after the active writer finishes.");
   }
@@ -5378,9 +5515,9 @@ function writeCodexSettings(path, settings) {
     renameSync2(temp, path);
     snapshots.set(settings, { path, raw: next });
   } finally {
-    if (existsSync10(temp))
+    if (existsSync11(temp))
       unlinkSync(temp);
-    closeSync(fd);
+    closeSync2(fd);
     unlinkSync(lock);
   }
 }
@@ -5409,9 +5546,9 @@ __export(exports_installer, {
   detectRewriteConflict: () => detectRewriteConflict,
   buildCodewithTomlFragment: () => buildCodewithTomlFragment
 });
-import { existsSync as existsSync11, mkdirSync as mkdirSync5, readFileSync as readFileSync5, readdirSync as readdirSync3, rmdirSync, unlinkSync as unlinkSync2, writeFileSync as writeFileSync4 } from "fs";
-import { join as join10, dirname as dirname4 } from "path";
-import { homedir as homedir4 } from "os";
+import { existsSync as existsSync12, mkdirSync as mkdirSync5, readFileSync as readFileSync6, readdirSync as readdirSync3, rmdirSync, unlinkSync as unlinkSync2, writeFileSync as writeFileSync4 } from "fs";
+import { join as join11, dirname as dirname5 } from "path";
+import { homedir as homedir5 } from "os";
 import { fileURLToPath as fileURLToPath2 } from "url";
 function normalizeHookName(name) {
   return name.startsWith("hook-") ? name : `hook-${name}`;
@@ -5424,8 +5561,7 @@ function removeHookEntriesByName(entries, hookName) {
     if (!Array.isArray(entry.hooks))
       return [entry];
     const kept = entry.hooks.filter((h) => {
-      const match = h.command?.match(/^hooks run ([\w-]+)/);
-      return !(match && match[1] === hookName);
+      return registrationName(h.command) !== hookName;
     });
     return kept.length === entry.hooks.length ? [entry] : kept.length ? [{ ...entry, hooks: kept }] : [];
   });
@@ -5459,29 +5595,29 @@ function getSettingsPath(scope = "global", target = "claude", codewithConfigPath
     return globalOverride;
   const dir = getTargetSettingsDir(target);
   if (target === "codex")
-    return join10(scope === "project" ? process.cwd() : homedir4(), dir, "hooks.json");
+    return join11(scope === "project" ? process.cwd() : homedir5(), dir, "hooks.json");
   if (scope === "project") {
-    return target === "codewith" ? join10(process.cwd(), dir, "config.toml") : join10(process.cwd(), dir, "settings.json");
+    return target === "codewith" ? join11(process.cwd(), dir, "config.toml") : join11(process.cwd(), dir, "settings.json");
   }
-  return target === "codewith" ? join10(homedir4(), dir, "config.toml") : join10(homedir4(), dir, "settings.json");
+  return target === "codewith" ? join11(homedir5(), dir, "config.toml") : join11(homedir5(), dir, "settings.json");
 }
 function getHookPath(name) {
   const shortName = shortHookName(name);
   const resolved = resolveHookDir(shortName);
   if (resolved)
     return resolved;
-  return join10(HOOKS_DIR, normalizeHookName(shortName));
+  return join11(HOOKS_DIR, normalizeHookName(shortName));
 }
 function hookExists(name) {
-  return existsSync11(getHookPath(name));
+  return existsSync12(getHookPath(name));
 }
 function readSettings(scope = "global", target = "claude") {
   const path = getSettingsPath(scope, target);
   if (target === "codex")
     return readCodexSettings(path);
   try {
-    if (existsSync11(path)) {
-      return JSON.parse(readFileSync5(path, "utf-8"));
+    if (existsSync12(path)) {
+      return JSON.parse(readFileSync6(path, "utf-8"));
     }
   } catch (error) {
     console.warn(`[hooks] Failed to read settings at ${path}: ${error instanceof Error ? error.message : String(error)}`);
@@ -5492,8 +5628,8 @@ function writeSettings(settings, scope = "global", target = "claude") {
   const path = getSettingsPath(scope, target);
   if (target === "codex")
     return writeCodexSettings(path, settings);
-  const dir = dirname4(path);
-  if (!existsSync11(dir)) {
+  const dir = dirname5(path);
+  if (!existsSync12(dir)) {
     mkdirSync5(dir, { recursive: true });
   }
   writeFileSync4(path, JSON.stringify(settings, null, 2) + `
@@ -5521,6 +5657,9 @@ function codewithTimeout(name) {
   switch (name) {
     case "mementos-context":
       return 12;
+    case "trash-guard":
+    case "workspace-repos-guard":
+      return 10;
     case "knowledge-context":
       return 6;
     case "session-start":
@@ -5530,7 +5669,6 @@ function codewithTimeout(name) {
     case "prompt-guard":
       return 3;
     case "worktree-guard":
-    case "trash-guard":
     case "stop-sync":
       return 5;
     default:
@@ -5559,11 +5697,13 @@ function codewithStatusMessage(name) {
 }
 function buildCodewithTomlFragment(name, profile, mementos) {
   const shortName = shortHookName(name);
-  const meta = resolveHookMeta(shortName);
+  if (isNativeSafetyName(shortName) && profile)
+    throw new Error("Bundled native safety guards do not select registry profiles");
+  const meta = isNativeSafetyName(shortName) ? getHook(shortName) : resolveHookMeta(shortName);
   if (!meta)
     throw new Error(`Hook '${shortName}' not found`);
   validateMementosRegistration(shortName, mementos);
-  const command = (profile ? `hooks run ${shortName} --profile ${profile}` : `hooks run ${shortName}`) + mementosCommandSuffix(mementos);
+  const command = isNativeSafetyName(shortName) ? installedNativeSafetyCommand(shortName) : (profile ? `hooks run ${shortName} --profile ${profile}` : `hooks run ${shortName}`) + mementosCommandSuffix(mementos);
   const matcher = codewithMatcher(meta.matcher);
   const fragments = [];
   for (const event of getHookEvents(meta)) {
@@ -5588,17 +5728,17 @@ function buildCodewithTomlFragment(name, profile, mementos) {
 function readCodewithConfig(scope, configPath) {
   const path = getSettingsPath(scope, "codewith", configPath);
   try {
-    return existsSync11(path) ? readFileSync5(path, "utf-8") : "";
+    return existsSync12(path) ? readFileSync6(path, "utf-8") : "";
   } catch {
     return "";
   }
 }
 function appendCodewithFragment(fragment, scope, configPath) {
   const path = getSettingsPath(scope, "codewith", configPath);
-  const dir = dirname4(path);
-  if (!existsSync11(dir))
+  const dir = dirname5(path);
+  if (!existsSync12(dir))
     mkdirSync5(dir, { recursive: true });
-  const existing = existsSync11(path) ? readFileSync5(path, "utf-8") : "";
+  const existing = existsSync12(path) ? readFileSync6(path, "utf-8") : "";
   const sep2 = existing.trim() ? `
 
 ` : "";
@@ -5606,7 +5746,7 @@ function appendCodewithFragment(fragment, scope, configPath) {
   return path;
 }
 function detectConflict(name, scope, target) {
-  const meta = resolveHookMeta(name);
+  const meta = isNativeSafetyName(name) ? getHook(name) : resolveHookMeta(name);
   if (!meta || !meta.matcher)
     return;
   const events = new Set(getHookEvents(meta));
@@ -5626,7 +5766,7 @@ function detectConflict(name, scope, target) {
   return;
 }
 function detectRewriteConflict(name, scope, target, lookup = getHook) {
-  const meta = resolveHookMeta(name);
+  const meta = isNativeSafetyName(name) ? getHook(name) : resolveHookMeta(name);
   if (!meta?.matcher || !meta.rewritesInput)
     return;
   if (!getHookEvents(meta).includes("PreToolUse"))
@@ -5647,7 +5787,10 @@ function detectRewriteConflict(name, scope, target, lookup = getHook) {
 }
 function installForTarget(name, scope, overwrite, target, profile, codewithMode = "fragment", codewithConfigPath, mementos) {
   const shortName = shortHookName(name);
-  if (!hookExists(shortName)) {
+  if (isNativeSafetyName(shortName) && (profile || target === "gemini" || target === "codewith" && codewithMode === "write")) {
+    return { hook: shortName, success: false, error: "Bundled native safety guards support Claude/Codex and managed Codewith fragments, without registry profiles.", target };
+  }
+  if (!isNativeSafetyName(shortName) && !hookExists(shortName)) {
     return { hook: shortName, success: false, error: `Hook '${shortName}' not found`, target };
   }
   if (target === "codewith") {
@@ -5739,7 +5882,7 @@ function installHook(name, options = {}) {
   }
   if (target === "all") {
     const shortName = shortHookName(name);
-    const meta = resolveHookMeta(shortName);
+    const meta = isNativeSafetyName(shortName) ? getHook(shortName) : resolveHookMeta(shortName);
     if (meta) {
       const unsupportedTargets = ["claude", "codewith"].filter((agentTarget) => getHookEvents(meta).some((event) => !isEventSupported(event, agentTarget)));
       if (unsupportedTargets.length > 0) {
@@ -5772,7 +5915,7 @@ function installHook(name, options = {}) {
   return installForTarget(name, scope, overwrite, target, profile, codewithMode, codewithConfigPath, mementos);
 }
 function registerHook(name, scope = "global", target = "claude", profile, mementos) {
-  const meta = resolveHookMeta(name);
+  const meta = isNativeSafetyName(name) ? getHook(name) : resolveHookMeta(name);
   if (!meta)
     return;
   const eventKeys = getHookEvents(meta).map((event) => {
@@ -5789,8 +5932,17 @@ function registerHook(name, scope = "global", target = "claude", profile, mement
   const settings = readSettings(scope, target);
   if (!settings.hooks)
     settings.hooks = {};
+  if (isNativeSafetyName(name)) {
+    for (const groups of Object.values(settings.hooks))
+      for (const group of groups)
+        for (const hook of group.hooks ?? []) {
+          if (typeof hook.command === "string" && /(?:^|\s)hasna-native-safety-v\d+(?:\s|$)/.test(hook.command) && !registrationName(hook.command)) {
+            throw new Error("Unknown managed safety definition; reconcile its exact version before replacing it.");
+          }
+        }
+  }
   const retained = name === "mementos-context" && mementos === undefined ? retainedMementosRegistration(Object.values(settings.hooks).flatMap((groups) => Array.isArray(groups) ? groups.flatMap((group) => Array.isArray(group.hooks) ? group.hooks.map((hook) => hook.command).filter((command) => typeof command === "string") : []) : [])) : undefined;
-  const hookCommand = (profile ? `hooks run ${name} --profile ${profile}` : `hooks run ${name}`) + mementosCommandSuffix(mementos ?? retained);
+  const hookCommand = isNativeSafetyName(name) ? installedNativeSafetyCommand(name) : (profile ? `hooks run ${name} --profile ${profile}` : `hooks run ${name}`) + mementosCommandSuffix(mementos ?? retained);
   if (target === "codex") {
     const positions = [];
     for (const [event, groups] of Object.entries(settings.hooks)) {
@@ -5798,9 +5950,11 @@ function registerHook(name, scope = "global", target = "claude", profile, mement
         for (let index = 0;index < entry.hooks.length; index++) {
           const command = entry.hooks[index]?.command;
           const match = typeof command === "string" && command.trim().match(/^(?:hooks run ([\w-]+)(?:\s|$)|hook-([\w-]+)$)/);
-          if (match && (match[1] ?? match[2]) === name) {
+          if (match && (match[1] ?? match[2]) === name || registrationName(command) === name) {
             if (registrationName(command) !== name)
               throw new Error("Unrecognized Codex registration; reconcile it before updating this hook.");
+            if (isNativeSafetyName(name) && entry.hooks[index].async !== undefined && entry.hooks[index].async !== false)
+              throw new Error("Asynchronous safety hooks cannot block; reconcile this registration before updating it.");
             positions.push({ event, entry, index });
           }
         }
@@ -5864,12 +6018,20 @@ function getRegisteredHooksForTarget(scope = "global", target = "claude") {
   if (target === "codewith") {
     const config = readCodewithConfig(scope);
     const registered2 = [];
-    const re = /^\s*command\s*=\s*["']([^"'\n]+)["']\s*$/gm;
-    let match;
-    while (match = re.exec(config)) {
-      const name = registrationName(match[1]);
-      if (name)
-        registered2.push(name);
+    try {
+      const parsed = Bun.TOML.parse(config);
+      for (const groups of Object.values(parsed.hooks ?? {})) {
+        if (!Array.isArray(groups))
+          continue;
+        for (const group of groups)
+          for (const hook of group.hooks ?? []) {
+            const name = registrationName(hook.command);
+            if (name)
+              registered2.push(name);
+          }
+      }
+    } catch {
+      return [];
     }
     return [...new Set(registered2)];
   }
@@ -5914,9 +6076,9 @@ function removeHookForTarget(name, scope, target) {
 }
 function readSettingsAt(path) {
   try {
-    if (!existsSync11(path))
+    if (!existsSync12(path))
       return;
-    const raw = readFileSync5(path, "utf-8");
+    const raw = readFileSync6(path, "utf-8");
     return { raw, settings: JSON.parse(raw) };
   } catch {
     return;
@@ -5950,7 +6112,7 @@ function pruneStaleRegistrations(scope = "global") {
       staleCommandsByEvent.set(finding.event, commands);
     }
     const settings = target === "codex" ? readCodexSettings(path) : parsed.settings;
-    if (target === "codex" && readFileSync5(path, "utf8") !== parsed.raw)
+    if (target === "codex" && readFileSync6(path, "utf8") !== parsed.raw)
       throw new Error("Codex settings changed before pruning; retry.");
     for (const [eventKey, commands] of staleCommandsByEvent) {
       const entries = settings.hooks?.[eventKey];
@@ -6038,10 +6200,10 @@ function codewithHasHookEntryInText(configText, name) {
 }
 function codewithHasHookEntry(name, scope = "global") {
   const path = getSettingsPath(scope, "codewith");
-  if (!existsSync11(path))
+  if (!existsSync12(path))
     return false;
   try {
-    return codewithHasHookEntryInText(readFileSync5(path, "utf-8"), name);
+    return codewithHasHookEntryInText(readFileSync6(path, "utf-8"), name);
   } catch {
     return false;
   }
@@ -6050,12 +6212,12 @@ function removeStoreDirFailClosed(dir) {
   const entries = readdirSync3(dir, { withFileTypes: true });
   for (const entry of entries) {
     if (entry.isDirectory()) {
-      removeStoreDirFailClosed(join10(dir, entry.name));
+      removeStoreDirFailClosed(join11(dir, entry.name));
     }
   }
   for (const entry of entries) {
     if (!entry.isDirectory()) {
-      unlinkSync2(join10(dir, entry.name));
+      unlinkSync2(join11(dir, entry.name));
     }
   }
   rmdirSync(dir);
@@ -6086,8 +6248,8 @@ function uninstallHook(name, scope = "global", target = "claude") {
   const registrationsRemaining = [];
   if (target === "codewith" || target === "all") {
     const codewithPath = getSettingsPath(scope, "codewith");
-    if (existsSync11(codewithPath)) {
-      const before = readFileSync5(codewithPath, "utf-8");
+    if (existsSync12(codewithPath)) {
+      const before = readFileSync6(codewithPath, "utf-8");
       const after = removeCodewithHookEntry(before, shortName);
       if (after.removed) {
         writeFileSync4(codewithPath, after.text, "utf-8");
@@ -6134,8 +6296,9 @@ var init_installer = __esm(() => {
   init_registration();
   init_store();
   init_codex_settings();
-  __dirname2 = dirname4(fileURLToPath2(import.meta.url));
-  HOOKS_DIR = existsSync11(join10(__dirname2, "..", "..", "hooks", "hook-gitguard")) ? join10(__dirname2, "..", "..", "hooks") : join10(__dirname2, "..", "hooks");
+  init_native_safety();
+  __dirname2 = dirname5(fileURLToPath2(import.meta.url));
+  HOOKS_DIR = existsSync12(join11(__dirname2, "..", "..", "hooks", "hook-gitguard")) ? join11(__dirname2, "..", "..", "hooks") : join11(__dirname2, "..", "hooks");
   EVENT_MAP = {
     claude: {
       PreToolUse: "PreToolUse",
@@ -6248,12 +6411,12 @@ var init_redact = __esm(() => {
 });
 
 // src/lib/profiles.ts
-import { existsSync as existsSync12, mkdirSync as mkdirSync6, readFileSync as readFileSync6, writeFileSync as writeFileSync5, readdirSync as readdirSync4, rmSync, cpSync as cpSync2 } from "fs";
-import { join as join11 } from "path";
+import { existsSync as existsSync13, mkdirSync as mkdirSync6, readFileSync as readFileSync7, writeFileSync as writeFileSync5, readdirSync as readdirSync4, rmSync, cpSync as cpSync2 } from "fs";
+import { join as join12 } from "path";
 function getProfilesDir() {
-  const newDir = join11(getEffectiveDataRoot(), "profiles");
-  const oldDir = join11(getHomeDir(), ".hooks", "profiles");
-  if (!existsSync12(newDir) && existsSync12(oldDir)) {
+  const newDir = join12(getEffectiveDataRoot(), "profiles");
+  const oldDir = join12(getHomeDir(), ".hooks", "profiles");
+  if (!existsSync13(newDir) && existsSync13(oldDir)) {
     mkdirSync6(newDir, { recursive: true });
     cpSync2(oldDir, newDir, { recursive: true });
   }
@@ -6261,12 +6424,12 @@ function getProfilesDir() {
 }
 function ensureProfilesDir() {
   const dir = getProfilesDir();
-  if (!existsSync12(dir)) {
+  if (!existsSync13(dir)) {
     mkdirSync6(dir, { recursive: true });
   }
 }
 function profilePath(id) {
-  return join11(getProfilesDir(), `${id}.json`);
+  return join12(getProfilesDir(), `${id}.json`);
 }
 function shortUuid() {
   return crypto.randomUUID().slice(0, 8);
@@ -6292,23 +6455,23 @@ function createProfile(input) {
 function getProfile(id) {
   const path = profilePath(id);
   try {
-    if (!existsSync12(path))
+    if (!existsSync13(path))
       return null;
-    return JSON.parse(readFileSync6(path, "utf-8"));
+    return JSON.parse(readFileSync7(path, "utf-8"));
   } catch {
     return null;
   }
 }
 function listProfiles() {
   const dir = getProfilesDir();
-  if (!existsSync12(dir))
+  if (!existsSync13(dir))
     return [];
   try {
     const files = readdirSync4(dir).filter((f) => f.endsWith(".json"));
     const profiles = [];
     for (const file of files) {
       try {
-        const content = readFileSync6(join11(dir, file), "utf-8");
+        const content = readFileSync7(join12(dir, file), "utf-8");
         profiles.push(JSON.parse(content));
       } catch {}
     }
@@ -6338,7 +6501,7 @@ function importProfiles(profiles) {
       continue;
     }
     const path = profilePath(profile.agent_id);
-    if (existsSync12(path)) {
+    if (existsSync13(path)) {
       skipped++;
       continue;
     }
@@ -6355,15 +6518,15 @@ var init_profiles = __esm(() => {
 // ../contracts/dist/client/transport.js
 import { isIP as isIP2 } from "net";
 import { spawnSync } from "child_process";
-import { closeSync as closeSync2, fstatSync as fstatSync2, openSync as openSync2, readFileSync as readFileSync22 } from "fs";
+import { closeSync as closeSync22, fstatSync as fstatSync2, openSync as openSync22, readFileSync as readFileSync22 } from "fs";
 import { O_NOFOLLOW as O_NOFOLLOW2, O_NONBLOCK as O_NONBLOCK2, O_RDONLY as O_RDONLY2 } from "constants";
 import { hostname as osHostname } from "os";
-import { isAbsolute as isAbsolute2, join as join22 } from "path";
+import { isAbsolute as isAbsolute3, join as join22 } from "path";
 import { createRequire as createRequire2 } from "module";
 import { fileURLToPath as fileURLToPath22 } from "url";
-import { closeSync as closeSync3, fstatSync, lstatSync as lstatSync2, openSync as openSync3, readFileSync as readFileSync7, realpathSync as realpathSync2, statSync } from "fs";
+import { closeSync as closeSync3, fstatSync as fstatSync3, lstatSync as lstatSync3, openSync as openSync3, readFileSync as readFileSync8, realpathSync as realpathSync3, statSync } from "fs";
 import { O_NOFOLLOW, O_NONBLOCK, O_RDONLY } from "constants";
-import { basename as basename2, dirname as dirname5, join as join12, relative, sep as sep2 } from "path";
+import { basename as basename2, dirname as dirname6, join as join13, relative, sep as sep2 } from "path";
 import { fileURLToPath as fileURLToPath3, pathToFileURL } from "url";
 function envToken(name) {
   return name.toUpperCase().replace(/-/g, "_");
@@ -6437,14 +6600,14 @@ function o(e2, r2, t2) {
   }
 }
 function entryPoint(directory) {
-  const root = realpathSync2(directory);
-  const fd = openSync3(join12(root, "package.json"), O_RDONLY | O_NOFOLLOW | O_NONBLOCK);
+  const root = realpathSync3(directory);
+  const fd = openSync3(join13(root, "package.json"), O_RDONLY | O_NOFOLLOW | O_NONBLOCK);
   let pkg;
   try {
-    const stat = fstatSync(fd);
+    const stat = fstatSync3(fd);
     if (!stat.isFile() || stat.size > MAX_PACKAGE_BYTES2)
       throw new Error("Invalid Secrets package metadata");
-    pkg = JSON.parse(readFileSync7(fd, "utf8"));
+    pkg = JSON.parse(readFileSync8(fd, "utf8"));
   } finally {
     closeSync3(fd);
   }
@@ -6458,7 +6621,7 @@ function entryPoint(directory) {
   if (/[\\%?#\0]/.test(target) || parts.some((part) => !part || part === "." || part === ".." || part === "node_modules")) {
     throw new Error("Invalid Secrets import export");
   }
-  const file = realpathSync2(join12(root, ...parts));
+  const file = realpathSync3(join13(root, ...parts));
   const within = relative(root, file);
   if (!within || within === ".." || within.startsWith(`..${sep2}`) || !statSync(file).isFile()) {
     throw new Error("Secrets import export escapes its package or is not a file");
@@ -6466,13 +6629,13 @@ function entryPoint(directory) {
   return pathToFileURL(file).href;
 }
 function resolveInstalledSecrets(parentUrl) {
-  let directory = dirname5(fileURLToPath3(parentUrl));
+  let directory = dirname6(fileURLToPath3(parentUrl));
   for (;; ) {
     if (basename2(directory) !== "node_modules") {
-      const candidate = join12(directory, "node_modules", PACKAGE);
+      const candidate = join13(directory, "node_modules", PACKAGE);
       let absent = false;
       try {
-        lstatSync2(candidate);
+        lstatSync3(candidate);
       } catch (error) {
         if (error.code !== "ENOENT")
           throw error;
@@ -6481,7 +6644,7 @@ function resolveInstalledSecrets(parentUrl) {
       if (!absent)
         return entryPoint(candidate);
     }
-    const parent = dirname5(directory);
+    const parent = dirname6(directory);
     if (parent === directory)
       throw new Error("Secrets SDK is not installed for this consumer");
     directory = parent;
@@ -6493,7 +6656,7 @@ function homeDir(env) {
 }
 function absoluteOverride(env, key) {
   const value = env[key]?.trim();
-  return value && isAbsolute2(value) ? value : null;
+  return value && isAbsolute3(value) ? value : null;
 }
 function hasnaHomeDir(env) {
   const override = absoluteOverride(env, HASNA_HOME_ENV_KEY);
@@ -6539,9 +6702,9 @@ function parseEnvFile(text) {
     if (!/^[A-Za-z_][A-Za-z0-9_]*$/.test(key))
       continue;
     let value = withoutExport.slice(equals + 1).trim();
-    const quote = value[0];
-    if (quote === '"' || quote === "'") {
-      if (value.length < 2 || !value.endsWith(quote)) {
+    const quote2 = value[0];
+    if (quote2 === '"' || quote2 === "'") {
+      if (value.length < 2 || !value.endsWith(quote2)) {
         unusable.add(key);
         continue;
       }
@@ -6570,7 +6733,7 @@ function readAppConfigFile(path) {
   };
   let fd = -1;
   try {
-    fd = openSync2(path, O_RDONLY2 | O_NOFOLLOW2 | O_NONBLOCK2);
+    fd = openSync22(path, O_RDONLY2 | O_NOFOLLOW2 | O_NONBLOCK2);
   } catch (error) {
     const code = error.code;
     if (code === "ENOENT" || code === "ENOTDIR")
@@ -6599,7 +6762,7 @@ function readAppConfigFile(path) {
     return parseEnvFile(bytes.toString("utf8"));
   } finally {
     if (fd !== -1)
-      closeSync2(fd);
+      closeSync22(fd);
   }
 }
 function readCredentialFile(path, apiKeyKeys, pointerKey) {
@@ -7600,12 +7763,12 @@ var init_db_writer = __esm(() => {
 });
 
 // src/lib/hook-env.ts
-import { dirname as dirname6, isAbsolute as isAbsolute3 } from "path";
-import { existsSync as existsSync13, realpathSync as realpathSync3, statSync as statSync2 } from "fs";
+import { dirname as dirname7, isAbsolute as isAbsolute4 } from "path";
+import { existsSync as existsSync14, realpathSync as realpathSync4, statSync as statSync2 } from "fs";
 import { tmpdir } from "os";
 function isDeniedEnvName(name) {
   const upper = name.toUpperCase();
-  if (DENY_PREFIXES.some((prefix) => upper.startsWith(prefix)))
+  if (DENY_PREFIXES.some((prefix2) => upper.startsWith(prefix2)))
     return true;
   if (DENY_SUFFIXES.some((suffix) => upper.endsWith(suffix)))
     return true;
@@ -7614,13 +7777,13 @@ function isDeniedEnvName(name) {
 function isInterpreterInjectionEnvName(name) {
   if (INTERPRETER_INJECTION.has(name))
     return true;
-  return INTERPRETER_INJECTION_PREFIXES.some((prefix) => name.startsWith(prefix));
+  return INTERPRETER_INJECTION_PREFIXES.some((prefix2) => name.startsWith(prefix2));
 }
 function isBashFunctionEnvName(name) {
   return name.startsWith("BASH_FUNC_");
 }
 function isUnsafePathEntry(entry, home) {
-  if (entry === "" || !isAbsolute3(entry))
+  if (entry === "" || !isAbsolute4(entry))
     return true;
   if (home && (entry === home || entry.startsWith(home + "/")))
     return true;
@@ -7630,7 +7793,7 @@ function isUnsafePathEntry(entry, home) {
     return true;
   const canonical = (path) => {
     try {
-      return realpathSync3(path);
+      return realpathSync4(path);
     } catch {
       return path;
     }
@@ -7649,9 +7812,9 @@ function isUnsafePathEntry(entry, home) {
 }
 function sanitizeHookPath(pathValue, home) {
   const baseline = PATH_BASELINE.slice();
-  if (process.platform === "darwin" && existsSync13("/opt/homebrew/bin"))
+  if (process.platform === "darwin" && existsSync14("/opt/homebrew/bin"))
     baseline.push("/opt/homebrew/bin");
-  const bunDir = dirname6(process.execPath);
+  const bunDir = dirname7(process.execPath);
   const seen = new Set;
   const out = [];
   for (const dir of baseline) {
@@ -7776,7 +7939,7 @@ __export(exports_run, {
 });
 import { randomBytes as randomBytes2 } from "crypto";
 import { rmSync as rmSync2, writeFileSync as writeFileSync6 } from "fs";
-import { basename as basename3, dirname as dirname7, isAbsolute as isAbsolute4, join as join13 } from "path";
+import { basename as basename3, dirname as dirname8, isAbsolute as isAbsolute5, join as join14 } from "path";
 function extensionOf(scriptPath) {
   const base = basename3(scriptPath);
   const dot = base.lastIndexOf(".");
@@ -7845,9 +8008,9 @@ async function readPipeWithDeadline(stream, deadlineMs) {
   return chunks.join("");
 }
 async function executeVerifiedScript(options) {
-  const scriptDir = dirname7(options.scriptPath);
+  const scriptDir = dirname8(options.scriptPath);
   const interpreter = interpreterFor(options.name, options.scriptPath, options.content);
-  const tempPath = join13(scriptDir, `.hooks-verified-${randomBytes2(12).toString("hex")}.${interpreter.tempExt}`);
+  const tempPath = join14(scriptDir, `.hooks-verified-${randomBytes2(12).toString("hex")}.${interpreter.tempExt}`);
   let proc = null;
   let timedOut = false;
   const timeoutTimer = options.timeout ? setTimeout(() => {
@@ -7856,7 +8019,7 @@ async function executeVerifiedScript(options) {
   }, options.timeout) : null;
   try {
     writeFileSync6(tempPath, options.content, { flag: "wx", mode: 384 });
-    proc = Bun.spawn([...interpreter.command, isAbsolute4(tempPath) ? tempPath : `./${tempPath}`, ...options.args ?? []], {
+    proc = Bun.spawn([...interpreter.command, isAbsolute5(tempPath) ? tempPath : `./${tempPath}`, ...options.args ?? []], {
       stdin: new Response(options.stdin),
       stdout: "pipe",
       stderr: "pipe",
@@ -7938,15 +8101,15 @@ __export(exports_custom_install, {
   installCustomSource: () => installCustomSource,
   ensureCustomDir: () => ensureCustomDir
 });
-import { existsSync as existsSync14, mkdirSync as mkdirSync7, mkdtempSync, readFileSync as readFileSync8, rmSync as rmSync3 } from "fs";
-import { join as join14 } from "path";
+import { existsSync as existsSync15, mkdirSync as mkdirSync7, mkdtempSync, readFileSync as readFileSync9, rmSync as rmSync3 } from "fs";
+import { join as join15 } from "path";
 import { tmpdir as tmpdir2 } from "os";
 function manifestAt(dir) {
-  const path = join14(dir, "manifest.json");
-  if (!existsSync14(path))
+  const path = join15(dir, "manifest.json");
+  if (!existsSync15(path))
     return;
   try {
-    return parseManifest(readFileSync8(path, "utf-8"));
+    return parseManifest(readFileSync9(path, "utf-8"));
   } catch {
     return;
   }
@@ -7965,8 +8128,8 @@ function writeFromManifest(manifest, srcDir, source, kind) {
   return { name, version: manifest.version, kind, source, dir, scriptPath };
 }
 async function cloneToTemp(gitUrl) {
-  const tmp = mkdtempSync(join14(tmpdir2(), "hooks-install-"));
-  const proc = Bun.spawn(["git", "clone", "--depth", "1", "--quiet", gitUrl, join14(tmp, "repo")], {
+  const tmp = mkdtempSync(join15(tmpdir2(), "hooks-install-"));
+  const proc = Bun.spawn(["git", "clone", "--depth", "1", "--quiet", gitUrl, join15(tmp, "repo")], {
     stdout: "pipe",
     stderr: "pipe"
   });
@@ -7979,7 +8142,7 @@ async function cloneToTemp(gitUrl) {
     rmSync3(tmp, { recursive: true, force: true });
     throw new Error(`git clone failed (${exitCode}): ${stderr.trim()}`);
   }
-  return join14(tmp, "repo");
+  return join15(tmp, "repo");
 }
 function isGitUrl(value) {
   return value.startsWith("git@") || value.startsWith("ssh://") || value.startsWith("file://") || value.endsWith(".git");
@@ -7989,7 +8152,7 @@ function isCustomSource(value) {
     return true;
   if (value.startsWith("http://") || value.startsWith("https://"))
     return true;
-  return existsSync14(value);
+  return existsSync15(value);
 }
 async function installCustomSource(source) {
   if (isGitUrl(source)) {
@@ -8003,11 +8166,11 @@ async function installCustomSource(source) {
   if (source.startsWith("http://") || source.startsWith("https://")) {
     return installManifestUrl(source);
   }
-  if (!existsSync14(source)) {
+  if (!existsSync15(source)) {
     throw new Error(`No such local path: ${source}`);
   }
   if (source.endsWith("manifest.json")) {
-    const manifest = parseManifest(readFileSync8(source, "utf-8"));
+    const manifest = parseManifest(readFileSync9(source, "utf-8"));
     return writeFromManifest(manifest, source.substring(0, source.lastIndexOf("/")), source, "local");
   }
   return copyManifestDir(source, source, "local");
@@ -8056,13 +8219,13 @@ __export(exports_sync, {
   fetchPinnedHook: () => fetchPinnedHook,
   commitSyncArtifacts: () => commitSyncArtifacts
 });
-import { createHash as createHash2 } from "crypto";
-import { readFileSync as readFileSync9 } from "fs";
+import { createHash as createHash3 } from "crypto";
+import { readFileSync as readFileSync10 } from "fs";
 function sha256OfText(text) {
-  return createHash2("sha256").update(text).digest("hex");
+  return createHash3("sha256").update(text).digest("hex");
 }
 function sha256OfPath(path) {
-  return createHash2("sha256").update(readFileSync9(path)).digest("hex");
+  return createHash3("sha256").update(readFileSync10(path)).digest("hex");
 }
 function collectBundledCatalog() {
   const out = [];
@@ -8856,13 +9019,12 @@ function secureEqual(a, b) {
 }
 
 // src/openapi.ts
-var openApiDocument;
-var init_openapi = __esm(() => {
-  openApiDocument = {
+function buildOpenApiDocument(version) {
+  return {
     openapi: "3.1.0",
     info: {
       title: "Hooks Registry API",
-      version: "0.1.0",
+      version,
       description: "Local registry HTTP API for @hasna/hooks: catalog, lock, and artifact reads are open; publishing (PUT /api/v1/hooks) requires the API key (authorization: Bearer or x-api-key)."
     },
     servers: [{ url: "/" }],
@@ -8876,7 +9038,7 @@ var init_openapi = __esm(() => {
               description: "Service is alive",
               content: {
                 "application/json": {
-                  schema: { type: "object", additionalProperties: true }
+                  schema: { $ref: "#/components/schemas/HooksHealth" }
                 }
               }
             }
@@ -8888,8 +9050,22 @@ var init_openapi = __esm(() => {
           summary: "Readiness probe \u2014 the hooks.lock store is readable",
           operationId: "getReady",
           responses: {
-            "200": { description: "Lock store is readable" },
-            "503": { description: "Lock store is not readable" }
+            "200": {
+              description: "Lock store is readable",
+              content: {
+                "application/json": {
+                  schema: { $ref: "#/components/schemas/HooksHealth" }
+                }
+              }
+            },
+            "503": {
+              description: "Lock store is not readable",
+              content: {
+                "application/json": {
+                  schema: { $ref: "#/components/schemas/HooksHealth" }
+                }
+              }
+            }
           }
         }
       },
@@ -8902,7 +9078,7 @@ var init_openapi = __esm(() => {
               description: "The installed @hasna/hooks version",
               content: {
                 "application/json": {
-                  schema: { type: "object", properties: { version: { type: "string" } } }
+                  schema: { $ref: "#/components/schemas/HooksVersion" }
                 }
               }
             }
@@ -8913,7 +9089,16 @@ var init_openapi = __esm(() => {
         get: {
           summary: "This OpenAPI document",
           operationId: "getOpenApi",
-          responses: { "200": { description: "OpenAPI 3.1 document" } }
+          responses: {
+            "200": {
+              description: "OpenAPI 3.1 document",
+              content: {
+                "application/json": {
+                  schema: { type: "object", additionalProperties: true }
+                }
+              }
+            }
+          }
         }
       },
       "/api/v1/catalog": {
@@ -8925,23 +9110,7 @@ var init_openapi = __esm(() => {
               description: "Catalog entries",
               content: {
                 "application/json": {
-                  schema: {
-                    type: "object",
-                    properties: {
-                      hooks: {
-                        type: "array",
-                        items: {
-                          type: "object",
-                          properties: {
-                            name: { type: "string" },
-                            version: { type: "string" },
-                            sha256: { type: "string" },
-                            events: { type: "array", items: { type: "string" } }
-                          }
-                        }
-                      }
-                    }
-                  }
+                  schema: { $ref: "#/components/schemas/HooksCatalog" }
                 }
               }
             }
@@ -8952,7 +9121,16 @@ var init_openapi = __esm(() => {
         get: {
           summary: "Read the published hooks.lock with per-hook versions",
           operationId: "getLock",
-          responses: { "200": { description: "The lock file" } }
+          responses: {
+            "200": {
+              description: "The lock file",
+              content: {
+                "application/json": {
+                  schema: { $ref: "#/components/schemas/HooksLock" }
+                }
+              }
+            }
+          }
         }
       },
       "/api/v1/hooks/{name}/{version}": {
@@ -8965,10 +9143,35 @@ var init_openapi = __esm(() => {
           ],
           responses: {
             "200": {
-              description: "Hook artifact; x-hook-sha256 header carries the script hash"
+              description: "Hook artifact; x-hook-sha256 header carries the script hash",
+              headers: {
+                "x-hook-sha256": {
+                  description: "sha256 of the served script, the same value the lock pins",
+                  schema: { type: "string" }
+                }
+              },
+              content: {
+                "application/json": {
+                  schema: { $ref: "#/components/schemas/HooksArtifact" }
+                }
+              }
             },
-            "400": { description: "Invalid URL encoding or semver version" },
-            "404": { description: "Hook not found locally" }
+            "400": {
+              description: "Invalid URL encoding or semver version",
+              content: {
+                "application/json": {
+                  schema: { $ref: "#/components/schemas/HooksError" }
+                }
+              }
+            },
+            "404": {
+              description: "Hook not found locally",
+              content: {
+                "application/json": {
+                  schema: { $ref: "#/components/schemas/HooksError" }
+                }
+              }
+            }
           }
         }
       },
@@ -8980,18 +9183,51 @@ var init_openapi = __esm(() => {
             required: true,
             content: {
               "application/json": {
-                schema: {
-                  type: "object",
-                  properties: { name: { type: "string" }, version: { type: "string" } }
-                }
+                schema: { $ref: "#/components/schemas/HooksPublishRequest" }
               }
             }
           },
           responses: {
-            "200": { description: "Hook retrusted and pin updated" },
-            "401": { description: "Missing or invalid API key" },
-            "404": { description: "Hook not found in local store" },
-            "409": { description: "Version mismatch with the local store" }
+            "200": {
+              description: "Hook retrusted and pin updated",
+              content: {
+                "application/json": {
+                  schema: { $ref: "#/components/schemas/HooksPublishResponse" }
+                }
+              }
+            },
+            "400": {
+              description: "Invalid JSON body",
+              content: {
+                "application/json": {
+                  schema: { $ref: "#/components/schemas/HooksError" }
+                }
+              }
+            },
+            "401": {
+              description: "Missing or invalid API key",
+              content: {
+                "application/json": {
+                  schema: { $ref: "#/components/schemas/HooksError" }
+                }
+              }
+            },
+            "404": {
+              description: "Hook not found in local store",
+              content: {
+                "application/json": {
+                  schema: { $ref: "#/components/schemas/HooksError" }
+                }
+              }
+            },
+            "409": {
+              description: "Version mismatch with the local store",
+              content: {
+                "application/json": {
+                  schema: { $ref: "#/components/schemas/HooksError" }
+                }
+              }
+            }
           },
           security: [{ apiKey: [] }]
         }
@@ -9004,10 +9240,135 @@ var init_openapi = __esm(() => {
           scheme: "bearer",
           description: "The registry API key \u2014 resolved by the client through the @hasna/contracts chain (HASNA_HOOKS_API_KEY, the Keychain item hasna.credentials.hooks.api-key, or ~/.hasna/hooks/config/credentials); the server compares the inbound bearer/x-api-key value."
         }
+      },
+      schemas: {
+        HooksHealth: {
+          type: "object",
+          additionalProperties: false,
+          required: ["status", "name"],
+          properties: {
+            status: { type: "string" },
+            name: { type: "string" }
+          }
+        },
+        HooksVersion: {
+          type: "object",
+          additionalProperties: false,
+          required: ["version"],
+          properties: { version: { type: "string" } }
+        },
+        HooksCatalogEntry: {
+          type: "object",
+          additionalProperties: false,
+          required: ["name", "version", "sha256", "events", "description", "source", "versions"],
+          properties: {
+            name: { type: "string" },
+            version: { type: "string" },
+            sha256: { type: "string" },
+            events: { type: "array", items: { type: "string" } },
+            description: { type: "string" },
+            source: {
+              type: "string",
+              description: "bundled | custom | custom-overrides-bundled"
+            },
+            versions: { type: "array", items: { type: "string" } }
+          }
+        },
+        HooksCatalog: {
+          type: "object",
+          additionalProperties: false,
+          required: ["hooks"],
+          properties: {
+            hooks: { type: "array", items: { $ref: "#/components/schemas/HooksCatalogEntry" } }
+          }
+        },
+        HooksLockEntry: {
+          type: "object",
+          additionalProperties: false,
+          required: ["version", "sha256", "source"],
+          properties: {
+            version: { type: "string" },
+            sha256: { type: "string" },
+            source: { type: "string" },
+            pinned: {
+              type: "boolean",
+              description: "True for an explicit install/update pin, absent for sync-maintained pins."
+            },
+            versions: { type: "array", items: { type: "string" } }
+          }
+        },
+        HooksLock: {
+          type: "object",
+          additionalProperties: false,
+          required: ["hooks"],
+          properties: {
+            hooks: {
+              type: "object",
+              additionalProperties: { $ref: "#/components/schemas/HooksLockEntry" }
+            }
+          }
+        },
+        HooksManifest: {
+          type: "object",
+          additionalProperties: false,
+          required: ["name", "version", "events", "script"],
+          properties: {
+            name: { type: "string" },
+            version: { type: "string" },
+            description: { type: "string" },
+            events: { type: "array", items: { type: "string" } },
+            script: { type: "string" },
+            script_kind: { type: "string", enum: ["inline", "file"] },
+            args: { type: "array", items: { type: "string" } },
+            timeout_ms: { type: "number" }
+          }
+        },
+        HooksArtifact: {
+          type: "object",
+          additionalProperties: false,
+          required: ["manifest", "script"],
+          properties: {
+            manifest: { $ref: "#/components/schemas/HooksManifest" },
+            script: { type: "string" }
+          }
+        },
+        HooksError: {
+          type: "object",
+          additionalProperties: false,
+          required: ["error"],
+          properties: { error: { type: "string" } }
+        },
+        HooksPublishRequest: {
+          type: "object",
+          additionalProperties: false,
+          required: ["name"],
+          properties: {
+            name: { type: "string" },
+            version: { type: "string" }
+          }
+        },
+        HooksPublishResponse: {
+          type: "object",
+          additionalProperties: false,
+          required: ["ok", "hook"],
+          properties: {
+            ok: { type: "boolean" },
+            hook: {
+              type: "object",
+              additionalProperties: false,
+              required: ["name", "version", "sha256"],
+              properties: {
+                name: { type: "string" },
+                version: { type: "string" },
+                sha256: { type: "string" }
+              }
+            }
+          }
+        }
       }
     }
   };
-});
+}
 
 // src/serve.ts
 var exports_serve = {};
@@ -9019,13 +9380,13 @@ __export(exports_serve, {
   SERVE_HOST: () => SERVE_HOST,
   DEFAULT_SERVE_PORT: () => DEFAULT_SERVE_PORT
 });
-import { readFileSync as readFileSync10 } from "fs";
-import { dirname as dirname8, join as join15 } from "path";
+import { readFileSync as readFileSync11 } from "fs";
+import { dirname as dirname9, join as join16 } from "path";
 import { fileURLToPath as fileURLToPath4 } from "url";
 function packageVersion() {
   try {
-    const pkgPath = join15(dirname8(fileURLToPath4(import.meta.url)), "..", "package.json");
-    return JSON.parse(readFileSync10(pkgPath, "utf-8")).version || "0.0.0";
+    const pkgPath = join16(dirname9(fileURLToPath4(import.meta.url)), "..", "package.json");
+    return JSON.parse(readFileSync11(pkgPath, "utf-8")).version || "0.0.0";
   } catch {
     return "0.0.0";
   }
@@ -9114,7 +9475,7 @@ function handleServeRequest(req, apiKey) {
     return Promise.resolve(json({ version: packageVersion() }));
   }
   if (url.pathname === "/openapi.json" && req.method === "GET") {
-    return Promise.resolve(json(openApiDocument));
+    return Promise.resolve(json(buildOpenApiDocument(packageVersion())));
   }
   if (url.pathname === "/api/v1/catalog" && req.method === "GET") {
     return buildCatalog().then((catalog) => json({ hooks: catalog }));
@@ -9199,7 +9560,6 @@ var init_serve = __esm(() => {
   init_store();
   init_resolve();
   init_transport2();
-  init_openapi();
   init_semver();
   if (false) {}
 });
@@ -9326,17 +9686,17 @@ import { SSEServerTransport } from "@modelcontextprotocol/sdk/server/sse.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { z as z2 } from "zod";
 import { createServer } from "http";
-import { existsSync as existsSync15, readFileSync as readFileSync11 } from "fs";
-import { join as join16, dirname as dirname9 } from "path";
+import { existsSync as existsSync16, readFileSync as readFileSync12 } from "fs";
+import { join as join17, dirname as dirname10 } from "path";
 import { fileURLToPath as fileURLToPath5 } from "url";
 async function runVerifiedHook(name, stdin, timeoutMs) {
   const { resolveHook: resolveHook2, resolveScriptPath: resolveScriptPath2 } = await Promise.resolve().then(() => (init_resolve(), exports_resolve));
   const resolved = resolveHook2(name);
   const hookScript = resolveScriptPath2(name);
-  if (!resolved || !hookScript || !existsSync15(hookScript)) {
+  if (!resolved || !hookScript || !existsSync16(hookScript)) {
     throw new Error(`Hook '${name}' not found`);
   }
-  const content = readFileSync11(hookScript);
+  const content = readFileSync12(hookScript);
   const sha = sha256Of(content);
   const check = checkScriptHash(name, sha);
   if (!check.ok) {
@@ -9541,7 +9901,7 @@ function createHooksServer() {
     const settingsPath = getSettingsPath(scope);
     const issues = [];
     const healthy = [];
-    const settingsExist = existsSync15(settingsPath);
+    const settingsExist = existsSync16(settingsPath);
     if (!settingsExist) {
       issues.push({ hook: "(settings)", issue: `${settingsPath} not found`, severity: "warning" });
     }
@@ -9551,7 +9911,7 @@ function createHooksServer() {
       const meta = custom ? resolveHookMeta(name) : getHook(name);
       let hookHealthy = true;
       if (custom) {
-        if (!existsSync15(custom.scriptPath)) {
+        if (!existsSync16(custom.scriptPath)) {
           issues.push({ hook: name, issue: `Custom hook script missing: ${custom.scriptPath}`, severity: "error" });
           hookHealthy = false;
         }
@@ -9561,14 +9921,14 @@ function createHooksServer() {
           continue;
         }
         const hookDir = getHookPath(name);
-        if (!existsSync15(join16(hookDir, "src", "hook.ts"))) {
+        if (!existsSync16(join17(hookDir, "src", "hook.ts"))) {
           issues.push({ hook: name, issue: "Missing src/hook.ts in package", severity: "error" });
           hookHealthy = false;
         }
       }
       if (meta && settingsExist) {
         try {
-          const settings = JSON.parse(readFileSync11(settingsPath, "utf-8"));
+          const settings = JSON.parse(readFileSync12(settingsPath, "utf-8"));
           if (!hookRegisteredInSettings(settings, name, meta.event, meta.matcher)) {
             const eventName = meta.event.split(":")[0];
             issues.push({ hook: name, issue: `Not registered under correct event (${eventName})`, severity: "error" });
@@ -9605,10 +9965,10 @@ function createHooksServer() {
         return { content: [{ type: "text", text: JSON.stringify({ error: `Hook '${name}' not found` }) }] };
       }
       const hookPath = getHookPath(name);
-      const readmePath = join16(hookPath, "README.md");
+      const readmePath = join17(hookPath, "README.md");
       let readme = "";
-      if (existsSync15(readmePath)) {
-        readme = readFileSync11(readmePath, "utf-8");
+      if (existsSync16(readmePath)) {
+        readme = readFileSync12(readmePath, "utf-8");
       }
       if (verbose) {
         return { content: [{ type: "text", text: JSON.stringify({ ...meta, readme }) }] };
@@ -9791,7 +10151,7 @@ function createHooksServer() {
     const ctx = {
       scope,
       settings_path: settingsPath,
-      settings_exists: existsSync15(settingsPath),
+      settings_exists: existsSync16(settingsPath),
       registered_hooks: hooks,
       hook_count: hooks.length,
       healthy,
@@ -9937,8 +10297,8 @@ function createHooksServer() {
     const settingsPath = getSettingsPath(scope);
     let settings = {};
     try {
-      if (existsSync15(settingsPath))
-        settings = JSON.parse(readFileSync11(settingsPath, "utf-8"));
+      if (existsSync16(settingsPath))
+        settings = JSON.parse(readFileSync12(settingsPath, "utf-8"));
     } catch {}
     if (!settings.hooks)
       settings.hooks = {};
@@ -9947,8 +10307,8 @@ function createHooksServer() {
       disabled.push(name);
     settings.hooks.__disabled = disabled;
     const { writeFileSync: writeFileSync7, mkdirSync: mkdirSync8 } = await import("fs");
-    const { dirname: dirname10 } = await import("path");
-    mkdirSync8(dirname10(settingsPath), { recursive: true });
+    const { dirname: dirname11 } = await import("path");
+    mkdirSync8(dirname11(settingsPath), { recursive: true });
     writeFileSync7(settingsPath, JSON.stringify(settings, null, 2) + `
 `);
     return { content: [{ type: "text", text: JSON.stringify({ hook: name, disabled: true, scope }) }] };
@@ -9960,8 +10320,8 @@ function createHooksServer() {
     const settingsPath = getSettingsPath(scope);
     let settings = {};
     try {
-      if (existsSync15(settingsPath))
-        settings = JSON.parse(readFileSync11(settingsPath, "utf-8"));
+      if (existsSync16(settingsPath))
+        settings = JSON.parse(readFileSync12(settingsPath, "utf-8"));
     } catch {}
     if (settings.hooks?.__disabled) {
       settings.hooks.__disabled = settings.hooks.__disabled.filter((n2) => n2 !== name);
@@ -10331,13 +10691,13 @@ var init_server = __esm(() => {
   init_redact();
   init_authority();
   init_storage();
-  __dirname3 = dirname9(fileURLToPath5(import.meta.url));
+  __dirname3 = dirname10(fileURLToPath5(import.meta.url));
   pkg = { name: "@hasna/hooks", version: "0.0.0" };
   try {
     for (const rel of ["../../package.json", "../package.json", "../../../package.json"]) {
-      const p = join16(__dirname3, rel);
-      if (existsSync15(p)) {
-        pkg = JSON.parse(readFileSync11(p, "utf-8"));
+      const p = join17(__dirname3, rel);
+      if (existsSync16(p)) {
+        pkg = JSON.parse(readFileSync12(p, "utf-8"));
         break;
       }
     }
@@ -12079,8 +12439,8 @@ var {
 
 // src/cli/index.tsx
 import chalk2 from "chalk";
-import { existsSync as existsSync16, readFileSync as readFileSync12, rmSync as rmSync4 } from "fs";
-import { join as join17, dirname as dirname10 } from "path";
+import { existsSync as existsSync17, readFileSync as readFileSync13, rmSync as rmSync4 } from "fs";
+import { join as join18, dirname as dirname11 } from "path";
 import { fileURLToPath as fileURLToPath6 } from "url";
 
 // src/cli/components/App.tsx
@@ -13253,6 +13613,7 @@ function App({ initialHooks, overwrite = false }) {
 }
 
 // src/cli/index.tsx
+init_native_safety();
 init_registry();
 init_installer();
 init_registration();
@@ -13268,10 +13629,10 @@ init_local_opt_in();
 init_transport2();
 init_db();
 import { jsxDEV as jsxDEV8 } from "react/jsx-dev-runtime";
-var __dirname4 = dirname10(fileURLToPath6(import.meta.url));
-var pkgPath = existsSync16(join17(__dirname4, "..", "package.json")) ? join17(__dirname4, "..", "package.json") : join17(__dirname4, "..", "..", "package.json");
-var pkg2 = JSON.parse(readFileSync12(pkgPath, "utf-8"));
-var program2 = new Command;
+var __dirname4 = dirname11(fileURLToPath6(import.meta.url));
+var pkgPath = existsSync17(join18(__dirname4, "..", "package.json")) ? join18(__dirname4, "..", "package.json") : join18(__dirname4, "..", "..", "package.json");
+var pkg2 = JSON.parse(readFileSync13(pkgPath, "utf-8"));
+var program3 = new Command;
 function resolveScope(options) {
   if (options.project)
     return "project";
@@ -13350,7 +13711,7 @@ async function openLocalStoreOrExit(json2) {
 function readToken(tokenFile) {
   if (tokenFile) {
     try {
-      return readFileSync12(tokenFile, "utf-8").trim();
+      return readFileSync13(tokenFile, "utf-8").trim();
     } catch {
       return;
     }
@@ -13409,8 +13770,8 @@ function editDistance(a, b) {
 function suggestHooks(name, max = 3) {
   return HOOKS.map((h) => ({ name: h.name, dist: editDistance(name.toLowerCase(), h.name.toLowerCase()) })).filter(({ dist }) => dist <= 4).sort((a, b) => a.dist - b.dist).slice(0, max).map(({ name: n2 }) => n2);
 }
-program2.name("hooks").description("Install hooks for AI coding agents").version(pkg2.version);
-program2.command("interactive", { isDefault: true }).alias("i").description("Interactive hook browser").action(() => {
+program3.name("hooks").description("Install hooks for AI coding agents").version(pkg2.version);
+program3.command("interactive", { isDefault: true }).alias("i").description("Interactive hook browser").action(() => {
   if (!process.stdin.isTTY || !process.stdout.isTTY) {
     console.error(chalk2.red("The interactive hook browser requires a TTY terminal.") + `
 ` + chalk2.dim("Use `hooks search <query>`, `hooks list`, or `hooks categories` for non-interactive use."));
@@ -13418,7 +13779,7 @@ program2.command("interactive", { isDefault: true }).alias("i").description("Int
   }
   render(/* @__PURE__ */ jsxDEV8(App, {}, undefined, false, undefined, this));
 });
-program2.command("init").description("Register a new agent profile with a unique ID").option("-a, --agent <type>", "Agent type: claude, gemini, custom", "claude").option("-n, --name <name>", "Optional display name for the agent").option("-j, --json", "Output as JSON", false).option("--cloudflare", "Configure a remote registry (Cloudflare worker)", false).option("--api-url <url>", "Remote registry API URL (with --cloudflare)").option("--api-key <ref>", "Vault key NAME for the registry API key (never the value; with --cloudflare)").action(async (options) => {
+program3.command("init").description("Register a new agent profile with a unique ID").option("-a, --agent <type>", "Agent type: claude, gemini, custom", "claude").option("-n, --name <name>", "Optional display name for the agent").option("-j, --json", "Output as JSON", false).option("--cloudflare", "Configure a remote registry (Cloudflare worker)", false).option("--api-url <url>", "Remote registry API URL (with --cloudflare)").option("--api-key <ref>", "Vault key NAME for the registry API key (never the value; with --cloudflare)").action(async (options) => {
   if (options.cloudflare) {
     if (!options.apiUrl) {
       const message = "--cloudflare requires --api-url <url>";
@@ -13488,13 +13849,13 @@ program2.command("init").description("Register a new agent profile with a unique
   if (profile.name) {
     console.log(`  ${chalk2.dim("Name:")}       ${profile.name}`);
   }
-  console.log(`  ${chalk2.dim("Profile:")}    ${join17(getProfilesDir(), `${profile.agent_id}.json`)}`);
+  console.log(`  ${chalk2.dim("Profile:")}    ${join18(getProfilesDir(), `${profile.agent_id}.json`)}`);
   console.log();
   console.log(chalk2.dim("  Install hooks with this profile:"));
   console.log(`    hooks install gitguard --profile ${profile.agent_id}`);
   console.log();
 });
-program2.command("run").argument("<hook>", "Hook to run").option("--profile <id>", "Agent profile ID").option("--enable-mementos", "Enable mementos-context for this invocation (provider assistance remains separately opt-in)").option("--disable-mementos", "Disable mementos-context for this invocation").option("--openrouter-secret-ref <reference>", "Secrets reference for the enabled Mementos hook; never a key value").description("Execute a hook (called by AI coding agents)").action(async (hook, options) => {
+program3.command("run").argument("<hook>", "Hook to run").option("--profile <id>", "Agent profile ID").option("--enable-mementos", "Enable mementos-context for this invocation (provider assistance remains separately opt-in)").option("--disable-mementos", "Disable mementos-context for this invocation").option("--openrouter-secret-ref <reference>", "Secrets reference for the enabled Mementos hook; never a key value").description("Execute a hook (called by AI coding agents)").action(async (hook, options) => {
   let mementos;
   try {
     mementos = mementosRegistrationFromFlags(hook, options);
@@ -13512,11 +13873,11 @@ program2.command("run").argument("<hook>", "Hook to run").option("--profile <id>
     process.exit(1);
   }
   const hookScript = resolveScriptPath2(hook);
-  if (!hookScript || !existsSync16(hookScript)) {
+  if (!hookScript || !existsSync17(hookScript)) {
     console.error(JSON.stringify({ error: `Hook script not found: ${hookScript ?? hook}` }));
     process.exit(1);
   }
-  const content = readFileSync12(hookScript);
+  const content = readFileSync13(hookScript);
   const sha = sha256Of2(content);
   const check = checkScriptHash2(hook, sha);
   if (!check.ok) {
@@ -13622,7 +13983,7 @@ program2.command("run").argument("<hook>", "Hook to run").option("--profile <id>
     process.stderr.write(stderr);
   process.exit(exitCode);
 });
-program2.command("install").alias("add").argument("[hooks...]", "Hooks to install").option("-o, --overwrite", "Overwrite existing hooks", false).option("-a, --all", "Install all available hooks", false).option("-c, --category <category>", "Install all hooks in a category").option("-g, --global", "Install globally (~/.claude/settings.json)", false).option("-p, --project", "Install for current project (.claude/settings.json)", false).option("-t, --target <target>", "Agent target: claude, gemini, codewith, codex, all (default: claude)", "claude").option("--profile <id>", "Agent profile ID to scope hooks to").option("--enable-mementos", "Persistently enable mementos-context (provider assistance remains separately opt-in)").option("--disable-mementos", "Persistently disable mementos-context").option("--openrouter-secret-ref <reference>", "Secrets reference for the enabled Mementos hook; never a key value").option("--dry-run", "Preview what would be installed without writing to settings", false).option("--apply-codewith", "Explicitly append Codewith TOML to a config file (prefer configs for managed configs)", false).option("--codewith-config <path>", "Explicit Codewith config path required with --apply-codewith").option("-j, --json", "Output as JSON", false).description("Install one or more hooks (registry names, local paths, git URLs, manifest URLs, or <name>@<version> pinned installs)").action(async (hooks, options) => {
+program3.command("install").alias("add").argument("[hooks...]", "Hooks to install").option("-o, --overwrite", "Overwrite existing hooks", false).option("-a, --all", "Install all available hooks", false).option("-c, --category <category>", "Install all hooks in a category").option("-g, --global", "Install globally (~/.claude/settings.json)", false).option("-p, --project", "Install for current project (.claude/settings.json)", false).option("-t, --target <target>", "Agent target: claude, gemini, codewith, codex, all (default: claude)", "claude").option("--profile <id>", "Agent profile ID to scope hooks to").option("--enable-mementos", "Persistently enable mementos-context (provider assistance remains separately opt-in)").option("--disable-mementos", "Persistently disable mementos-context").option("--openrouter-secret-ref <reference>", "Secrets reference for the enabled Mementos hook; never a key value").option("--dry-run", "Preview what would be installed without writing to settings", false).option("--apply-codewith", "Explicitly append Codewith TOML to a config file (prefer configs for managed configs)", false).option("--codewith-config <path>", "Explicit Codewith config path required with --apply-codewith").option("-j, --json", "Output as JSON", false).description("Install one or more hooks (registry names, local paths, git URLs, manifest URLs, or <name>@<version> pinned installs)").action(async (hooks, options) => {
   const scope = resolveScope(options);
   const target = resolveTarget(options);
   let toInstall = hooks;
@@ -13866,7 +14227,7 @@ Installing hooks (${scope}, ${target})...
   console.log(chalk2.dim(`
 Registered in ${settingsFile}`));
 });
-program2.command("list").alias("ls").option("-c, --category <category>", "Filter by category").option("-a, --all", "Show all available hooks", false).option("-i, --installed", "Show only installed hooks", false).option("-r, --registered", "Show registered hooks", false).option("-g, --global", "Check global settings", false).option("-p, --project", "Check project settings", false).option("-t, --target <target>", "Agent target: claude, gemini, codewith, codex (default: claude)", "claude").option("-n, --limit <n>", "Max rows to show in compact output", "20").option("--verbose", "Show descriptions and full detail columns", false).option("-j, --json", "Output as JSON", false).description("List available or installed hooks (bundled + custom/registry)").action((options) => {
+program3.command("list").alias("ls").option("-c, --category <category>", "Filter by category").option("-a, --all", "Show all available hooks", false).option("-i, --installed", "Show only installed hooks", false).option("-r, --registered", "Show registered hooks", false).option("-g, --global", "Check global settings", false).option("-p, --project", "Check project settings", false).option("-t, --target <target>", "Agent target: claude, gemini, codewith, codex (default: claude)", "claude").option("-n, --limit <n>", "Max rows to show in compact output", "20").option("--verbose", "Show descriptions and full detail columns", false).option("-j, --json", "Output as JSON", false).description("List available or installed hooks (bundled + custom/registry)").action((options) => {
   const scope = resolveScope(options);
   const limit = options.all ? Number.MAX_SAFE_INTEGER : parseLimit(options.limit, 20, 200);
   const storeHooks = listStoreHooks();
@@ -13975,7 +14336,7 @@ Custom / Registry hooks (${storeHooks.length}, showing ${storeVisible.length}):
     printDisclosureHint(storeHooks.length - storeVisible.length, "hooks info <name>", { includeAll: true });
   }
 });
-program2.command("search").argument("<query>", "Search term").option("-n, --limit <n>", "Max rows to show in compact output", "10").option("--verbose", "Show descriptions for search results", false).option("-j, --json", "Output as JSON", false).description("Search for hooks").action((query, options) => {
+program3.command("search").argument("<query>", "Search term").option("-n, --limit <n>", "Max rows to show in compact output", "10").option("--verbose", "Show descriptions for search results", false).option("-j, --json", "Output as JSON", false).description("Search for hooks").action((query, options) => {
   const results = searchHooks(query);
   if (options.json) {
     console.log(JSON.stringify(results));
@@ -13994,7 +14355,7 @@ Found ${results.length} hook(s), showing ${visible.length}:
     console.log(hookSummaryLine(h, { verbose: options.verbose }));
   printDisclosureHint(results.length - visible.length, "hooks info <name>");
 });
-program2.command("remove").alias("rm").argument("<hook>", "Hook to remove").option("-g, --global", "Remove from global settings", false).option("-p, --project", "Remove from project settings", false).option("-t, --target <target>", "Agent target: claude, gemini, codewith, codex, all (default: claude)", "claude").option("-j, --json", "Output as JSON", false).description("Remove an installed hook (settings registration + store + lock + DB)").action(async (hook, options) => {
+program3.command("remove").alias("rm").argument("<hook>", "Hook to remove").option("-g, --global", "Remove from global settings", false).option("-p, --project", "Remove from project settings", false).option("-t, --target <target>", "Agent target: claude, gemini, codewith, codex, all (default: claude)", "claude").option("-j, --json", "Output as JSON", false).description("Remove an installed hook (settings registration + store + lock + DB)").action(async (hook, options) => {
   const scope = resolveScope(options);
   const target = resolveTarget(options);
   const { uninstallHook: uninstallHook2 } = await Promise.resolve().then(() => (init_installer(), exports_installer));
@@ -14030,7 +14391,7 @@ program2.command("remove").alias("rm").argument("<hook>", "Hook to remove").opti
     console.log(chalk2.red(`\u2717 Hook '${hook}' not found${hint}`));
   }
 });
-program2.command("categories").option("-j, --json", "Output as JSON", false).description("List all categories").action((options) => {
+program3.command("categories").option("-j, --json", "Output as JSON", false).description("List all categories").action((options) => {
   if (options.json) {
     const result = CATEGORIES.map((cat) => ({
       name: cat,
@@ -14047,7 +14408,7 @@ Categories:
     console.log(`  ${category} (${count})`);
   }
 });
-program2.command("info").argument("<hook>", "Hook name").option("-j, --json", "Output as JSON", false).description("Show detailed info about a hook").action(async (hook, options) => {
+program3.command("info").argument("<hook>", "Hook name").option("-j, --json", "Output as JSON", false).description("Show detailed info about a hook").action(async (hook, options) => {
   const { resolveHookMeta: resolveHookMeta2 } = await Promise.resolve().then(() => (init_resolve(), exports_resolve));
   const meta = resolveHookMeta2(hook) ?? getHook(hook);
   if (!meta) {
@@ -14095,7 +14456,7 @@ ${meta.displayName}
     console.log(chalk2.dim("  \u25CB Not installed in project"));
   }
 });
-program2.command("doctor").option("-g, --global", "Check global settings", false).option("-p, --project", "Check project settings", false).option("-f, --fix", "Remove stale registrations (a .bak is written beside each settings file)", false).option("-j, --json", "Output as JSON", false).description("Check health of installed hooks; --fix removes registrations whose hook cannot resolve").action((options) => {
+program3.command("doctor").option("-g, --global", "Check global settings", false).option("-p, --project", "Check project settings", false).option("-f, --fix", "Remove stale registrations (a .bak is written beside each settings file)", false).option("-j, --json", "Output as JSON", false).description("Check health of installed hooks; --fix removes registrations whose hook cannot resolve").action((options) => {
   const scope = resolveScope(options);
   const settingsPath = getSettingsPath(scope);
   const issues = [];
@@ -14110,7 +14471,7 @@ program2.command("doctor").option("-g, --global", "Check global settings", false
     });
   }
   const staleNames = new Set(stale.map((finding) => finding.hook));
-  const settingsExist = existsSync16(settingsPath);
+  const settingsExist = existsSync17(settingsPath);
   if (!settingsExist) {
     issues.push({ hook: "(settings)", issue: `${settingsPath} not found`, severity: "warning" });
   }
@@ -14118,7 +14479,7 @@ program2.command("doctor").option("-g, --global", "Check global settings", false
   let wiringCount = 0;
   if (settingsExist) {
     try {
-      const settings = JSON.parse(readFileSync12(settingsPath, "utf-8"));
+      const settings = JSON.parse(readFileSync13(settingsPath, "utf-8"));
       wiringCount = countSettingsWiring(settings);
     } catch {}
   }
@@ -14129,7 +14490,7 @@ program2.command("doctor").option("-g, --global", "Check global settings", false
     const meta = custom ? resolveHookMeta(name) : getHook(name);
     let hookHealthy = true;
     if (custom) {
-      if (!existsSync16(custom.scriptPath)) {
+      if (!existsSync17(custom.scriptPath)) {
         issues.push({ hook: name, issue: `Custom hook script missing: ${custom.scriptPath}`, severity: "error" });
         hookHealthy = false;
       }
@@ -14140,15 +14501,15 @@ program2.command("doctor").option("-g, --global", "Check global settings", false
         continue;
       }
       const hookDir = getHookPath(name);
-      const hookScript = join17(hookDir, "src", "hook.ts");
-      if (!existsSync16(hookScript)) {
+      const hookScript = join18(hookDir, "src", "hook.ts");
+      if (!existsSync17(hookScript)) {
         issues.push({ hook: name, issue: "Missing src/hook.ts in package", severity: "error" });
         hookHealthy = false;
       }
     }
     if (meta && settingsExist) {
       try {
-        const settings = JSON.parse(readFileSync12(settingsPath, "utf-8"));
+        const settings = JSON.parse(readFileSync13(settingsPath, "utf-8"));
         if (!hookRegisteredInSettings(settings, name, meta.event, meta.matcher)) {
           const eventName = meta.event.split(":")[0];
           issues.push({ hook: name, issue: `Not registered under correct event (${eventName})`, severity: "error" });
@@ -14235,7 +14596,7 @@ Hook Health Check (${scope})
   }
   console.log();
 });
-program2.command("update").argument("[hooks...]", "Hooks to update (defaults to all installed)").option("-g, --global", "Update global hooks", false).option("-p, --project", "Update project hooks", false).option("-j, --json", "Output as JSON", false).description("Re-register hooks (picks up new package version), refresh lock pins, or install a pinned registry version (<name>@<version>)").action(async (hooks, options) => {
+program3.command("update").argument("[hooks...]", "Hooks to update (defaults to all installed)").option("-g, --global", "Update global hooks", false).option("-p, --project", "Update project hooks", false).option("-j, --json", "Output as JSON", false).description("Re-register hooks (picks up new package version), refresh lock pins, or install a pinned registry version (<name>@<version>)").action(async (hooks, options) => {
   const scope = resolveScope(options);
   const installed = getInstalledHooks(scope);
   const toUpdate = hooks.length > 0 ? hooks : installed;
@@ -14338,7 +14699,7 @@ Updating hooks...
     process.exitCode = 1;
   }
 });
-program2.command("docs").argument("[hook]", "Hook name (shows general docs if omitted)").option("--verbose", "Print full hook README content", false).option("-j, --json", "Output as JSON", false).description("Show documentation for hooks").action((hook, options) => {
+program3.command("docs").argument("[hook]", "Hook name (shows general docs if omitted)").option("--verbose", "Print full hook README content", false).option("-j, --json", "Output as JSON", false).description("Show documentation for hooks").action((hook, options) => {
   if (hook) {
     const meta = getHook(hook);
     if (!meta) {
@@ -14351,10 +14712,10 @@ program2.command("docs").argument("[hook]", "Hook name (shows general docs if om
       return;
     }
     const hookPath = getHookPath(hook);
-    const readmePath = join17(hookPath, "README.md");
+    const readmePath = join18(hookPath, "README.md");
     let readme = "";
-    if (existsSync16(readmePath)) {
-      readme = readFileSync12(readmePath, "utf-8");
+    if (existsSync17(readmePath)) {
+      readme = readFileSync13(readmePath, "utf-8");
     }
     if (options.json) {
       console.log(JSON.stringify({ ...meta, readme }));
@@ -14472,7 +14833,7 @@ ${meta.displayName} v${meta.version}
   console.log(`    hooks docs --json              Machine-readable documentation`);
   console.log();
 });
-program2.command("upgrade").option("-c, --check", "Check for updates without installing", false).option("-j, --json", "Output as JSON", false).description("Update the @hasna/hooks package to the latest version").action(async (options) => {
+program3.command("upgrade").option("-c, --check", "Check for updates without installing", false).option("-j, --json", "Output as JSON", false).description("Update the @hasna/hooks package to the latest version").action(async (options) => {
   const current2 = pkg2.version;
   let pm = "npm";
   try {
@@ -14534,7 +14895,7 @@ Upgrading @hasna/hooks (${pm})...
 \u2713 Upgraded: ${current2} \u2192 ${latest}`));
   }
 });
-program2.command("profile-export").description("Export all agent profiles as JSON (for backup/cross-machine setup)").option("-o, --output <file>", "Write to file instead of stdout").option("-j, --json", "Output as JSON (default: true)", false).action(async (options) => {
+program3.command("profile-export").description("Export all agent profiles as JSON (for backup/cross-machine setup)").option("-o, --output <file>", "Write to file instead of stdout").option("-j, --json", "Output as JSON (default: true)", false).action(async (options) => {
   const profiles = exportProfiles();
   const json2 = JSON.stringify(profiles, null, 2);
   if (options.output) {
@@ -14546,14 +14907,14 @@ program2.command("profile-export").description("Export all agent profiles as JSO
     console.log(json2);
   }
 });
-program2.command("profile-import").argument("<file>", "JSON file to import profiles from (use - for stdin)").description("Import agent profiles from a JSON export file").option("-j, --json", "Output result as JSON", false).action(async (file, options) => {
+program3.command("profile-import").argument("<file>", "JSON file to import profiles from (use - for stdin)").description("Import agent profiles from a JSON export file").option("-j, --json", "Output result as JSON", false).action(async (file, options) => {
   let raw;
   if (file === "-") {
     raw = await new Response(Bun.stdin.stream()).text();
   } else {
-    const { readFileSync: readFileSync13 } = await import("fs");
+    const { readFileSync: readFileSync14 } = await import("fs");
     try {
-      raw = readFileSync13(file, "utf-8");
+      raw = readFileSync14(file, "utf-8");
     } catch {
       if (options.json) {
         console.log(JSON.stringify({ error: `Cannot read file: ${file}` }));
@@ -14584,7 +14945,7 @@ program2.command("profile-import").argument("<file>", "JSON file to import profi
       console.log(chalk2.dim(`  Skipped ${result.skipped} (already exist or invalid)`));
   }
 });
-var logCmd = program2.command("log").description(`Query hook event logs from SQLite (${getReportedDbPath()})`);
+var logCmd = program3.command("log").description(`Query hook event logs from SQLite (${getReportedDbPath()})`);
 logCmd.command("list").description("List hook events").option("--hook <name>", "Filter by hook name").option("--session <id>", "Filter by session ID").option("-n, --limit <n>", "Number of rows to show", "50").option("-j, --json", "Output as JSON", false).action(async (options) => {
   const db = await openLocalStoreOrExit(options.json);
   const limit = parseInt(options.limit) || 50;
@@ -14735,7 +15096,7 @@ logCmd.command("clear").description("Delete hook event logs").option("--hook <na
   }
   console.log(chalk2.green(`\u2713 Cleared ${count} event(s).`));
 });
-var storageCmd = program2.command("storage").description("Sync local hook data with storage PostgreSQL");
+var storageCmd = program3.command("storage").description("Sync local hook data with storage PostgreSQL");
 storageCmd.command("status").description("Show storage sync status").option("-j, --json", "Output as JSON", false).action(async (options) => {
   try {
     const { getStorageStatus: getStorageStatus2 } = await Promise.resolve().then(() => (init_storage(), exports_storage));
@@ -14818,7 +15179,7 @@ storageCmd.command("sync").description("Bidirectional storage sync: pull then pu
     process.exitCode = 1;
   }
 });
-program2.command("trust").argument("<hook>", "Hook to trust").option("-j, --json", "Output as JSON", false).description("Trust the current script content of a hook (re-pins its sha256)").action(async (hook, options) => {
+program3.command("trust").argument("<hook>", "Hook to trust").option("-j, --json", "Output as JSON", false).description("Trust the current script content of a hook (re-pins its sha256)").action(async (hook, options) => {
   const { resolveHook: resolveHook2 } = await Promise.resolve().then(() => (init_resolve(), exports_resolve));
   const { retrustHook: retrustHook2 } = await Promise.resolve().then(() => (init_store(), exports_store));
   const resolved = resolveHook2(hook);
@@ -14837,14 +15198,14 @@ program2.command("trust").argument("<hook>", "Hook to trust").option("-j, --json
   console.log(chalk2.green(`\u2713 Trusted '${resolved.name}' v${resolved.version} (${resolved.source})`));
   console.log(chalk2.dim(`  sha256 ${result.actual}`));
 });
-program2.command("serve").option("-p, --port <port>", "Port (default 39428)").option("--host <host>", "Host to bind (default 127.0.0.1)").description("Serve the local hook registry over HTTP (catalog, artifacts, lock). The publish API key resolves from the @hasna/contracts chain per request (HASNA_HOOKS_API_KEY, the Keychain item hasna.credentials.hooks.api-key, or ~/.hasna/hooks/config/credentials) \u2014 there is deliberately no --api-key flag (P1-8).").action(async (options) => {
+program3.command("serve").option("-p, --port <port>", "Port (default 39428)").option("--host <host>", "Host to bind (default 127.0.0.1)").description("Serve the local hook registry over HTTP (catalog, artifacts, lock). The publish API key resolves from the @hasna/contracts chain per request (HASNA_HOOKS_API_KEY, the Keychain item hasna.credentials.hooks.api-key, or ~/.hasna/hooks/config/credentials) \u2014 there is deliberately no --api-key flag (P1-8).").action(async (options) => {
   const { startServeServer: startServeServer2 } = await Promise.resolve().then(() => (init_serve(), exports_serve));
   startServeServer2({
     port: options.port ? parseInt(options.port, 10) : undefined,
     host: options.host
   });
 });
-program2.command("sync").option("--dry-run", "Print the plan without changing anything", false).option("-j, --json", "Output as JSON", false).description("Sync local hooks with the remote registry (or bundled registry when no registry credential resolves and local mode is opted into)").action(async (options) => {
+program3.command("sync").option("--dry-run", "Print the plan without changing anything", false).option("-j, --json", "Output as JSON", false).description("Sync local hooks with the remote registry (or bundled registry when no registry credential resolves and local mode is opted into)").action(async (options) => {
   const { syncHooks: syncHooks2, planSync: planSync2 } = await Promise.resolve().then(() => (init_sync(), exports_sync));
   try {
     const plan = options.dryRun ? await syncHooks2({ dryRun: true }) : await syncHooks2();
@@ -14888,7 +15249,7 @@ Hook sync (${source})${plan.dryRun ? " \u2014 dry run" : ""}
     process.exitCode = 1;
   }
 });
-program2.command("cf").description("Provision and deploy the hooks registry to Cloudflare").option("--deploy", "Provision D1 + R2 via the Cloudflare API", true).option("--dry-run", "Print the plan without calling the Cloudflare API", false).option("--account-id <id>", "Cloudflare account id (defaults to CF_ACCOUNT_ID env)").option("--database-name <name>", "D1 database name (default hooks-registry)").option("--bucket-name <name>", "R2 bucket name (default hooks-registry-artifacts)").option("--token-file <path>", "Read the API token from a file (defaults to CF_API_TOKEN env)").option("-j, --json", "Output as JSON", false).action(async (options) => {
+program3.command("cf").description("Provision and deploy the hooks registry to Cloudflare").option("--deploy", "Provision D1 + R2 via the Cloudflare API", true).option("--dry-run", "Print the plan without calling the Cloudflare API", false).option("--account-id <id>", "Cloudflare account id (defaults to CF_ACCOUNT_ID env)").option("--database-name <name>", "D1 database name (default hooks-registry)").option("--bucket-name <name>", "R2 bucket name (default hooks-registry-artifacts)").option("--token-file <path>", "Read the API token from a file (defaults to CF_API_TOKEN env)").option("-j, --json", "Output as JSON", false).action(async (options) => {
   const token = readToken(options.tokenFile);
   const accountId = options.accountId ?? process.env.CF_ACCOUNT_ID;
   if (!options.dryRun) {
@@ -14937,7 +15298,7 @@ Cloudflare provisioning complete:
   console.log(chalk2.dim("  wrangler.toml, fill in the D1 database id, then run the commands above."));
   console.log();
 });
-program2.command("migrate").description("Apply PostgreSQL migrations to the storage database (HASNA_HOOKS_DATABASE_URL)").option("-j, --json", "Output as JSON", false).action(async (options) => {
+program3.command("migrate").description("Apply PostgreSQL migrations to the storage database (HASNA_HOOKS_DATABASE_URL)").option("-j, --json", "Output as JSON", false).action(async (options) => {
   try {
     const { getStoragePg: getStoragePg2, runStorageMigrations: runStorageMigrations2 } = await Promise.resolve().then(() => (init_storage(), exports_storage));
     const remote = await getStoragePg2();
@@ -14960,7 +15321,7 @@ program2.command("migrate").description("Apply PostgreSQL migrations to the stor
     process.exitCode = 1;
   }
 });
-program2.command("mcp").option("-s, --stdio", "Use stdio transport (one process per agent)", false).option("--sse", "Use legacy SSE transport (port 39427)", false).option("--http", "Use Streamable HTTP transport (explicit; this is also the default)", false).option("-p, --port <port>", "Port for HTTP/SSE transport (defaults to 8847 for HTTP, 39427 for SSE)").description("Start MCP server for AI agent integration (default: shared Streamable HTTP)").action(async (options) => {
+program3.command("mcp").option("-s, --stdio", "Use stdio transport (one process per agent)", false).option("--sse", "Use legacy SSE transport (port 39427)", false).option("--http", "Use Streamable HTTP transport (explicit; this is also the default)", false).option("-p, --port <port>", "Port for HTTP/SSE transport (defaults to 8847 for HTTP, 39427 for SSE)").description("Start MCP server for AI agent integration (default: shared Streamable HTTP)").action(async (options) => {
   if (options.stdio) {
     const { startStdioServer: startStdioServer2 } = await Promise.resolve().then(() => (init_server(), exports_server));
     await startStdioServer2();
@@ -14981,8 +15342,20 @@ program2.command("mcp").option("-s, --stdio", "Use stdio transport (one process
     startMcpHttpServer2({ name: "hooks", port: resolveMcpHttpPort2(args), buildServer: createHooksServer2 });
   }
 });
-registerEventsCommands(program2, { source: "hooks" });
+registerEventsCommands(program3, { source: "hooks" });
+program3.command("safety").description("Register bundled native deletion guards without a registry credential").command("install <guard>").option("--target <target>", "codex or claude", "codex").option("--scope <scope>", "global or project", "global").option("--overwrite", "Replace this guard in place; native trust is still required").action((guard, options) => {
+  if (!isNativeSafetyName(guard) || !["codex", "claude"].includes(options.target) || !["global", "project"].includes(options.scope)) {
+    console.error("Unsupported bundled safety registration");
+    process.exitCode = 1;
+    return;
+  }
+  const result = installHook(guard, { target: options.target, scope: options.scope, overwrite: options.overwrite });
+  console.log(JSON.stringify(result));
+  if (!result.success)
+    process.exitCode = 1;
+});
 var API_INDEPENDENT_COMMANDS = new Set([
+  "safety",
   "serve",
   "mcp",
   "cf",
@@ -15043,4 +15416,4 @@ function enforceTransportGate() {
   refuseLocalStore(hooksHostedRouteLocalStoreRefusal(transport.authority.v1BaseUrl));
 }
 enforceTransportGate();
-program2.parse();
+program3.parse();