failproofai 0.0.1-beta.5 → 0.0.1-beta.7

package/.next/standalone/bin/failproofai.mjs

@@ -5,9 +5,8 @@
  * Handles:
  *   --hook <event>        Hook event from Claude Code (minimal startup latency)
  *   --version / -v        Print version and exit
- *   --install-policies    Install hooks + enable policies in Claude Code settings
- *   --remove-policies     Remove hooks or disable policies from Claude Code settings
- *   --list-policies       List available policies and their status
+ *   --help / -h           Show usage and exit
+ *   policies              Manage policies (list / install / uninstall)
  *   (default)             Launch production dashboard
  */
 import { realpathSync } from "node:fs";
@@ -27,6 +26,52 @@ if (!process.env.FAILPROOFAI_PACKAGE_ROOT) {
 
 const args = process.argv.slice(2);
 
+// --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])) {
+  console.log(`
+failproofai v${version}
+
+USAGE
+  failproofai [command] [options]
+
+COMMANDS
+  (no args)                      Launch the policy dashboard
+
+  policies                       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)
+    --beta                         Include beta policies
+    --custom, -c <path>            Path to a JS file of custom policies
+
+  policies --uninstall, -u       Disable policies or remove hooks
+    [names...]                     Specific policy names to disable
+    --scope user|project|local|all Config scope to remove from (default: user)
+    --beta                         Remove only beta policies
+    --custom, -c                   Clear the customPoliciesPath from config
+
+  policies --help, -h            Show this help for the policies command
+
+  --version, -v                  Print version and exit
+  --help, -h                     Show this help message
+
+EXAMPLES
+  failproofai policies
+  failproofai policies --install
+  failproofai policies --install block-sudo sanitize-api-keys --scope project
+  failproofai policies --install --custom ./my-policies.js
+  failproofai policies -i -c ./my-policies.js
+  failproofai policies --uninstall block-sudo
+  failproofai policies --uninstall --custom
+
+LINKS
+  ⭐ Star us:      https://github.com/exospherehost/failproofai
+  📖 Docs:         https://befailproof.ai
+`.trimStart());
+  process.exit(0);
+}
+
 // --version / -v
 if (args.includes("--version") || args.includes("-v")) {
   console.log(version);
@@ -41,70 +86,121 @@ if (hookIdx >= 0 && args[hookIdx + 1]) {
   process.exit(exitCode);
 }
 
-// --install-policies [policyNames...] [--scope user|project|local] [--beta] [--custom-hooks <path>] [--remove-custom-hooks]
-if (args.includes("--install-policies")) {
-  const { installHooks } = await import("../src/hooks/manager");
-
-  const scopeIdx = args.indexOf("--scope");
-  const scope = scopeIdx >= 0 ? args[scopeIdx + 1] : "user";
-
-  const customHooksIdx = args.indexOf("--custom-hooks");
-  const customHooksPath = customHooksIdx >= 0 ? args[customHooksIdx + 1] : undefined;
-
-  const includeBeta = args.includes("--beta");
-  const removeCustomHooks = args.includes("--remove-custom-hooks");
-
-  // Collect positional policy names (args after --install-policies that don't start with --)
-  const installIdx = args.indexOf("--install-policies");
-  const policyNames = args
-    .slice(installIdx + 1)
-    .filter((a) => !a.startsWith("--") && a !== scope && a !== customHooksPath);
-
-  await installHooks(
-    policyNames.length > 0 ? policyNames : undefined,
-    scope,
-    undefined,
-    includeBeta,
-    undefined,
-    customHooksPath,
-    removeCustomHooks,
-  );
-  process.exit(0);
-}
+// policies [--install|-i|--uninstall|-u|--help|-h] [names...] [--scope] [--beta] [--custom|-c <path>]
+if (args[0] === "policies") {
+  const subArgs = args.slice(1);
+
+  const isInstall   = subArgs.includes("--install")   || subArgs.includes("-i");
+  const isUninstall = subArgs.includes("--uninstall")  || subArgs.includes("-u");
+  const isHelp      = subArgs.includes("--help")       || subArgs.includes("-h");
+
+  if (isHelp) {
+    console.log(`
+failproofai policies — manage Failproof AI policies
+
+USAGE
+  failproofai policies                       List all policies and their status
+  failproofai policies --install, -i         Enable policies
+  failproofai policies --uninstall, -u       Disable policies or remove hooks
+
+OPTIONS (install)
+  [names...]                     Specific policy names to enable (omit for interactive)
+  --scope user|project|local     Config scope to write to (default: user)
+  --beta                         Include beta policies
+  --custom, -c <path>            Path to a JS file of custom policies
+                                 (skips interactive prompt; validates file first)
+
+OPTIONS (uninstall)
+  [names...]                     Specific policy names to disable (omit to remove hooks)
+  --scope user|project|local|all Config scope to remove from (default: user)
+  --beta                         Remove only beta policies
+  --custom, -c                   Clear the customPoliciesPath from config
+
+EXAMPLES
+  failproofai policies
+  failproofai policies --install
+  failproofai policies --install block-sudo sanitize-api-keys
+  failproofai policies --install --custom ./my-policies.js
+  failproofai policies -i -c ./my-policies.js
+  failproofai policies --uninstall block-sudo
+  failproofai policies -u
+  failproofai policies --uninstall --custom
+`.trimStart());
+    process.exit(0);
+  }
 
-// --remove-policies [policyNames...] [--scope user|project|local|all] [--beta-only]
-if (args.includes("--remove-policies")) {
-  const { removeHooks } = await import("../src/hooks/manager");
+  if (isInstall) {
+    const { installHooks } = await import("../src/hooks/manager");
 
-  const scopeIdx = args.indexOf("--scope");
-  const scope = scopeIdx >= 0 ? args[scopeIdx + 1] : "user";
+    const scopeIdx = subArgs.indexOf("--scope");
+    const scope = scopeIdx >= 0 ? subArgs[scopeIdx + 1] : "user";
 
-  const betaOnly = args.includes("--beta-only");
+    const customIdx = subArgs.includes("--custom") ? subArgs.indexOf("--custom")
+                    : subArgs.includes("-c")        ? subArgs.indexOf("-c")
+                    : -1;
+    const customPoliciesPath = customIdx >= 0 ? subArgs[customIdx + 1] : undefined;
 
-  const removeIdx = args.indexOf("--remove-policies");
-  const policyNames = args
-    .slice(removeIdx + 1)
-    .filter((a) => !a.startsWith("--") && a !== scope);
+    const includeBeta = subArgs.includes("--beta");
 
-  await removeHooks(
-    policyNames.length > 0 ? policyNames : undefined,
-    scope,
-    undefined,
-    { betaOnly },
-  );
-  process.exit(0);
-}
+    // Collect positional policy names — args that don't start with - and aren't
+    // values consumed by --scope or --custom/-c.
+    const consumed = new Set([scope, customPoliciesPath].filter(Boolean));
+    const flags = new Set(["--install", "-i", "--scope", "--beta", "--custom", "-c"]);
+    const explicitPolicyNames = subArgs.filter(
+      (a) => !a.startsWith("-") && !flags.has(a) && !consumed.has(a)
+    );
 
-// --list-policies
-if (args.includes("--list-policies")) {
+    // When --custom/-c is present but no explicit policy names, pass [] so
+    // installHooks uses the existing enabled policies and skips the interactive
+    // prompt — validation of the custom file happens inside installHooks.
+    const policyNames =
+      explicitPolicyNames.length > 0 ? explicitPolicyNames
+      : customPoliciesPath !== undefined ? []
+      : undefined;
+
+    await installHooks(
+      policyNames,
+      scope,
+      undefined,
+      includeBeta,
+      undefined,
+      customPoliciesPath,
+    );
+    process.exit(0);
+  }
+
+  if (isUninstall) {
+    const { removeHooks } = await import("../src/hooks/manager");
+
+    const scopeIdx = subArgs.indexOf("--scope");
+    const scope = scopeIdx >= 0 ? subArgs[scopeIdx + 1] : "user";
+
+    const betaOnly = subArgs.includes("--beta");
+    const removeCustomHooks = subArgs.includes("--custom") || subArgs.includes("-c");
+
+    const consumed = new Set([scope].filter(Boolean));
+    const flags = new Set(["--uninstall", "-u", "--scope", "--beta", "--custom", "-c"]);
+    const policyNames = subArgs.filter(
+      (a) => !a.startsWith("-") && !flags.has(a) && !consumed.has(a)
+    );
+
+    await removeHooks(
+      policyNames.length > 0 ? policyNames : undefined,
+      scope,
+      undefined,
+      { betaOnly, removeCustomHooks },
+    );
+    process.exit(0);
+  }
+
+  // Default: list policies
   const { listHooks } = await import("../src/hooks/manager");
   await listHooks();
   process.exit(0);
 }
 
 // Unknown flag guard — must appear after all known-flag branches
-const knownFlags = ["--version", "-v", "--hook", "--install-policies",
-                    "--remove-policies", "--list-policies"];
+const knownFlags = ["--version", "-v", "--help", "-h", "--hook"];
 const unknownFlag = args.find(a => a.startsWith("-") && !knownFlags.includes(a));
 
 if (unknownFlag) {
@@ -121,8 +217,7 @@ if (unknownFlag) {
     return dp[m][n];
   }
 
-  const primary = ["--version", "--hook", "--install-policies",
-                   "--remove-policies", "--list-policies"];
+  const primary = ["--version", "--help", "--hook", "policies"];
   const closest = primary.reduce((best, flag) => {
     const dist = levenshtein(unknownFlag, flag);
     return dist < best.dist ? { flag, dist } : best;
@@ -130,6 +225,16 @@ if (unknownFlag) {
 
   console.error(`Unknown flag: ${unknownFlag}`);
   console.error(`Did you mean: ${closest.flag}?`);
+  console.error(`Run \`failproofai --help\` for usage details.`);
+  process.exit(1);
+}
+
+// Unknown subcommand guard (non-flag args that aren't "policies")
+const unknownSubcommand = args.find(a => !a.startsWith("-") && a !== "policies");
+if (unknownSubcommand) {
+  console.error(`Unknown command: ${unknownSubcommand}`);
+  console.error(`Did you mean: failproofai policies?`);
+  console.error(`Run \`failproofai --help\` for usage details.`);
   process.exit(1);
 }
 

package/.next/standalone/components/reach-developers.tsx

@@ -2,13 +2,23 @@
 "use client";
 
 import React, { useState, useCallback } from "react";
-import { GitBranch, Lightbulb, Bug, MessageSquare, ChevronDown } from "lucide-react";
+import { GitBranch, Lightbulb, Bug, MessageSquare, ChevronDown, Star, BookOpen } from "lucide-react";
 import { Button } from "@/components/ui/button";
 
 const GITHUB_REPO = "https://github.com/exospherehost/failproofai";
 const CONTACT_EMAIL = "failproofai@exosphere.host";
 
 const options = [
+  {
+    label: "Star us on GitHub",
+    icon: Star,
+    href: "https://github.com/exospherehost/failproofai",
+  },
+  {
+    label: "Documentation",
+    icon: BookOpen,
+    href: "https://befailproof.ai",
+  },
   {
     label: "Request a Feature",
     icon: Lightbulb,

package/.next/standalone/docs/architecture.md

@@ -108,7 +108,7 @@ stdin JSON
   → extract session metadata (session_id, cwd, tool_name, tool_input, etc.)
   → readMergedHooksConfig(cwd)    ← merges project + local + global config
   → register enabled builtin policies with resolved params
-  → load custom hooks from customHooksPath (if set)
+  → load custom hooks from customPoliciesPath (if set)
   → register custom hooks into policy registry
   → evaluate all policies (builtins first, then custom)
       → first deny short-circuits
@@ -127,15 +127,15 @@ The entire process runs in under 100ms for typical payloads with no LLM calls.
 `src/hooks/hooks-config.ts` implements three-scope config loading.
 
 ```
-[1] {cwd}/.failproofai/hooks-config.json        ← project  (highest priority)
-[2] {cwd}/.failproofai/hooks-config.local.json  ← local
-[3] ~/.failproofai/hooks-config.json             ← global   (lowest priority)
+[1] {cwd}/.failproofai/policies-config.json        ← project  (highest priority)
+[2] {cwd}/.failproofai/policies-config.local.json  ← local
+[3] ~/.failproofai/policies-config.json             ← global   (lowest priority)
 ```
 
 Merge logic:
 - `enabledPolicies` — deduplicated union across all three files
 - `policyParams` — per-policy key, first file that defines it wins entirely
-- `customHooksPath` — first file that defines it wins
+- `customPoliciesPath` — first file that defines it wins
 - `llm` — first file that defines it wins
 
 The web dashboard uses `readHooksConfig()` (global only) for reading and writing, since it is not invoked with a project cwd.
@@ -206,7 +206,7 @@ export function clearCustomHooks(): void { ... }  // used in tests
 
 `src/hooks/custom-hooks-loader.ts` loads the user's hooks file:
 
-1. Read `customHooksPath` from config; skip if absent.
+1. Read `customPoliciesPath` from config; skip if absent.
 2. Resolve to absolute path; check file exists.
 3. Rewrite all `from "failproofai"` imports to the actual dist path so `customPolicies` resolves to the same `globalThis` registry.
 4. Recursively rewrite transitive local imports to ensure ESM compatibility.

package/.next/standalone/docs/cli-reference.md

@@ -66,7 +66,7 @@ Writes hook entries into Claude Code's `settings.json` so that failproofai inter
 | `--scope user` | Install into `~/.claude/settings.json` (default — all sessions) |
 | `--scope project` | Install into `.claude/settings.json` in the current directory |
 | `--scope local` | Install into `.claude/settings.local.json` in the current directory |
-| `--custom-hooks <path>` | Path to a JS file containing custom hook policies |
+| `--custom <path>` | Path to a JS file containing custom hook policies |
 | `--beta` | Include beta policies in installation |
 
 **Examples:**
@@ -79,10 +79,10 @@ failproofai --install-policies
 failproofai --install-policies block-sudo sanitize-api-keys --scope project
 
 # Install with a custom hooks file
-failproofai --install-policies --custom-hooks ./my-policies.js
+failproofai --install-policies --custom ./my-policies.js
 ```
 
-When `--custom-hooks <path>` is provided, the resolved absolute path is saved to `hooks-config.json` as `customHooksPath`. The file is loaded and executed at hook-fire time (not at install time).
+When `--custom <path>` is provided, the resolved absolute path is saved to `policies-config.json` as `customPoliciesPath`. The file is loaded and executed at hook-fire time (not at install time).
 
 ---
 
@@ -102,7 +102,7 @@ Removes failproofai hook entries from Claude Code's `settings.json`.
 | `--scope project` | Remove from project settings |
 | `--scope local` | Remove from local settings |
 | `--scope all` | Remove from all scopes |
-| `--remove-custom-hooks` | Clear the `customHooksPath` from config |
+| `--custom` | Clear the `customPoliciesPath` from config |
 
 **Examples:**
 
@@ -114,7 +114,7 @@ failproofai --remove-policies
 failproofai --remove-policies block-sudo
 
 # Remove custom hooks path
-failproofai --remove-policies --remove-custom-hooks
+failproofai --remove-policies --custom
 ```
 
 ---

package/.next/standalone/docs/configuration.md

@@ -10,9 +10,9 @@ There are three configuration scopes, evaluated in priority order:
 
 | Scope | File path | Purpose |
 |-------|-----------|---------|
-| **project** | `.failproofai/hooks-config.json` | Per-repo settings, committed to version control |
-| **local** | `.failproofai/hooks-config.local.json` | Personal per-repo overrides, gitignored |
-| **global** | `~/.failproofai/hooks-config.json` | User-level defaults across all projects |
+| **project** | `.failproofai/policies-config.json` | Per-repo settings, committed to version control |
+| **local** | `.failproofai/policies-config.local.json` | Personal per-repo overrides, gitignored |
+| **global** | `~/.failproofai/policies-config.json` | User-level defaults across all projects |
 
 When failproofai receives a hook event, it loads and merges all three files that exist for the current working directory.
 
@@ -45,7 +45,7 @@ global:   block-sudo → { allowPatterns: ["sudo systemctl status"] }
 resolved: { allowPatterns: ["sudo systemctl status"] }  ← falls through to global
 ```
 
-**`customHooksPath`** — first scope that defines it wins.
+**`customPoliciesPath`** — first scope that defines it wins.
 
 **`llm`** — first scope that defines it wins.
 
@@ -86,7 +86,7 @@ resolved: { allowPatterns: ["sudo systemctl status"] }  ← falls through to glo
       "thresholdKb": 512
     }
   },
-  "customHooksPath": "/home/alice/myproject/my-policies.js"
+  "customPoliciesPath": "/home/alice/myproject/my-policies.js"
 }
 ```
 
@@ -112,11 +112,11 @@ If a policy has parameters but you don't specify them, the policy's built-in def
 
 Unknown keys inside a policy's params block are silently ignored at hook-fire time but flagged as warnings when you run `failproofai --list-policies`.
 
-### `customHooksPath`
+### `customPoliciesPath`
 
 Type: `string` (absolute path)
 
-Path to a JavaScript file containing custom hook policies. This is set automatically by `failproofai --install-policies --custom-hooks <path>` (the path is resolved to absolute before being stored).
+Path to a JavaScript file containing custom hook policies. This is set automatically by `failproofai --install-policies --custom <path>` (the path is resolved to absolute before being stored).
 
 The file is loaded fresh on every hook event — there is no caching. See [Custom Hooks](./custom-hooks.md) for authoring details.
 
@@ -139,18 +139,18 @@ LLM client configuration for policies that make AI calls. Not required for most
 
 ## Managing configuration from the CLI
 
-The `--install-policies` and `--remove-policies` commands write to Claude Code's `settings.json` (the hook entry points), while `hooks-config.json` is the file you manage directly. The two are separate:
+The `--install-policies` and `--remove-policies` commands write to Claude Code's `settings.json` (the hook entry points), while `policies-config.json` is the file you manage directly. The two are separate:
 
 - **`settings.json`** — tells Claude Code to call `failproofai --hook <event>` on each tool use
-- **`hooks-config.json`** — tells failproofai which policies to evaluate and with what params
+- **`policies-config.json`** — tells failproofai which policies to evaluate and with what params
 
-You can edit `hooks-config.json` directly at any time; changes take effect immediately on the next hook event with no restart needed.
+You can edit `policies-config.json` directly at any time; changes take effect immediately on the next hook event with no restart needed.
 
 ---
 
 ## Example: project-level config with team defaults
 
-Commit `.failproofai/hooks-config.json` to your repo:
+Commit `.failproofai/policies-config.json` to your repo:
 
 ```json
 {
@@ -169,4 +169,4 @@ Commit `.failproofai/hooks-config.json` to your repo:
 }
 ```
 
-Each developer can then create `.failproofai/hooks-config.local.json` (gitignored) for personal overrides without affecting teammates.
+Each developer can then create `.failproofai/policies-config.local.json` (gitignored) for personal overrides without affecting teammates.

package/.next/standalone/docs/custom-hooks.md

@@ -28,7 +28,7 @@ customPolicies.add({
 Install it:
 
 ```bash
-failproofai --install-policies --custom-hooks ./my-policies.js
+failproofai --install-policies --custom ./my-policies.js
 ```
 
 ---
@@ -37,16 +37,16 @@ failproofai --install-policies --custom-hooks ./my-policies.js
 
 ```bash
 # Install with a custom hooks file
-failproofai --install-policies --custom-hooks ./my-policies.js
+failproofai --install-policies --custom ./my-policies.js
 
 # Replace the hooks file path
-failproofai --install-policies --custom-hooks ./new-policies.js
+failproofai --install-policies --custom ./new-policies.js
 
 # Remove the custom hooks path from config
-failproofai --remove-policies --remove-custom-hooks
+failproofai --remove-policies --custom
 ```
 
-The resolved absolute path is stored in `hooks-config.json` as `customHooksPath`. The file is loaded fresh on every hook event — there is no caching between events.
+The resolved absolute path is stored in `policies-config.json` as `customPoliciesPath`. The file is loaded fresh on every hook event — there is no caching between events.
 
 ---
 
@@ -172,7 +172,7 @@ Custom hooks are **fail-open**: errors never block built-in policies or crash th
 
 | Failure | Behavior |
 |---------|----------|
-| `customHooksPath` not set | No custom hooks run; built-ins continue normally |
+| `customPoliciesPath` not set | No custom hooks run; built-ins continue normally |
 | File not found | Warning logged to `~/.failproofai/hook.log`; built-ins continue |
 | Syntax/import error | Error logged to `~/.failproofai/hook.log`; all custom hooks skipped |
 | `fn` throws at runtime | Error logged; that hook treated as `allow`; other hooks continue |
@@ -253,5 +253,5 @@ The `examples/` directory contains ready-to-run hook files:
 Install the basic examples:
 
 ```bash
-failproofai --install-policies --custom-hooks ./examples/policies-basic.js
+failproofai --install-policies --custom ./examples/policies-basic.js
 ```

package/.next/standalone/docs/dashboard.md

@@ -65,7 +65,7 @@ A two-tab page for managing policies and reviewing activity.
 
 **Policies tab:**
 
-- Toggle individual policies on or off with a single click (writes to `~/.failproofai/hooks-config.json`)
+- Toggle individual policies on or off with a single click (writes to `~/.failproofai/policies-config.json`)
 - Expand a policy to configure its parameters (for policies that support `policyParams`)
 - Install or remove hooks for a given scope
 - Set a custom hooks file path

package/.next/standalone/docs/getting-started.md

@@ -89,11 +89,11 @@ failproofai stores all configuration and logs locally:
 
 | Path | Contents |
 |------|----------|
-| `~/.failproofai/hooks-config.json` | Global policy configuration |
+| `~/.failproofai/policies-config.json` | Global policy configuration |
 | `~/.failproofai/hook-activity.jsonl` | Hook execution history (one JSON line per event) |
 | `~/.failproofai/hook.log` | Debug log for custom hook errors |
-| `.failproofai/hooks-config.json` | Per-project policy configuration (committed) |
-| `.failproofai/hooks-config.local.json` | Per-project personal overrides (gitignored) |
+| `.failproofai/policies-config.json` | Per-project policy configuration (committed) |
+| `.failproofai/policies-config.local.json` | Per-project personal overrides (gitignored) |
 
 ---
 

package/.next/standalone/docs/index.md

@@ -43,5 +43,5 @@ failproofai --list-policies
 
 **Add a custom policy file:**
 ```bash
-failproofai --install-policies --custom-hooks ./my-policies.js
+failproofai --install-policies --custom ./my-policies.js
 ```

package/.next/standalone/docs/testing.md

@@ -147,7 +147,7 @@ __tests__/e2e/
 import { createFixtureEnv } from "../helpers/fixture-env";
 
 const env = createFixtureEnv();
-// env.cwd    — temp dir; pass as payload.cwd to pick up .failproofai/hooks-config.json
+// env.cwd    — temp dir; pass as payload.cwd to pick up .failproofai/policies-config.json
 // env.home   — isolated home dir; no real ~/.failproofai leaks in
 
 env.writeConfig({

package/.next/standalone/package.json

@@ -1,6 +1,6 @@
 {
   "name": "failproofai",
-  "version": "0.0.1-beta.5",
+  "version": "0.0.1-beta.7",
   "description": "Open-source hooks, policies, and project visualization for Claude Code & Agents SDK",
   "bin": {
     "failproofai": "./bin/failproofai.mjs"

package/.next/standalone/scripts/launch.ts

@@ -20,6 +20,8 @@ export function launch(mode: "dev" | "start"): void {
 /_/    \\__,_/_/_/ .___/_/   \\____/\\____/_/    /_/  |_/___/
                /_/   v${version}
 `);
+  console.log(`  ⭐ Star us:      https://github.com/exospherehost/failproofai`);
+  console.log(`  📖 Docs:         https://befailproof.ai\n`);
 
   let claudeProjectsPath = parsedPath;
 

package/.next/standalone/scripts/postinstall.mjs

@@ -30,7 +30,7 @@ function hashToId(raw) {
  * @returns {{ configured: boolean, registered: boolean, policyCount: number }}
  */
 function checkHooks() {
-  const hooksConfigPath = resolve(homedir(), ".failproofai", "hooks-config.json");
+  const hooksConfigPath = resolve(homedir(), ".failproofai", "policies-config.json");
   if (!existsSync(hooksConfigPath)) {
     return { configured: false, registered: false, policyCount: 0 };
   }
@@ -87,7 +87,7 @@ function printHooksWarning() {
   console.log(
     `\n[failproofai] Warning: hooks config exists with enabled policies, but hooks are not registered in Claude Code settings.\n` +
     `  To re-register hooks, run:\n` +
-    `    failproofai --remove-policies && failproofai --install-policies\n`
+    `    failproofai policies --uninstall && failproofai policies --install\n`
   );
 }
 

package/.next/standalone/src/hooks/custom-hooks-loader.ts

@@ -16,18 +16,18 @@ import type { CustomHook } from "./policy-types";
 const LOADING_KEY = "__FAILPROOFAI_LOADING_HOOKS__";
 
 export async function loadCustomHooks(
-  customHooksPath: string | undefined,
+  customPoliciesPath: string | undefined,
   opts?: { strict?: boolean },
 ): Promise<CustomHook[]> {
-  if (!customHooksPath) return [];
+  if (!customPoliciesPath) return [];
 
-  const absPath = isAbsolute(customHooksPath)
-    ? customHooksPath
-    : resolve(process.cwd(), customHooksPath);
+  const absPath = isAbsolute(customPoliciesPath)
+    ? customPoliciesPath
+    : resolve(process.cwd(), customPoliciesPath);
 
   if (!existsSync(absPath)) {
     if (opts?.strict) throw new Error(`Custom hooks file not found: ${absPath}`);
-    hookLogWarn(`customHooksPath not found: ${absPath}`);
+    hookLogWarn(`customPoliciesPath not found: ${absPath}`);
     return [];
   }
 

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

@@ -2,7 +2,7 @@
  * Hook event handler — invoked when Claude Code triggers a hook.
  *
  * Reads the JSON payload from stdin, loads enabled policies from
- * ~/.failproofai/hooks-config.json, evaluates matching policies, persists
+ * ~/.failproofai/policies-config.json, evaluates matching policies, persists
  * activity to disk, and returns the appropriate exit code + stdout response.
  */
 import type { HookEventType, SessionMetadata } from "./types";
@@ -71,7 +71,7 @@ export async function handleHookEvent(eventType: string): Promise<number> {
   registerBuiltinPolicies(config.enabledPolicies);
 
   // Load and register custom hooks (layer 2, after builtins)
-  const customHooksList = await loadCustomHooks(config.customHooksPath);
+  const customHooksList = await loadCustomHooks(config.customPoliciesPath);
   for (const hook of customHooksList) {
     const hookName = hook.name;
     const fn: PolicyFunction = async (ctx): Promise<PolicyResult> => {