failproofai 0.0.1-beta.8 → 0.0.1

package/.next/standalone/scripts/sync-hook-events-prompt.md

@@ -0,0 +1,60 @@
+You are an automated agent running in GitHub Actions to keep failproofai's hook
+event types in sync with the official Claude Code documentation.
+
+## Your task
+
+1. Fetch the Claude Code hooks reference pages using WebFetch:
+   - https://code.claude.com/docs/en/hooks (full reference — has the complete event table)
+   - https://code.claude.com/docs/en/hooks-guide (guide — also has a summary event table)
+   Extract the complete list of all hook event type names (e.g. SessionStart,
+   PreToolUse, PostToolUse, etc.) from the event lifecycle/trigger table.
+   Use both pages; union the results if they differ. Prefer the reference page.
+
+2. Read `src/hooks/types.ts` and extract the current `HOOK_EVENT_TYPES` array
+   (the TypeScript `as const` array of strings).
+
+3. Diff the two lists:
+   - **added**: event types in the docs but NOT in our array
+   - **removed**: event types in our array but NOT in the docs
+
+4. If there are NO differences:
+   Write the following JSON to `.sync-hook-events-output.json` in the repo root:
+   ```json
+   { "changed": false }
+   ```
+   Then stop.
+
+5. If there are differences:
+
+   a. Update `HOOK_EVENT_TYPES` in `src/hooks/types.ts`:
+      - Add new event types (append after the last existing entry, before `] as const`)
+      - Remove stale event types if any
+
+   b. Update `__tests__/hooks/manager.test.ts` — find the hardcoded event-type
+      counts and update them to the new total:
+      - The test description string matching `all N event types`
+      - The `toHaveLength(N)` assertion(s) that check `Object.keys(written.hooks)`
+      Search by the current count number to locate them.
+
+   c. Write the following JSON to `.sync-hook-events-output.json` in the repo root:
+      ```json
+      {
+        "changed": true,
+        "added": ["EventA", "EventB"],
+        "removed": ["EventC"],
+        "prTitle": "[auto] sync hook event types with Claude Code docs",
+        "prBody": "..."
+      }
+      ```
+      The `prBody` must be a Markdown string containing:
+      - List of **added** event types (or "none")
+      - List of **removed** event types (or "none")
+      - Source URLs used
+      - A note: "CI must pass and this PR must be reviewed before merging."
+
+## Constraints
+
+- **Only edit `src/hooks/types.ts`, `__tests__/hooks/manager.test.ts`, and
+  `.sync-hook-events-output.json`**. No other files.
+- Do NOT run any shell commands (no git, no gh, no bun).
+- Do NOT modify `policy-evaluator.ts`, `manager.ts`, or any other source file.

package/.next/standalone/server.js

@@ -9,7 +9,7 @@ const currentPort = parseInt(process.env.PORT, 10) || 3000
 const hostname = process.env.HOSTNAME || '0.0.0.0'
 
 let keepAliveTimeout = parseInt(process.env.KEEP_ALIVE_TIMEOUT, 10)
-const nextConfig = {"env":{},"typescript":{"ignoreBuildErrors":false},"typedRoutes":false,"distDir":"./.next","cleanDistDir":true,"assetPrefix":"","cacheMaxMemorySize":52428800,"configOrigin":"next.config.ts","useFileSystemPublicRoutes":true,"generateEtags":true,"pageExtensions":["tsx","ts","jsx","js"],"poweredByHeader":true,"compress":true,"images":{"deviceSizes":[640,750,828,1080,1200,1920,2048,3840],"imageSizes":[32,48,64,96,128,256,384],"path":"/_next/image","loader":"default","loaderFile":"","domains":[],"disableStaticImages":false,"minimumCacheTTL":14400,"formats":["image/webp"],"maximumRedirects":3,"maximumResponseBody":50000000,"dangerouslyAllowLocalIP":false,"dangerouslyAllowSVG":false,"contentSecurityPolicy":"script-src 'none'; frame-src 'none'; sandbox;","contentDispositionType":"attachment","localPatterns":[{"pathname":"**","search":""}],"remotePatterns":[],"qualities":[75],"unoptimized":true,"customCacheHandler":false},"devIndicators":{"position":"bottom-left"},"onDemandEntries":{"maxInactiveAge":60000,"pagesBufferLength":5},"basePath":"","sassOptions":{},"trailingSlash":false,"i18n":null,"productionBrowserSourceMaps":false,"excludeDefaultMomentLocales":true,"reactProductionProfiling":false,"reactStrictMode":null,"reactMaxHeadersLength":6000,"httpAgentOptions":{"keepAlive":true},"logging":{"serverFunctions":true,"browserToTerminal":"warn"},"compiler":{},"expireTime":31536000,"staticPageGenerationTimeout":60,"output":"standalone","modularizeImports":{"@mui/icons-material":{"transform":"@mui/icons-material/{{member}}"},"lodash":{"transform":"lodash/{{member}}"}},"outputFileTracingRoot":"/home/runner/work/failproofai/failproofai","cacheComponents":false,"cacheLife":{"default":{"stale":300,"revalidate":900,"expire":4294967294},"seconds":{"stale":30,"revalidate":1,"expire":60},"minutes":{"stale":300,"revalidate":60,"expire":3600},"hours":{"stale":300,"revalidate":3600,"expire":86400},"days":{"stale":300,"revalidate":86400,"expire":604800},"weeks":{"stale":300,"revalidate":604800,"expire":2592000},"max":{"stale":300,"revalidate":2592000,"expire":31536000}},"cacheHandlers":{},"experimental":{"appNewScrollHandler":false,"useSkewCookie":false,"cssChunking":true,"multiZoneDraftMode":false,"appNavFailHandling":false,"prerenderEarlyExit":true,"serverMinification":true,"linkNoTouchStart":false,"caseSensitiveRoutes":false,"cachedNavigations":false,"partialFallbacks":false,"dynamicOnHover":false,"varyParams":false,"prefetchInlining":false,"preloadEntriesOnStart":true,"clientRouterFilter":true,"clientRouterFilterRedirects":false,"fetchCacheKeyPrefix":"","proxyPrefetch":"flexible","optimisticClientCache":true,"manualClientBasePath":false,"cpus":1,"memoryBasedWorkersCount":false,"imgOptConcurrency":null,"imgOptTimeoutInSeconds":7,"imgOptMaxInputPixels":268402689,"imgOptSequentialRead":null,"imgOptSkipMetadata":null,"isrFlushToDisk":true,"workerThreads":false,"optimizeCss":false,"nextScriptWorkers":false,"scrollRestoration":false,"externalDir":false,"disableOptimizedLoading":false,"gzipSize":true,"craCompat":false,"esmExternals":true,"fullySpecified":false,"swcTraceProfiling":false,"forceSwcTransforms":false,"largePageDataBytes":128000,"typedEnv":false,"parallelServerCompiles":false,"parallelServerBuildTraces":false,"ppr":false,"authInterrupts":false,"webpackMemoryOptimizations":false,"optimizeServerReact":true,"strictRouteTypes":false,"viewTransition":false,"removeUncaughtErrorAndRejectionListeners":false,"validateRSCRequestHeaders":false,"staleTimes":{"dynamic":0,"static":300},"reactDebugChannel":true,"serverComponentsHmrCache":true,"staticGenerationMaxConcurrency":8,"staticGenerationMinPagesPerWorker":25,"transitionIndicator":false,"gestureTransition":false,"inlineCss":false,"useCache":false,"globalNotFound":false,"browserDebugInfoInTerminal":"warn","lockDistDir":true,"proxyClientMaxBodySize":10485760,"hideLogsAfterAbort":false,"mcpServer":true,"turbopackFileSystemCacheForDev":true,"turbopackFileSystemCacheForBuild":false,"turbopackInferModuleSideEffects":true,"turbopackPluginRuntimeStrategy":"childProcesses","optimizePackageImports":["lucide-react","date-fns","lodash-es","ramda","antd","react-bootstrap","ahooks","@ant-design/icons","@headlessui/react","@headlessui-float/react","@heroicons/react/20/solid","@heroicons/react/24/solid","@heroicons/react/24/outline","@visx/visx","@tremor/react","rxjs","@mui/material","@mui/icons-material","recharts","react-use","effect","@effect/schema","@effect/platform","@effect/platform-node","@effect/platform-browser","@effect/platform-bun","@effect/sql","@effect/sql-mssql","@effect/sql-mysql2","@effect/sql-pg","@effect/sql-sqlite-node","@effect/sql-sqlite-bun","@effect/sql-sqlite-wasm","@effect/sql-sqlite-react-native","@effect/rpc","@effect/rpc-http","@effect/typeclass","@effect/experimental","@effect/opentelemetry","@material-ui/core","@material-ui/icons","@tabler/icons-react","mui-core","react-icons/ai","react-icons/bi","react-icons/bs","react-icons/cg","react-icons/ci","react-icons/di","react-icons/fa","react-icons/fa6","react-icons/fc","react-icons/fi","react-icons/gi","react-icons/go","react-icons/gr","react-icons/hi","react-icons/hi2","react-icons/im","react-icons/io","react-icons/io5","react-icons/lia","react-icons/lib","react-icons/lu","react-icons/md","react-icons/pi","react-icons/ri","react-icons/rx","react-icons/si","react-icons/sl","react-icons/tb","react-icons/tfi","react-icons/ti","react-icons/vsc","react-icons/wi"],"trustHostHeader":false,"isExperimentalCompile":false},"htmlLimitedBots":"[\\w-]+-Google|Google-[\\w-]+|Chrome-Lighthouse|Slurp|DuckDuckBot|baiduspider|yandex|sogou|bitlybot|tumblr|vkShare|quora link preview|redditbot|ia_archiver|Bingbot|BingPreview|applebot|facebookexternalhit|facebookcatalog|Twitterbot|LinkedInBot|Slackbot|Discordbot|WhatsApp|SkypeUriPreview|Yeti|googleweblight","bundlePagesRouterDependencies":false,"configFileName":"next.config.ts","turbopack":{"root":"/home/runner/work/failproofai/failproofai"},"distDirRoot":".next"}
+const nextConfig = {"env":{},"typescript":{"ignoreBuildErrors":false},"typedRoutes":false,"distDir":"./.next","cleanDistDir":true,"assetPrefix":"","cacheMaxMemorySize":52428800,"configOrigin":"next.config.ts","useFileSystemPublicRoutes":true,"generateEtags":true,"pageExtensions":["tsx","ts","jsx","js"],"poweredByHeader":true,"compress":true,"images":{"deviceSizes":[640,750,828,1080,1200,1920,2048,3840],"imageSizes":[32,48,64,96,128,256,384],"path":"/_next/image","loader":"default","loaderFile":"","domains":[],"disableStaticImages":false,"minimumCacheTTL":14400,"formats":["image/webp"],"maximumRedirects":3,"maximumResponseBody":50000000,"dangerouslyAllowLocalIP":false,"dangerouslyAllowSVG":false,"contentSecurityPolicy":"script-src 'none'; frame-src 'none'; sandbox;","contentDispositionType":"attachment","localPatterns":[{"pathname":"**","search":""}],"remotePatterns":[],"qualities":[75],"unoptimized":true,"customCacheHandler":false},"devIndicators":{"position":"bottom-left"},"onDemandEntries":{"maxInactiveAge":60000,"pagesBufferLength":5},"basePath":"","sassOptions":{},"trailingSlash":false,"i18n":null,"productionBrowserSourceMaps":false,"excludeDefaultMomentLocales":true,"reactProductionProfiling":false,"reactStrictMode":null,"reactMaxHeadersLength":6000,"httpAgentOptions":{"keepAlive":true},"logging":{"serverFunctions":true,"browserToTerminal":"warn"},"compiler":{},"expireTime":31536000,"staticPageGenerationTimeout":60,"output":"standalone","modularizeImports":{"@mui/icons-material":{"transform":"@mui/icons-material/{{member}}"},"lodash":{"transform":"lodash/{{member}}"}},"outputFileTracingRoot":"/home/runner/work/failproofai/failproofai","cacheComponents":false,"cacheLife":{"default":{"stale":300,"revalidate":900,"expire":4294967294},"seconds":{"stale":30,"revalidate":1,"expire":60},"minutes":{"stale":300,"revalidate":60,"expire":3600},"hours":{"stale":300,"revalidate":3600,"expire":86400},"days":{"stale":300,"revalidate":86400,"expire":604800},"weeks":{"stale":300,"revalidate":604800,"expire":2592000},"max":{"stale":300,"revalidate":2592000,"expire":31536000}},"cacheHandlers":{},"experimental":{"appNewScrollHandler":false,"useSkewCookie":false,"cssChunking":true,"multiZoneDraftMode":false,"appNavFailHandling":false,"prerenderEarlyExit":true,"serverMinification":true,"linkNoTouchStart":false,"caseSensitiveRoutes":false,"cachedNavigations":false,"partialFallbacks":false,"dynamicOnHover":false,"varyParams":false,"prefetchInlining":false,"preloadEntriesOnStart":true,"clientRouterFilter":true,"clientRouterFilterRedirects":false,"fetchCacheKeyPrefix":"","proxyPrefetch":"flexible","optimisticClientCache":true,"manualClientBasePath":false,"cpus":3,"memoryBasedWorkersCount":false,"imgOptConcurrency":null,"imgOptTimeoutInSeconds":7,"imgOptMaxInputPixels":268402689,"imgOptSequentialRead":null,"imgOptSkipMetadata":null,"isrFlushToDisk":true,"workerThreads":false,"optimizeCss":false,"nextScriptWorkers":false,"scrollRestoration":false,"externalDir":false,"disableOptimizedLoading":false,"gzipSize":true,"craCompat":false,"esmExternals":true,"fullySpecified":false,"swcTraceProfiling":false,"forceSwcTransforms":false,"largePageDataBytes":128000,"typedEnv":false,"parallelServerCompiles":false,"parallelServerBuildTraces":false,"ppr":false,"authInterrupts":false,"webpackMemoryOptimizations":false,"optimizeServerReact":true,"strictRouteTypes":false,"viewTransition":false,"removeUncaughtErrorAndRejectionListeners":false,"validateRSCRequestHeaders":false,"staleTimes":{"dynamic":0,"static":300},"reactDebugChannel":true,"serverComponentsHmrCache":true,"staticGenerationMaxConcurrency":8,"staticGenerationMinPagesPerWorker":25,"transitionIndicator":false,"gestureTransition":false,"inlineCss":false,"useCache":false,"globalNotFound":false,"browserDebugInfoInTerminal":"warn","lockDistDir":true,"proxyClientMaxBodySize":10485760,"hideLogsAfterAbort":false,"mcpServer":true,"turbopackFileSystemCacheForDev":true,"turbopackFileSystemCacheForBuild":false,"turbopackInferModuleSideEffects":true,"turbopackPluginRuntimeStrategy":"childProcesses","optimizePackageImports":["lucide-react","date-fns","lodash-es","ramda","antd","react-bootstrap","ahooks","@ant-design/icons","@headlessui/react","@headlessui-float/react","@heroicons/react/20/solid","@heroicons/react/24/solid","@heroicons/react/24/outline","@visx/visx","@tremor/react","rxjs","@mui/material","@mui/icons-material","recharts","react-use","effect","@effect/schema","@effect/platform","@effect/platform-node","@effect/platform-browser","@effect/platform-bun","@effect/sql","@effect/sql-mssql","@effect/sql-mysql2","@effect/sql-pg","@effect/sql-sqlite-node","@effect/sql-sqlite-bun","@effect/sql-sqlite-wasm","@effect/sql-sqlite-react-native","@effect/rpc","@effect/rpc-http","@effect/typeclass","@effect/experimental","@effect/opentelemetry","@material-ui/core","@material-ui/icons","@tabler/icons-react","mui-core","react-icons/ai","react-icons/bi","react-icons/bs","react-icons/cg","react-icons/ci","react-icons/di","react-icons/fa","react-icons/fa6","react-icons/fc","react-icons/fi","react-icons/gi","react-icons/go","react-icons/gr","react-icons/hi","react-icons/hi2","react-icons/im","react-icons/io","react-icons/io5","react-icons/lia","react-icons/lib","react-icons/lu","react-icons/md","react-icons/pi","react-icons/ri","react-icons/rx","react-icons/si","react-icons/sl","react-icons/tb","react-icons/tfi","react-icons/ti","react-icons/vsc","react-icons/wi"],"trustHostHeader":false,"isExperimentalCompile":false},"htmlLimitedBots":"[\\w-]+-Google|Google-[\\w-]+|Chrome-Lighthouse|Slurp|DuckDuckBot|baiduspider|yandex|sogou|bitlybot|tumblr|vkShare|quora link preview|redditbot|ia_archiver|Bingbot|BingPreview|applebot|facebookexternalhit|facebookcatalog|Twitterbot|LinkedInBot|Slackbot|Discordbot|WhatsApp|SkypeUriPreview|Yeti|googleweblight","bundlePagesRouterDependencies":false,"configFileName":"next.config.ts","turbopack":{"root":"/home/runner/work/failproofai/failproofai"},"distDirRoot":".next"}
 
 process.env.__NEXT_PRIVATE_STANDALONE_CONFIG = JSON.stringify(nextConfig)
 

package/.next/standalone/src/hooks/types.ts

@@ -10,19 +10,28 @@ export const HOOK_EVENT_TYPES = [
   "SessionEnd",
   "UserPromptSubmit",
   "PreToolUse",
+  "PermissionRequest",
+  "PermissionDenied",
   "PostToolUse",
   "PostToolUseFailure",
-  "PermissionRequest",
   "Notification",
   "SubagentStart",
   "SubagentStop",
+  "TaskCreated",
+  "TaskCompleted",
   "Stop",
+  "StopFailure",
   "TeammateIdle",
-  "TaskCompleted",
+  "InstructionsLoaded",
   "ConfigChange",
+  "CwdChanged",
+  "FileChanged",
   "WorktreeCreate",
   "WorktreeRemove",
   "PreCompact",
+  "PostCompact",
+  "Elicitation",
+  "ElicitationResult",
 ] as const;
 
 export type HookEventType = (typeof HOOK_EVENT_TYPES)[number];

package/bin/failproofai.mjs

@@ -24,8 +24,19 @@ if (!process.env.FAILPROOFAI_PACKAGE_ROOT) {
   );
 }
 
+if (!process.env.FAILPROOFAI_DIST_PATH) {
+  process.env.FAILPROOFAI_DIST_PATH = resolve(
+    dirname(realpathSync(fileURLToPath(import.meta.url))),
+    "..",
+    "dist"
+  );
+}
+
 const args = process.argv.slice(2);
 
+// Normalize 'p' → 'policies' (shorthand alias)
+if (args[0] === "p") args[0] = "policies";
+
 // --help / -h  (only when not inside a subcommand that handles its own --help)
 const SUBCOMMANDS = ["policies"];
 if ((args.includes("--help") || args.includes("-h")) && !SUBCOMMANDS.includes(args[0])) {
@@ -38,7 +49,7 @@ USAGE
 COMMANDS
   (no args)                      Launch the policy dashboard
 
-  policies                       List all available policies and their status
+  policies, p                    List all available policies and their status
   policies --install, -i         Enable policies in Claude Code settings
     [names...]                     Specific policy names to enable
     --scope user|project|local     Config scope to write to (default: user)

package/dist/index.js

@@ -0,0 +1,80 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+function __accessProp(key) {
+  return this[key];
+}
+var __toCommonJS = (from) => {
+  var entry = (__moduleCache ??= new WeakMap).get(from), desc;
+  if (entry)
+    return entry;
+  entry = __defProp({}, "__esModule", { value: true });
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (var key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(entry, key))
+        __defProp(entry, key, {
+          get: __accessProp.bind(from, key),
+          enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+        });
+  }
+  __moduleCache.set(from, entry);
+  return entry;
+};
+var __moduleCache;
+var __returnValue = (v) => v;
+function __exportSetter(name, newValue) {
+  this[name] = __returnValue.bind(null, newValue);
+}
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, {
+      get: all[name],
+      enumerable: true,
+      configurable: true,
+      set: __exportSetter.bind(all, name)
+    });
+};
+
+// src/index.ts
+var exports_src = {};
+__export(exports_src, {
+  instruct: () => instruct,
+  getCustomHooks: () => getCustomHooks,
+  deny: () => deny,
+  customPolicies: () => customPolicies,
+  clearCustomHooks: () => clearCustomHooks,
+  allow: () => allow
+});
+module.exports = __toCommonJS(exports_src);
+
+// src/hooks/custom-hooks-registry.ts
+var REGISTRY_KEY = "__failproofai_custom_hooks__";
+function getRegistry() {
+  const g = globalThis;
+  if (!Array.isArray(g[REGISTRY_KEY]))
+    g[REGISTRY_KEY] = [];
+  return g[REGISTRY_KEY];
+}
+var customPolicies = {
+  add(hook) {
+    getRegistry().push(hook);
+  }
+};
+function getCustomHooks() {
+  return getRegistry();
+}
+function clearCustomHooks() {
+  const g = globalThis;
+  g[REGISTRY_KEY] = [];
+}
+// src/hooks/policy-helpers.ts
+function allow() {
+  return { decision: "allow" };
+}
+function deny(reason) {
+  return { decision: "deny", reason };
+}
+function instruct(reason) {
+  return { decision: "instruct", reason };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "failproofai",
-  "version": "0.0.1-beta.8",
+  "version": "0.0.1",
   "description": "Open-source hooks, policies, and project visualization for Claude Code & Agents SDK",
   "bin": {
     "failproofai": "./bin/failproofai.mjs"
@@ -11,6 +11,7 @@
     "scripts/",
     "lib/",
     ".next/standalone/",
+    "dist/",
     "README.md"
   ],
   "engines": {
@@ -20,7 +21,7 @@
   "scripts": {
     "predev": "bun link",
     "dev": "FAILPROOFAI_TELEMETRY_DISABLED=1 bun scripts/dev.ts --port 8020",
-    "build": "bun --bun next build && node -e \"const {cpSync}=require('fs');cpSync('.next/static','.next/standalone/.next/static',{recursive:true});\"",
+    "build": "bun build --target=node --format=cjs --outfile=dist/index.js src/index.ts && bun --bun next build && node -e \"const {cpSync}=require('fs');cpSync('.next/static','.next/standalone/.next/static',{recursive:true});\"",
     "prestart": "bun link",
     "start": "FAILPROOFAI_TELEMETRY_DISABLED=1 bun scripts/start.ts",
     "test": "vitest",

package/scripts/publish-aliases.mjs

@@ -29,6 +29,8 @@ const ALIASES = [
   'faliproofai',
 ];
 
+const warnings = [];
+
 for (const name of ALIASES) {
   const tmpDir = join('/tmp', `npm-alias-${name}-${Date.now()}`);
   const binDir = join(tmpDir, 'bin');
@@ -55,11 +57,29 @@ for (const name of ALIASES) {
     console.log(`[dry-run] Would publish ${name}@${VERSION}`);
     console.log(JSON.stringify(pkg, null, 2));
     console.log('---');
-  } else {
-    console.log(`Publishing ${name}@${VERSION}...`);
-    execSync('npm publish', { cwd: tmpDir, stdio: 'inherit' });
+    rmSync(tmpDir, { recursive: true, force: true });
+    continue;
+  }
+
+  console.log(`Publishing ${name}@${VERSION}...`);
+  try {
+    execSync('npm publish', { cwd: tmpDir, stdio: 'pipe' });
     console.log(`Done: ${name}`);
+  } catch (err) {
+    const output = (err.stdout?.toString() ?? '') + (err.stderr?.toString() ?? '');
+    if (output.includes('too similar')) {
+      warnings.push(`${name}: blocked by npm similarity check — request via npm support`);
+    } else if (output.includes('cannot publish over')) {
+      console.log(`[skip] ${name}: already published at ${VERSION}`);
+    } else {
+      warnings.push(`${name}: ${output.trim().split('\n').find(l => l.includes('npm error')) ?? 'unknown error'}`);
+    }
   }
 
   rmSync(tmpDir, { recursive: true, force: true });
 }
+
+if (warnings.length > 0) {
+  console.log('\n::warning::Some alias packages were not published:');
+  for (const w of warnings) console.log(`  - ${w}`);
+}

package/scripts/sync-hook-events-prompt.md

@@ -0,0 +1,60 @@
+You are an automated agent running in GitHub Actions to keep failproofai's hook
+event types in sync with the official Claude Code documentation.
+
+## Your task
+
+1. Fetch the Claude Code hooks reference pages using WebFetch:
+   - https://code.claude.com/docs/en/hooks (full reference — has the complete event table)
+   - https://code.claude.com/docs/en/hooks-guide (guide — also has a summary event table)
+   Extract the complete list of all hook event type names (e.g. SessionStart,
+   PreToolUse, PostToolUse, etc.) from the event lifecycle/trigger table.
+   Use both pages; union the results if they differ. Prefer the reference page.
+
+2. Read `src/hooks/types.ts` and extract the current `HOOK_EVENT_TYPES` array
+   (the TypeScript `as const` array of strings).
+
+3. Diff the two lists:
+   - **added**: event types in the docs but NOT in our array
+   - **removed**: event types in our array but NOT in the docs
+
+4. If there are NO differences:
+   Write the following JSON to `.sync-hook-events-output.json` in the repo root:
+   ```json
+   { "changed": false }
+   ```
+   Then stop.
+
+5. If there are differences:
+
+   a. Update `HOOK_EVENT_TYPES` in `src/hooks/types.ts`:
+      - Add new event types (append after the last existing entry, before `] as const`)
+      - Remove stale event types if any
+
+   b. Update `__tests__/hooks/manager.test.ts` — find the hardcoded event-type
+      counts and update them to the new total:
+      - The test description string matching `all N event types`
+      - The `toHaveLength(N)` assertion(s) that check `Object.keys(written.hooks)`
+      Search by the current count number to locate them.
+
+   c. Write the following JSON to `.sync-hook-events-output.json` in the repo root:
+      ```json
+      {
+        "changed": true,
+        "added": ["EventA", "EventB"],
+        "removed": ["EventC"],
+        "prTitle": "[auto] sync hook event types with Claude Code docs",
+        "prBody": "..."
+      }
+      ```
+      The `prBody` must be a Markdown string containing:
+      - List of **added** event types (or "none")
+      - List of **removed** event types (or "none")
+      - Source URLs used
+      - A note: "CI must pass and this PR must be reviewed before merging."
+
+## Constraints
+
+- **Only edit `src/hooks/types.ts`, `__tests__/hooks/manager.test.ts`, and
+  `.sync-hook-events-output.json`**. No other files.
+- Do NOT run any shell commands (no git, no gh, no bun).
+- Do NOT modify `policy-evaluator.ts`, `manager.ts`, or any other source file.

package/src/hooks/types.ts

@@ -10,19 +10,28 @@ export const HOOK_EVENT_TYPES = [
   "SessionEnd",
   "UserPromptSubmit",
   "PreToolUse",
+  "PermissionRequest",
+  "PermissionDenied",
   "PostToolUse",
   "PostToolUseFailure",
-  "PermissionRequest",
   "Notification",
   "SubagentStart",
   "SubagentStop",
+  "TaskCreated",
+  "TaskCompleted",
   "Stop",
+  "StopFailure",
   "TeammateIdle",
-  "TaskCompleted",
+  "InstructionsLoaded",
   "ConfigChange",
+  "CwdChanged",
+  "FileChanged",
   "WorktreeCreate",
   "WorktreeRemove",
   "PreCompact",
+  "PostCompact",
+  "Elicitation",
+  "ElicitationResult",
 ] as const;
 
 export type HookEventType = (typeof HOOK_EVENT_TYPES)[number];