failproofai 0.0.6-beta.3 → 0.0.6-beta.4

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

@@ -1,83 +0,0 @@
-/**
- * Shared launch logic for dev.ts and start.ts.
- */
-import { getDefaultClaudeProjectsPath } from "../lib/paths";
-import { spawn } from "child_process";
-import { realpathSync, existsSync } from "node:fs";
-import { resolve, dirname } from "node:path";
-import { fileURLToPath } from "node:url";
-import { parseScriptArgs } from "./parse-script-args";
-import { version } from "../package.json";
-
-export function launch(mode: "dev" | "start"): void {
-  const { claudeProjectsPath: parsedPath, loggingLevel, disableTelemetry, allowedDevOrigins, remainingArgs } = parseScriptArgs(process.argv.slice(2));
-
-  console.log(`
-    ______      _ __                       ____   ___    ____
-   / ____/___ _(_) /___  _________  ____  / __/  /   |  /  _/
-  / /_  / __ \`/ / / __ \\/ ___/ __ \\/ __ \\/ /_   / /| |  / /
- / __/ / /_/ / / / /_/ / /  / /_/ / /_/ / __/  / ___ |_/ /
-/_/    \\__,_/_/_/ .___/_/   \\____/\\____/_/    /_/  |_/___/
-               /_/   v${version}
-`);
-  console.log(`  ⭐ Star us:      https://github.com/exospherehost/failproofai`);
-  console.log(`  📖 Docs:         https://befailproof.ai\n`);
-
-  let claudeProjectsPath = parsedPath;
-
-  if (!claudeProjectsPath) {
-    claudeProjectsPath = getDefaultClaudeProjectsPath();
-    console.log(`Using default .claude projects path: ${claudeProjectsPath}`);
-  } else {
-    console.log(`Using custom .claude projects path: ${claudeProjectsPath}`);
-  }
-
-  process.env.CLAUDE_PROJECTS_PATH = claudeProjectsPath;
-
-  let cmd: string;
-  let cmdArgs: string[];
-  if (mode === "start") {
-    const portIdx = remainingArgs.indexOf("--port");
-    const port = portIdx >= 0 ? remainingArgs[portIdx + 1] : "8020";
-    process.env.PORT = port;
-    process.env.HOSTNAME = "0.0.0.0";
-    cmd = "node";
-    // Resolve the real package root via realpathSync so symlinked npm global binaries
-    // don't cause import.meta.url to point at the symlink dir instead of the package dir.
-    const packageRoot = process.env.FAILPROOFAI_PACKAGE_ROOT
-      ?? resolve(dirname(realpathSync(fileURLToPath(import.meta.url))), "..");
-    const serverJsPath = resolve(packageRoot, ".next/standalone/server.js");
-    if (!existsSync(serverJsPath)) {
-      console.error(
-        `\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`
-      );
-      process.exit(1);
-    }
-    cmdArgs = [serverJsPath];
-  } else {
-    cmd = "bunx";
-    cmdArgs = ["--bun", "next", "dev", ...remainingArgs];
-  }
-
-  const nextProcess = spawn(cmd, cmdArgs, {
-    stdio: "inherit",
-    env: {
-      ...process.env,
-      CLAUDE_PROJECTS_PATH: claudeProjectsPath,
-      ...(loggingLevel ? { FAILPROOFAI_LOG_LEVEL: loggingLevel } : {}),
-      ...(disableTelemetry ? { FAILPROOFAI_TELEMETRY_DISABLED: "1" } : {}),
-      ...(allowedDevOrigins ? { FAILPROOFAI_ALLOWED_DEV_ORIGINS: allowedDevOrigins.join(",") } : {}),
-    },
-  });
-
-  nextProcess.on("error", (error) => {
-    console.error("Error starting Next.js:", error);
-    process.exit(1);
-  });
-
-  nextProcess.on("exit", (code) => {
-    process.exit(code || 0);
-  });
-}

package/.next/standalone/scripts/parse-script-args.ts

@@ -1,87 +0,0 @@
-/**
- * Shared CLI argument parser for scripts/dev.ts and scripts/start.ts.
- */
-import { resolve } from "path";
-
-export interface ParsedScriptArgs {
-  claudeProjectsPath: string | undefined;
-  loggingLevel: string | undefined;
-  disableTelemetry: boolean;
-  allowedDevOrigins: string[] | undefined;
-  remainingArgs: string[];
-}
-
-function parseStringFlag(
-  flagName: string,
-  errorLabel: string,
-  inlineValue: string | null,
-  args: string[],
-  index: number,
-  options?: { resolve?: boolean },
-): { value: string; spliceCount: number } {
-  const raw = inlineValue ?? args[index + 1];
-  if (raw === undefined || (inlineValue === null && raw.startsWith("-"))) {
-    console.error(`Error: ${flagName} requires ${errorLabel}`);
-    process.exit(1);
-  }
-  const value = options?.resolve ? resolve(raw) : raw;
-  return { value, spliceCount: inlineValue !== null ? 1 : 2 };
-}
-
-export function parseScriptArgs(argv: string[]): ParsedScriptArgs {
-  const args = [...argv];
-  let claudeProjectsPath: string | undefined;
-  let loggingLevel: string | undefined;
-  let disableTelemetry = false;
-  let allowedDevOrigins: string[] | undefined;
-
-  for (let i = 0; i < args.length; i++) {
-    const arg = args[i];
-
-    const eqIdx = arg.indexOf("=");
-    const flag = eqIdx >= 0 ? arg.slice(0, eqIdx) : arg;
-    const inlineValue = eqIdx >= 0 ? arg.slice(eqIdx + 1) : null;
-
-    if (flag === "--projects-path" || flag === "-p") {
-      const { value, spliceCount } = parseStringFlag(flag, "a path argument", inlineValue, args, i);
-      claudeProjectsPath = value;
-      args.splice(i, spliceCount);
-      i--;
-      continue;
-    }
-
-    if (flag === "--logging") {
-      const raw = inlineValue ?? args[i + 1];
-      if (raw === undefined || (inlineValue === null && raw.startsWith("-"))) {
-        console.error("Error: --logging requires a level (info, warn, error)");
-        process.exit(1);
-      }
-      const val = raw.toLowerCase();
-      if (val !== "info" && val !== "warn" && val !== "error") {
-        console.error("Error: --logging must be one of: info, warn, error");
-        process.exit(1);
-      }
-      loggingLevel = val;
-      args.splice(i, inlineValue !== null ? 1 : 2);
-      i--;
-      continue;
-    }
-
-    if (flag === "--disable-telemetry") {
-      disableTelemetry = true;
-      args.splice(i, 1);
-      i--;
-      continue;
-    }
-
-    if (flag === "--allowed-origins") {
-      const { value, spliceCount } = parseStringFlag(flag, "a comma-separated list of origins", inlineValue, args, i);
-      allowedDevOrigins = value.split(",").map(s => s.trim()).filter(Boolean);
-      args.splice(i, spliceCount);
-      i--;
-      continue;
-    }
-  }
-
-  return { claudeProjectsPath, loggingLevel, disableTelemetry, allowedDevOrigins, remainingArgs: args };
-}

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

@@ -1,121 +0,0 @@
-#!/usr/bin/env node
-/**
- * postinstall script for the failproofai package.
- *
- * 1. Warns if hooks config exists but hooks are missing from Claude Code settings.
- * 2. Tracks a package_installed telemetry event.
- *
- * No external dependencies — Node.js built-ins only.
- */
-import { existsSync, readFileSync } from "node:fs";
-import { resolve } from "node:path";
-import { platform, arch, release, homedir, hostname } from "node:os";
-import { createHmac } from "node:crypto";
-import { trackInstallEvent } from "./install-telemetry.mjs";
-
-// Skip when running in development context (e.g. `bun install` in the source repo).
-// INIT_CWD is set by npm/bun to the directory where install was invoked; it differs
-// 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";
-
-function hashToId(raw) {
-  return createHmac("sha256", NAMESPACE).update(raw).digest("hex");
-}
-
-/**
- * Returns the current hooks configuration state.
- * @returns {{ configured: boolean, registered: boolean, policyCount: number }}
- */
-function checkHooks() {
-  const hooksConfigPath = resolve(homedir(), ".failproofai", "policies-config.json");
-  if (!existsSync(hooksConfigPath)) {
-    return { configured: false, registered: false, policyCount: 0 };
-  }
-
-  let config;
-  try {
-    config = JSON.parse(readFileSync(hooksConfigPath, "utf8"));
-  } catch {
-    return { configured: false, registered: false, policyCount: 0 };
-  }
-
-  if (!Array.isArray(config.enabledPolicies) || config.enabledPolicies.length === 0) {
-    return { configured: false, registered: false, policyCount: 0 };
-  }
-
-  const policyCount = config.enabledPolicies.length;
-
-  // Check if Claude Code settings have failproofai hooks
-  const settingsPath = resolve(homedir(), ".claude", "settings.json");
-  if (!existsSync(settingsPath)) {
-    printHooksWarning();
-    return { configured: true, registered: false, policyCount };
-  }
-
-  let settings;
-  try {
-    settings = JSON.parse(readFileSync(settingsPath, "utf8"));
-  } catch {
-    printHooksWarning();
-    return { configured: true, registered: false, policyCount };
-  }
-
-  if (!settings.hooks) {
-    printHooksWarning();
-    return { configured: true, registered: false, policyCount };
-  }
-
-  // Walk settings.hooks looking for failproofai entries
-  for (const matchers of Object.values(settings.hooks)) {
-    if (!Array.isArray(matchers)) continue;
-    for (const matcher of matchers) {
-      if (!matcher.hooks) continue;
-      if (matcher.hooks.some((h) => h[FAILPROOFAI_HOOK_MARKER] === true)) {
-        return { configured: true, registered: true, policyCount };
-      }
-    }
-  }
-
-  printHooksWarning();
-  return { configured: true, registered: false, policyCount };
-}
-
-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 policies --uninstall && failproofai policies --install\n`
-  );
-}
-
-let hooksResult = { configured: false, registered: false, policyCount: 0 };
-try {
-  hooksResult = checkHooks();
-} catch {
-  // Non-critical — don't fail the install
-}
-
-// Telemetry (best-effort, fire-and-forget)
-trackInstallEvent("package_installed", {
-  platform: platform(),
-  arch: arch(),
-  os_release: release(),
-  hostname_hash: hashToId(hostname()),
-  hooks_configured: hooksResult.configured,
-  hooks_registered: hooksResult.registered,
-  enabled_policy_count: hooksResult.policyCount,
-}).catch(() => {});

package/.next/standalone/scripts/preuninstall.mjs

@@ -1,131 +0,0 @@
-#!/usr/bin/env node
-/**
- * preuninstall script for the failproofai package.
- *
- * Removes failproofai hook entries from all reachable Claude Code settings files:
- *   - ~/.claude/settings.json            (user scope — always attempted)
- *   - {cwd}/.claude/settings.json        (project scope — if it exists)
- *   - {cwd}/.claude/settings.local.json  (local scope — if it exists)
- *
- * Does NOT delete ~/.failproofai/ (preserves cache, hooks-config, instance-id).
- *
- * Never exits non-zero — uninstall must not be blocked by cleanup failures.
- * No external dependencies — Node.js built-ins only.
- */
-import { readFileSync, writeFileSync, existsSync } from "node:fs";
-import { resolve } from "node:path";
-import { homedir, platform, arch } from "node:os";
-import { trackInstallEvent } from "./install-telemetry.mjs";
-
-// Skip when running in development context (same guard as postinstall.mjs).
-if (process.env.INIT_CWD && process.env.INIT_CWD === process.cwd()) process.exit(0);
-
-const FAILPROOFAI_HOOK_MARKER = "__failproofai_hook__";
-
-/**
- * Remove all failproofai-marked hook entries from a single settings file.
- * Returns the number of hook entries removed.
- * Writes the file only when at least one hook was removed.
- */
-function removeHooksFromFile(settingsPath) {
-  if (!existsSync(settingsPath)) return 0;
-
-  let settings;
-  try {
-    settings = JSON.parse(readFileSync(settingsPath, "utf8"));
-  } catch {
-    return 0; // Corrupt or unreadable — nothing to do
-  }
-
-  if (!settings?.hooks) return 0;
-
-  let hooksRemoved = 0;
-
-  for (const eventType of Object.keys(settings.hooks)) {
-    const matchers = settings.hooks[eventType];
-    if (!Array.isArray(matchers)) continue;
-
-    for (let i = matchers.length - 1; i >= 0; i--) {
-      const matcher = matchers[i];
-      if (!matcher.hooks) continue;
-
-      const before = matcher.hooks.length;
-      matcher.hooks = matcher.hooks.filter((h) => {
-        if (h[FAILPROOFAI_HOOK_MARKER] === true) return false; // marked entry
-        // Fallback for legacy installs that predate the marker
-        const cmd = typeof h.command === "string" ? h.command : "";
-        if (cmd.includes("failproofai") && cmd.includes("--hook")) return false;
-        return true;
-      });
-      hooksRemoved += before - matcher.hooks.length;
-
-      // Remove now-empty matchers
-      if (matcher.hooks.length === 0) {
-        matchers.splice(i, 1);
-      }
-    }
-
-    // Remove now-empty event type arrays
-    if (matchers.length === 0) {
-      delete settings.hooks[eventType];
-    }
-  }
-
-  // Remove now-empty hooks object
-  if (Object.keys(settings.hooks).length === 0) {
-    delete settings.hooks;
-  }
-
-  if (hooksRemoved > 0) {
-    try {
-      writeFileSync(settingsPath, JSON.stringify(settings, null, 2) + "\n", "utf8");
-    } catch {
-      // Best-effort — don't block uninstall
-    }
-  }
-
-  return hooksRemoved;
-}
-
-let totalRemoved = 0;
-
-try {
-  const home = homedir();
-  const projectCwd = process.cwd();
-
-  // Build list of settings files to clean, deduped in case cwd === home
-  const candidates = [
-    resolve(home, ".claude", "settings.json"),              // user scope
-    resolve(projectCwd, ".claude", "settings.json"),        // project scope
-    resolve(projectCwd, ".claude", "settings.local.json"),  // local scope
-  ];
-  const seen = new Set();
-  const settingsPaths = candidates.filter((p) => {
-    if (seen.has(p)) return false;
-    seen.add(p);
-    return true;
-  });
-
-  for (const settingsPath of settingsPaths) {
-    const removed = removeHooksFromFile(settingsPath);
-    if (removed > 0) {
-      console.log(`[failproofai] Removed ${removed} hook(s) from ${settingsPath}.`);
-      totalRemoved += removed;
-    }
-  }
-
-  if (totalRemoved === 0) {
-    console.log("[failproofai] No hook entries found to remove.");
-  }
-} catch {
-  // Never block uninstall
-}
-
-// Telemetry — best-effort, awaited so the process stays alive long enough to send
-try {
-  await trackInstallEvent("package_uninstalled", {
-    platform: platform(),
-    arch: arch(),
-    hooks_removed: totalRemoved,
-  });
-} catch {}

package/.next/standalone/scripts/publish-aliases.mjs

@@ -1,87 +0,0 @@
-#!/usr/bin/env node
-import { execSync } from 'child_process';
-import { readFileSync, writeFileSync, mkdirSync, rmSync, cpSync } from 'fs';
-import { join, dirname } from 'path';
-import { fileURLToPath } from 'url';
-
-const __dirname = dirname(fileURLToPath(import.meta.url));
-const rootPkg = JSON.parse(readFileSync(join(__dirname, '..', 'package.json'), 'utf8'));
-const VERSION = rootPkg.version;
-const DRY_RUN = process.argv.includes('--dry-run');
-const distTagIdx = process.argv.indexOf('--dist-tag');
-const DIST_TAG = distTagIdx !== -1 ? process.argv[distTagIdx + 1] : (VERSION.includes('-') ? 'beta' : 'latest');
-
-const ALIASES = [
-  // Formatting variants — no "ai", or hyphen/underscore separators
-  'failproof',
-  'failproof-ai',
-  'fail-proof-ai',
-  'failproof_ai',
-  'fail_proof_ai',
-  'fail-proofai',
-  // Missing one 'o' from "proof" — common single-char slip
-  'failprof',
-  'failprof-ai',
-  'failprofai',
-  'fail-prof-ai',
-  'failprof_ai',
-  // 'a'/'i' transposition — common keyboard slip
-  'faliproof',
-  'faliproof-ai',
-  'faliproofai',
-];
-
-const warnings = [];
-
-for (const name of ALIASES) {
-  const tmpDir = join('/tmp', `npm-alias-${name}-${Date.now()}`);
-  const binDir = join(tmpDir, 'bin');
-  mkdirSync(binDir, { recursive: true });
-
-  const pkg = {
-    name,
-    version: VERSION,
-    description: `Alias for failproofai — installs if you typed '${name}' instead of 'failproofai'`,
-    bin: { [name]: './bin/proxy.js' },
-    files: ['bin/'],
-    dependencies: { failproofai: VERSION },
-    publishConfig: { access: 'public' },
-    repository: rootPkg.repository,
-    homepage: rootPkg.homepage,
-    bugs: rootPkg.bugs,
-    license: rootPkg.license,
-  };
-
-  writeFileSync(join(tmpDir, 'package.json'), JSON.stringify(pkg, null, 2) + '\n');
-  cpSync(join(__dirname, 'alias-proxy.js'), join(binDir, 'proxy.js'));
-
-  if (DRY_RUN) {
-    console.log(`[dry-run] Would publish ${name}@${VERSION} (tag: ${DIST_TAG})`);
-    console.log(JSON.stringify(pkg, null, 2));
-    console.log('---');
-    rmSync(tmpDir, { recursive: true, force: true });
-    continue;
-  }
-
-  console.log(`Publishing ${name}@${VERSION}...`);
-  try {
-    execSync(`npm publish --tag ${DIST_TAG}`, { 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/.next/standalone/scripts/start.ts

@@ -1,3 +0,0 @@
-#!/usr/bin/env node
-import { launch } from "./launch";
-launch("start");

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

@@ -1,60 +0,0 @@
-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/scripts/translate-docs/cache.ts

@@ -1,62 +0,0 @@
-import { createHash } from "node:crypto";
-import { existsSync, readFileSync, writeFileSync } from "node:fs";
-import { dirname, join } from "node:path";
-import { fileURLToPath } from "node:url";
-import type { CacheEntry, TranslationCache } from "./types";
-
-const __dirname = dirname(fileURLToPath(import.meta.url));
-const CACHE_FILE = join(__dirname, ".translation-cache.json");
-
-export function contentHash(content: string): string {
-  return createHash("sha256").update(content).digest("hex").slice(0, 16);
-}
-
-export function readCache(): TranslationCache {
-  if (!existsSync(CACHE_FILE)) {
-    return { sourceHash: "", lastUpdated: "", translations: {} };
-  }
-  try {
-    return JSON.parse(readFileSync(CACHE_FILE, "utf-8"));
-  } catch {
-    return { sourceHash: "", lastUpdated: "", translations: {} };
-  }
-}
-
-export function writeCache(cache: TranslationCache): void {
-  cache.lastUpdated = new Date().toISOString();
-  writeFileSync(CACHE_FILE, JSON.stringify(cache, null, 2));
-}
-
-export function getCacheKey(sourcePath: string, lang: string): string {
-  return `${sourcePath}::${lang}`;
-}
-
-export function isCached(
-  cache: TranslationCache,
-  sourcePath: string,
-  lang: string,
-  sourceContent: string,
-): boolean {
-  const key = getCacheKey(sourcePath, lang);
-  const entry = cache.translations[key];
-  if (!entry) return false;
-  return entry.sourceHash === contentHash(sourceContent);
-}
-
-export function setCacheEntry(
-  cache: TranslationCache,
-  sourcePath: string,
-  lang: string,
-  sourceContent: string,
-  inputTokens: number,
-  outputTokens: number,
-): void {
-  const key = getCacheKey(sourcePath, lang);
-  cache.translations[key] = {
-    sourceHash: contentHash(sourceContent),
-    targetLang: lang,
-    translatedAt: new Date().toISOString(),
-    inputTokens,
-    outputTokens,
-  };
-}