faf-cli 4.3.0 → 4.3.1

package/scripts/generate-drift-reports.sh

@@ -0,0 +1,111 @@
+#!/bin/bash
+# 📊 Generate Real Drift Reports for Social Media
+# Championship-grade proof of context-drift impact
+
+set -e
+
+echo "🍊 FAF DRIFT REPORT GENERATOR"
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo ""
+
+# Output directory for reports
+REPORT_DIR="/tmp/faf-drift-reports"
+mkdir -p "$REPORT_DIR"
+
+echo "📁 Reports will be saved to: $REPORT_DIR"
+echo ""
+
+# ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+# Report 1: FAF CLI itself
+# ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+echo "🏎️ REPORT 1: FAF CLI (Self-Analysis)"
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo ""
+
+cd "$(dirname "$0")/.."
+node dist/cli.js drift --export "$REPORT_DIR/faf-cli-drift.json" | tee "$REPORT_DIR/faf-cli-drift.txt"
+
+echo ""
+echo "✅ Report saved:"
+echo "   - JSON: $REPORT_DIR/faf-cli-drift.json"
+echo "   - Text: $REPORT_DIR/faf-cli-drift.txt"
+echo ""
+
+# ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+# Report 2: Other FAF projects (if available)
+# ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo "🔍 Scanning for other FAF projects..."
+echo ""
+
+# Check if faf-dev-tools exists
+if [ -d "/Users/wolfejam/FAF/faf-dev-tools" ]; then
+  echo "🌐 REPORT 2: faf-dev-tools"
+  echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+  echo ""
+
+  cd /Users/wolfejam/FAF/faf-dev-tools
+  node /Users/wolfejam/FAF/cli/dist/cli.js drift --export "$REPORT_DIR/faf-dev-tools-drift.json" | tee "$REPORT_DIR/faf-dev-tools-drift.txt"
+
+  echo ""
+  echo "✅ Report saved:"
+  echo "   - JSON: $REPORT_DIR/faf-dev-tools-drift.json"
+  echo "   - Text: $REPORT_DIR/faf-dev-tools-drift.txt"
+  echo ""
+fi
+
+# Check if claude-faf-mcp exists
+if [ -d "/Users/wolfejam/FAF/claude-faf-mcp" ]; then
+  echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+  echo "🔌 REPORT 3: claude-faf-mcp"
+  echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+  echo ""
+
+  cd /Users/wolfejam/FAF/claude-faf-mcp
+  node /Users/wolfejam/FAF/cli/dist/cli.js drift --export "$REPORT_DIR/claude-faf-mcp-drift.json" | tee "$REPORT_DIR/claude-faf-mcp-drift.txt"
+
+  echo ""
+  echo "✅ Report saved:"
+  echo "   - JSON: $REPORT_DIR/claude-faf-mcp-drift.json"
+  echo "   - Text: $REPORT_DIR/claude-faf-mcp-drift.txt"
+  echo ""
+fi
+
+# ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+# Generate Summary
+# ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo "📊 SUMMARY"
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo ""
+echo "All reports saved to: $REPORT_DIR"
+echo ""
+echo "Reports generated:"
+ls -lh "$REPORT_DIR"
+echo ""
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo "🎯 READY FOR SOCIAL MEDIA"
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo ""
+echo "Text reports (ready to copy/paste):"
+for file in "$REPORT_DIR"/*.txt; do
+  if [ -f "$file" ]; then
+    echo "  📄 $(basename "$file")"
+  fi
+done
+echo ""
+echo "JSON reports (for web visualization):"
+for file in "$REPORT_DIR"/*.json; do
+  if [ -f "$file" ]; then
+    echo "  📊 $(basename "$file")"
+  fi
+done
+echo ""
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo "Context-drift makes you pay."
+echo ".faf keeps you drift-free."
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo ""

package/scripts/industry-showcase.json

@@ -0,0 +1,122 @@
+{
+  "title": "FAF Industry Showcase",
+  "description": "Proof that FAF works across every language, framework, and project type",
+  "updated": "2026-02-08",
+  "categories": [
+    {
+      "name": "JavaScript/TypeScript",
+      "repos": [
+        "facebook/react",
+        "vuejs/core",
+        "angular/angular",
+        "sveltejs/svelte",
+        "vercel/next.js",
+        "nuxt/nuxt",
+        "microsoft/TypeScript",
+        "nodejs/node",
+        "denoland/deno",
+        "oven-sh/bun",
+        "expressjs/express",
+        "nestjs/nest"
+      ]
+    },
+    {
+      "name": "Python",
+      "repos": [
+        "python/cpython",
+        "django/django",
+        "pallets/flask",
+        "tiangolo/fastapi",
+        "huggingface/transformers",
+        "openai/whisper",
+        "pytorch/pytorch",
+        "tensorflow/tensorflow",
+        "scikit-learn/scikit-learn",
+        "jupyter/notebook"
+      ]
+    },
+    {
+      "name": "Systems/Low-level",
+      "repos": [
+        "ggml-org/whisper.cpp",
+        "rust-lang/rust",
+        "golang/go",
+        "ziglang/zig",
+        "redis/redis",
+        "nginx/nginx",
+        "curl/curl",
+        "git/git"
+      ]
+    },
+    {
+      "name": "Mobile",
+      "repos": [
+        "facebook/react-native",
+        "flutter/flutter",
+        "ionic-team/ionic-framework",
+        "expo/expo",
+        "realm/realm-swift",
+        "square/okhttp"
+      ]
+    },
+    {
+      "name": "Databases",
+      "repos": [
+        "postgres/postgres",
+        "mongodb/mongo",
+        "elastic/elasticsearch",
+        "clickhouse/clickhouse",
+        "cockroachdb/cockroach",
+        "supabase/supabase"
+      ]
+    },
+    {
+      "name": "DevOps/Cloud",
+      "repos": [
+        "kubernetes/kubernetes",
+        "docker/cli",
+        "hashicorp/terraform",
+        "ansible/ansible",
+        "prometheus/prometheus",
+        "grafana/grafana",
+        "vercel/vercel",
+        "netlify/cli"
+      ]
+    },
+    {
+      "name": "Web Frameworks",
+      "repos": [
+        "rails/rails",
+        "laravel/laravel",
+        "spring-projects/spring-boot",
+        "phoenixframework/phoenix",
+        "gin-gonic/gin",
+        "actix/actix-web"
+      ]
+    },
+    {
+      "name": "Developer Tools",
+      "repos": [
+        "neovim/neovim",
+        "prettier/prettier",
+        "eslint/eslint",
+        "webpack/webpack",
+        "vitejs/vite",
+        "vercel/turborepo",
+        "changesets/changesets",
+        "jestjs/jest"
+      ]
+    },
+    {
+      "name": "AI/ML Infrastructure",
+      "repos": [
+        "openai/openai-python",
+        "anthropics/anthropic-sdk-python",
+        "langchain-ai/langchain",
+        "run-llama/llama_index",
+        "chroma-core/chroma",
+        "pinecone-io/pinecone-python-client"
+      ]
+    }
+  ]
+}

package/scripts/mcp-ecosystem-research.sh

@@ -0,0 +1,58 @@
+#!/bin/bash
+# MCP Ecosystem Research - Get stats for all major MCP servers
+
+echo "🔍 MCP ECOSYSTEM RESEARCH"
+echo "========================="
+echo ""
+
+packages=(
+  "@modelcontextprotocol/sdk"
+  "@playwright/mcp"
+  "chrome-devtools-mcp"
+  "@mastra/mcp"
+  "n8n-mcp"
+  "mcp-proxy"
+  "@langchain/mcp-adapters"
+  "mcp-handler"
+  "tavily-mcp"
+  "n8n-nodes-mcp"
+  "@supabase/mcp-utils"
+  "@upstash/context7-mcp"
+  "mcp-framework"
+  "@hono/mcp"
+  "gemini-mcp-tool"
+  "@expo/mcp-tunnel"
+  "@browsermcp/mcp"
+  "@agent-infra/mcp-server-browser"
+  "@mobilenext/mobile-mcp"
+  "mcp-hello-world"
+  "@mzxrai/mcp-webresearch"
+)
+
+for pkg in "${packages[@]}"; do
+  echo "📦 $pkg"
+
+  # Get package info
+  info=$(npm view "$pkg" version description 2>/dev/null)
+  if [ $? -eq 0 ]; then
+    echo "   $info" | sed 's/^/   /'
+
+    # Get download stats
+    downloads=$(curl -s "https://api.npmjs.org/downloads/point/last-week/$pkg" 2>/dev/null)
+    if [ $? -eq 0 ]; then
+      dl_count=$(echo "$downloads" | grep -o '"downloads":[0-9]*' | cut -d: -f2)
+      if [ -n "$dl_count" ]; then
+        # Format with commas
+        formatted=$(printf "%'d" $dl_count 2>/dev/null || echo $dl_count)
+        echo "   📊 Weekly downloads: $formatted"
+      fi
+    fi
+  else
+    echo "   ⚠️  Package not found"
+  fi
+
+  echo ""
+  sleep 0.2  # Rate limit
+done
+
+echo "✅ Research complete!"

package/scripts/migrate-yaml-imports.sh

@@ -0,0 +1,55 @@
+#!/bin/bash
+# 🔥 ROCK SOLID YAML FIX - Migrate all files to use fix-once/yaml
+# FIX ONCE, DONE FOREVER
+
+set -e
+
+echo "🔧 Migrating all YAML imports to fix-once/yaml..."
+echo ""
+
+# Find all TypeScript files with yaml imports
+FILES=$(grep -r "import.*yaml" src/ --include="*.ts" -l || true)
+
+COUNT=0
+for file in $FILES; do
+  # Skip the fix-once/yaml.ts file itself
+  if [[ "$file" == *"fix-once/yaml.ts"* ]]; then
+    continue
+  fi
+
+  echo "📝 Processing: $file"
+
+  # Pattern 1: import * as YAML from 'yaml'
+  sed -i '' "s|import \* as YAML from ['\"]yaml['\"]|import { parse as parseYAML, stringify as stringifyYAML } from '../fix-once/yaml'|g" "$file"
+  sed -i '' "s|import \* as YAML from ['\"]yaml['\"]|import { parse as parseYAML, stringify as stringifyYAML } from '../../fix-once/yaml'|g" "$file"
+  sed -i '' "s|import \* as YAML from ['\"]yaml['\"]|import { parse as parseYAML, stringify as stringifyYAML } from '../../../fix-once/yaml'|g" "$file"
+
+  # Pattern 2: import * as yaml from 'yaml'
+  sed -i '' "s|import \* as yaml from ['\"]yaml['\"]|import { parse as parseYAML, stringify as stringifyYAML } from '../fix-once/yaml'|g" "$file"
+  sed -i '' "s|import \* as yaml from ['\"]yaml['\"]|import { parse as parseYAML, stringify as stringifyYAML } from '../../fix-once/yaml'|g" "$file"
+  sed -i '' "s|import \* as yaml from ['\"]yaml['\"]|import { parse as parseYAML, stringify as stringifyYAML } from '../../../fix-once/yaml'|g" "$file"
+
+  # Pattern 3: import yaml from 'yaml'
+  sed -i '' "s|import yaml from ['\"]yaml['\"]|import { parse as parseYAML, stringify as stringifyYAML } from '../fix-once/yaml'|g" "$file"
+  sed -i '' "s|import yaml from ['\"]yaml['\"]|import { parse as parseYAML, stringify as stringifyYAML } from '../../fix-once/yaml'|g" "$file"
+  sed -i '' "s|import yaml from ['\"]yaml['\"]|import { parse as parseYAML, stringify as stringifyYAML } from '../../../fix-once/yaml'|g" "$file"
+
+  # Pattern 4: import { parse, stringify } from 'yaml'
+  sed -i '' "s|import { parse, stringify } from ['\"]yaml['\"]|import { parse as parseYAML, stringify as stringifyYAML } from '../fix-once/yaml'|g" "$file"
+  sed -i '' "s|import { parse, stringify } from ['\"]yaml['\"]|import { parse as parseYAML, stringify as stringifyYAML } from '../../fix-once/yaml'|g" "$file"
+  sed -i '' "s|import { parse, stringify } from ['\"]yaml['\"]|import { parse as parseYAML, stringify as stringifyYAML } from '../../../fix-once/yaml'|g" "$file"
+
+  COUNT=$((COUNT + 1))
+done
+
+echo ""
+echo "✅ Migrated $COUNT files to use fix-once/yaml"
+echo ""
+echo "⚠️  MANUAL STEP REQUIRED:"
+echo "   Replace all instances of:"
+echo "   - YAML.parse(x) → parseYAML(x, { filepath: path })"
+echo "   - yaml.parse(x) → parseYAML(x, { filepath: path })"
+echo "   - YAML.stringify(x) → stringifyYAML(x)"
+echo "   - yaml.stringify(x) → stringifyYAML(x)"
+echo ""
+echo "🏎️ YAML is now ROCK SOLID - FIX ONCE, DONE FOREVER"

package/scripts/migrate-yaml.ts

@@ -0,0 +1,132 @@
+#!/usr/bin/env ts-node
+/**
+ * 🔥 ROCK SOLID YAML FIX - Automated Migration
+ * FIX ONCE, DONE FOREVER
+ *
+ * This script migrates ALL yaml imports to use fix-once/yaml
+ */
+
+import * as fs from 'fs';
+import * as path from 'path';
+
+const SRC_DIR = path.join(__dirname, '../src');
+
+function getAllTypeScriptFiles(dir: string): string[] {
+  const files: string[] = [];
+  const entries = fs.readdirSync(dir, { withFileTypes: true });
+
+  for (const entry of entries) {
+    const fullPath = path.join(dir, entry.name);
+    if (entry.isDirectory()) {
+      files.push(...getAllTypeScriptFiles(fullPath));
+    } else if (entry.isFile() && entry.name.endsWith('.ts')) {
+      files.push(fullPath);
+    }
+  }
+
+  return files;
+}
+
+interface MigrationResult {
+  file: string;
+  changed: boolean;
+  errors: string[];
+}
+
+function getRelativeImportPath(filePath: string): string {
+  // Get relative path from file to src/fix-once/yaml
+  const fileDir = path.dirname(filePath);
+  const targetPath = path.join(SRC_DIR, 'fix-once', 'yaml');
+  const relativePath = path.relative(fileDir, targetPath);
+
+  // Convert to Unix-style path for imports
+  return relativePath.replace(/\\/g, '/').replace(/\.ts$/, '');
+}
+
+function migrateFile(filePath: string): MigrationResult {
+  const result: MigrationResult = {
+    file: filePath,
+    changed: false,
+    errors: []
+  };
+
+  // Skip the fix-once/yaml.ts file itself
+  if (filePath.includes('fix-once/yaml.ts')) {
+    return result;
+  }
+
+  let content = fs.readFileSync(filePath, 'utf-8');
+  const originalContent = content;
+
+  // Calculate correct relative path
+  const relativePath = getRelativeImportPath(filePath);
+
+  // Pattern 1: import * as YAML from 'yaml'
+  content = content.replace(
+    /import \* as YAML from ['"]yaml['"]/g,
+    `import { parse as parseYAML, stringify as stringifyYAML } from '${relativePath}'`
+  );
+
+  // Pattern 2: import * as yaml from 'yaml'
+  content = content.replace(
+    /import \* as yaml from ['"]yaml['"]/g,
+    `import { parse as parseYAML, stringify as stringifyYAML } from '${relativePath}'`
+  );
+
+  // Pattern 3: import yaml from 'yaml'
+  content = content.replace(
+    /import yaml from ['"]yaml['"]/g,
+    `import { parse as parseYAML, stringify as stringifyYAML } from '${relativePath}'`
+  );
+
+  // Pattern 4: import { parse, stringify } from 'yaml'
+  content = content.replace(
+    /import { parse, stringify } from ['"]yaml['"]/g,
+    `import { parse as parseYAML, stringify as stringifyYAML } from '${relativePath}'`
+  );
+
+  // Replace usage patterns (basic - may need manual fixes)
+  content = content.replace(/YAML\.parse\(/g, 'parseYAML(');
+  content = content.replace(/yaml\.parse\(/g, 'parseYAML(');
+  content = content.replace(/YAML\.stringify\(/g, 'stringifyYAML(');
+  content = content.replace(/yaml\.stringify\(/g, 'stringifyYAML(');
+
+  if (content !== originalContent) {
+    fs.writeFileSync(filePath, content);
+    result.changed = true;
+  }
+
+  return result;
+}
+
+// Find all TypeScript files
+const files = getAllTypeScriptFiles(SRC_DIR);
+
+console.log('🔥 ROCK SOLID YAML MIGRATION');
+console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+console.log(`Found ${files.length} TypeScript files`);
+console.log('');
+
+const results: MigrationResult[] = [];
+let changedCount = 0;
+
+for (const file of files) {
+  const result = migrateFile(file);
+  if (result.changed) {
+    console.log(`✅ ${file.replace(SRC_DIR, 'src')}`);
+    changedCount++;
+  }
+  results.push(result);
+}
+
+console.log('');
+console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+console.log(`✅ Migration complete: ${changedCount} files updated`);
+console.log('');
+console.log('⚠️  NEXT STEPS (Manual):');
+console.log('   1. Search for parseYAML( calls');
+console.log('   2. Add { filepath: <path> } option where appropriate');
+console.log('   3. Example: parseYAML(content, { filepath: fafPath })');
+console.log('   4. Run: npm test to verify');
+console.log('');
+console.log('🏎️ YAML IS NOW ROCK SOLID - FIX ONCE, DONE FOREVER');