failproofai 0.0.1 → 0.0.2-beta.2

package/package.json

@@ -1,9 +1,9 @@
 {
   "name": "failproofai",
-  "version": "0.0.1",
+  "version": "0.0.2-beta.2",
   "description": "Open-source hooks, policies, and project visualization for Claude Code & Agents SDK",
   "bin": {
-    "failproofai": "./bin/failproofai.mjs"
+    "failproofai": "./dist/cli.mjs"
   },
   "files": [
     "bin/",
@@ -19,10 +19,11 @@
     "bun": ">=1.3.0"
   },
   "scripts": {
-    "predev": "bun link",
+    "predev": "bun run build:cli && bun link",
     "dev": "FAILPROOFAI_TELEMETRY_DISABLED=1 bun scripts/dev.ts --port 8020",
-    "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",
+    "build:cli": "bun build --target=node --format=esm --outfile=dist/cli.mjs bin/failproofai.mjs --external posthog-node && node -e \"const fs=require('fs');const c=fs.readFileSync('dist/cli.mjs','utf8');fs.writeFileSync('dist/cli.mjs',c.replace('#!/usr/bin/env bun','#!/usr/bin/env node').replace('// @bun\\n',''))\"",
+    "build": "bun build --target=node --format=cjs --outfile=dist/index.js src/index.ts && bun run build:cli && bun --bun next build && node -e \"const {cpSync}=require('fs');cpSync('.next/static','.next/standalone/.next/static',{recursive:true});\"",
+    "prestart": "bun run build:cli && bun link",
     "start": "FAILPROOFAI_TELEMETRY_DISABLED=1 bun scripts/start.ts",
     "test": "vitest",
     "test:run": "vitest run",

package/scripts/launch.ts

@@ -49,7 +49,7 @@ export function launch(mode: "dev" | "start"): void {
     const serverJsPath = resolve(packageRoot, ".next/standalone/server.js");
     if (!existsSync(serverJsPath)) {
       console.error(
-        `\nError: Cannot find server binary at:\n  ${serverJsPath}\n\n` +
+        `\nError: Cannot find server.js at:\n  ${serverJsPath}\n\n` +
         `The package may be missing its build output.\n` +
         `Try reinstalling:\n  npm install -g failproofai@latest\n`
       );

package/scripts/postinstall.mjs

@@ -18,6 +18,17 @@ import { trackInstallEvent } from "./install-telemetry.mjs";
 // from process.cwd() only when we are being installed as a dependency by someone else.
 if (!process.env.INIT_CWD || process.env.INIT_CWD === process.cwd()) process.exit(0);
 
+// Verify server.js exists — fail the install early if the dashboard build is missing.
+const serverJsPath = resolve(process.cwd(), ".next", "standalone", "server.js");
+if (!existsSync(serverJsPath)) {
+  console.error(
+    `\n[failproofai] Error: server.js not found at:\n  ${serverJsPath}\n\n` +
+    `  The package may not have been built correctly.\n` +
+    `  Try reinstalling: npm install -g failproofai@latest\n`
+  );
+  process.exit(1);
+}
+
 const FAILPROOFAI_HOOK_MARKER = "__failproofai_hook__";
 const NAMESPACE = "failproofai-telemetry-v1";
 

package/src/cli-error.ts

@@ -0,0 +1,18 @@
+/**
+ * CliError — structured error for the failproofai CLI.
+ *
+ * Throw this for any error that should be reported to the user as a clean
+ * message (no stack trace). The exit code communicates the failure class:
+ *
+ *   1 — user error   (bad args, unknown policy name, invalid flag)
+ *   2 — internal     (file I/O failure, unexpected state)
+ */
+export class CliError extends Error {
+  readonly exitCode: 1 | 2;
+
+  constructor(message: string, exitCode: 1 | 2 = 1) {
+    super(message);
+    this.name = "CliError";
+    this.exitCode = exitCode;
+  }
+}

package/src/hooks/manager.ts

@@ -21,6 +21,7 @@ import { BUILTIN_POLICIES } from "./builtin-policies";
 import { loadCustomHooks } from "./custom-hooks-loader";
 import { trackHookEvent } from "./hook-telemetry";
 import { getInstanceId, hashToId } from "../../lib/telemetry-id";
+import { CliError } from "../cli-error";
 
 const VALID_POLICY_NAMES = new Set(BUILTIN_POLICIES.map((p) => p.name));
 
@@ -67,7 +68,7 @@ function resolveFailproofaiBinary(): string {
     // `where` on Windows may return multiple lines; take the first
     return result.split("\n")[0].trim();
   } catch {
-    throw new Error(
+    throw new CliError(
       "failproofai binary not found in PATH.\n" +
       "Install it globally first: npm install -g failproofai"
     );
@@ -85,7 +86,7 @@ function validatePolicyNames(names: string[]): void {
   const invalid = names.filter((n) => !VALID_POLICY_NAMES.has(n));
   if (invalid.length > 0) {
     const validList = [...VALID_POLICY_NAMES].join(", ");
-    throw new Error(
+    throw new CliError(
       `Unknown policy name(s): ${invalid.join(", ")}\n` +
       `Valid policies: ${validList}`
     );
@@ -185,6 +186,20 @@ export async function installHooks(
   customPoliciesPath?: string,
   removeCustomHooks = false,
 ): Promise<void> {
+  // Validate user input first before any system checks
+  if (policyNames !== undefined && policyNames.length > 0) {
+    const nonAllNames = policyNames.filter((n) => n !== "all");
+    // Check unknown names first (most actionable error for the user)
+    if (nonAllNames.length > 0) validatePolicyNames(nonAllNames);
+    // Then check if "all" is mixed with valid specific names
+    if (policyNames.includes("all") && nonAllNames.length > 0) {
+      throw new CliError(
+        `"all" cannot be combined with specific policy names.\n` +
+        `Use either: --install all  or  --install block-sudo sanitize-jwt ...`
+      );
+    }
+  }
+
   const binaryPath = resolveFailproofaiBinary();
 
   // Capture existing config before overwriting (used for telemetry diff)
@@ -201,7 +216,6 @@ export async function installHooks(
         .filter((p) => includeBeta || !p.beta)
         .map((p) => p.name);
     } else {
-      if (policyNames.length > 0) validatePolicyNames(policyNames);
       incoming = policyNames;
     }
     // Additive: union with whatever was already enabled, deduplicated.

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

@@ -1,48 +0,0 @@
-# Failproof AI — Documentation
-
-Open-source hooks, policies, and session visualization for **Claude Code** and the **Agents SDK**. Runs entirely locally — no data leaves your machine.
-
----
-
-## Documentation
-
-| Guide | Description |
-|-------|-------------|
-| [Getting Started](./getting-started.md) | Install failproofai, enable policies, and take it for a spin |
-| [CLI Reference](./cli-reference.md) | All commands, flags, and environment variables |
-| [Configuration](./configuration.md) | Config file format, three-scope system, and merge rules |
-| [Built-in Policies](./built-in-policies.md) | All 35+ policies with descriptions and parameters |
-| [Custom Hooks](./custom-hooks.md) | Write your own policies in JavaScript |
-| [Dashboard](./dashboard.md) | Session viewer, policy management, and activity log |
-| [Architecture](./architecture.md) | How the hook handler, config loading, and policy evaluation work |
-| [Testing](./testing.md) | Unit tests, E2E tests, and test helpers |
-| [Package Aliases](./package-aliases.md) | Registered typosquat-prevention aliases and how they work |
-
----
-
-## Quick reference
-
-**Install:**
-```bash
-npm install -g failproofai
-```
-
-**Enable policies globally:**
-```bash
-failproofai --install-policies
-```
-
-**Launch dashboard:**
-```bash
-failproofai
-```
-
-**List active policies:**
-```bash
-failproofai --list-policies
-```
-
-**Add a custom policy file:**
-```bash
-failproofai --install-policies --custom ./my-policies.js
-```