failproofai 0.0.1-beta.9 → 0.0.2-beta.1

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,9 +1,9 @@
 {
   "name": "failproofai",
-  "version": "0.0.1-beta.9",
+  "version": "0.0.2-beta.1",
   "description": "Open-source hooks, policies, and project visualization for Claude Code & Agents SDK",
   "bin": {
-    "failproofai": "./bin/failproofai.mjs"
+    "failproofai": "./dist/cli.mjs"
   },
   "files": [
     "bin/",
@@ -11,6 +11,7 @@
     "scripts/",
     "lib/",
     ".next/standalone/",
+    "dist/",
     "README.md"
   ],
   "engines": {
@@ -18,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 --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/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];

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
-```