ai-first-cli 1.3.0 → 1.3.5

package/CONTRIBUTING.md

@@ -1,89 +0,0 @@
-# Contributing to ai-first
-
-Thank you for your interest in contributing!
-
-## Development Setup
-
-```bash
-# Clone the repository
-git clone https://github.com/julianperezpesce/ai-first.git
-cd ai-first
-
-# Install dependencies
-npm install
-
-# Build
-npm run build
-
-# Run
-npm run run
-# or
-node dist/commands/ai-first.js
-```
-
-## Project Structure
-
-```
-ai-first/
-├── src/
-│   ├── analyzers/        # Analysis modules
-│   │   ├── architecture.ts
-│   │   ├── conventions.ts
-│   │   ├── entrypoints.ts
-│   │   └── techStack.ts
-│   ├── commands/        # CLI commands
-│   │   └── ai-first.ts
-│   ├── core/            # Core functionality
-│   │   ├── repoMapper.ts
-│   │   └── repoScanner.ts
-│   └── utils/           # Utilities
-│       └── fileUtils.ts
-├── dist/                # Compiled JavaScript
-├── package.json
-└── tsconfig.json
-```
-
-## Adding New Analyzers
-
-To add a new analyzer:
-
-1. Create a new file in `src/analyzers/`
-2. Export functions for detection and file generation
-3. Import and use in `src/commands/ai-first.ts`
-
-Example:
-```typescript
-// src/analyzers/myAnalyzer.ts
-import { FileInfo } from "../core/repoScanner.js";
-
-export interface MyAnalysis {
-  // Define your output type
-}
-
-export function analyzeMyFeature(files: FileInfo[]): MyAnalysis {
-  // Your analysis logic
-  return { /* ... */ };
-}
-
-export function generateMyFeatureFile(analysis: MyAnalysis): string {
-  return "# My Analysis\n" + /* ... */;
-}
-```
-
-## Running Tests
-
-Currently there are no tests. Contributions with tests are welcome!
-
-## Publishing to npm
-
-```bash
-# Update version in package.json
-npm version patch
-
-# Publish
-npm publish
-```
-
-## License
-
-MIT

package/FLOW.md

@@ -1,129 +0,0 @@
-# Flow Diagram
-
-```
-┌─────────────────────────────────────────────────────────────┐
-│                        ai-first CLI                         │
-└─────────────────────────────────────────────────────────────┘
-                              │
-                              ▼
-┌─────────────────────────────────────────────────────────────┐
-│  1. scanRepo(rootDir)                                       │
-│     - Recursively scan directory                            │
-│     - Filter by includeExtensions                           │
-│     - Return: FileInfo[]                                    │
-└─────────────────────────────────────────────────────────────┘
-                              │
-                              ▼
-┌─────────────────────────────────────────────────────────────┐
-│  2. Create output directory (default: ./ai)                │
-└─────────────────────────────────────────────────────────────┘
-                              │
-              ┌───────────────┼───────────────┐
-              ▼               ▼               ▼
-    ┌─────────────────┐ ┌───────────┐ ┌─────────────┐
-    │ 3a. repoMapper  │ │3b. techStack│ │3c. architecture│
-    │ - repo_map.md   │ │ - tech_stack│ │ - architecture│
-    │ - repo_map.json │ │    .md     │ │    .md       │
-    │ - summary.md    │ │             │ │               │
-    └─────────────────┘ └─────────────┘ └─────────────┘
-              │               │               │
-              └───────────────┼───────────────┘
-                              ▼
-    ┌─────────────────────────────────────────────────────────┐
-    │ 4. Analyzers Pipeline                                   │
-    │ ┌──────────────┐ ┌──────────────┐ ┌──────────────────┐  │
-    │ │entrypoints   │ │conventions   │ │symbols (NEW)    │  │
-    │ │.md           │ │.md           │ │.json (NEW)      │  │
-    └──────────────┘ └──────────────┘ └──────────────────┘  │
-    ┌──────────────────┐ ┌──────────────┐                    │
-    │dependencies (NEW)│ │ai_rules (NEW)│                    │
-    │.json             │ │.md           │                    │
-    └──────────────────┘ └──────────────┘                    │
-                              │
-                              ▼
-    ┌─────────────────────────────────────────────────────────┐
-    │ 5. generateUnifiedContext()                             │
-    │    - Combines all analysis into ai_context.md           │
-    └─────────────────────────────────────────────────────────┘
-                              │
-                              ▼
-    ┌─────────────────────────────────────────────────────────┐
-    │ 6. Output Files                                          │
-    │   ai/                                                    │
-    │   ├── ai_context.md      ← UNIFIED (most important!)    │
-    │   ├── repo_map.md                                        │
-    │   ├── repo_map.json     ← NEW                            │
-    │   ├── summary.md                                        │
-    │   ├── architecture.md                                    │
-    │   ├── tech_stack.md                                      │
-    │   ├── entrypoints.md                                     │
-    │   ├── conventions.md                                     │
-    │   ├── symbols.json       ← NEW                           │
-    │   ├── dependencies.json  ← NEW                           │
-    │   └── ai_rules.md       ← NEW                           │
-    └─────────────────────────────────────────────────────────┘
-```
-
----
-
-## Execution Flow
-
-```
-User runs: ai-first init
-
-    │
-    ▼
-┌────────────────────────────────────┐
-│ CLI Entry Point                     │
-│ - Parse args (--root, --output)    │
-│ - Handle 'init' command            │
-└────────────────────────────────────┘
-    │
-    ▼
-┌────────────────────────────────────┐
-│ runAIFirst(options)                │
-│ - rootDir: process.cwd()           │
-│ - outputDir: ./ai                  │
-└────────────────────────────────────┘
-    │
-    ▼
-┌────────────────────────────────────┐
-│ scanRepo(rootDir)                   │
-│ Returns: { files: FileInfo[] }      │
-└────────────────────────────────────┘
-    │
-    ▼
-┌────────────────────────────────────┐
-│ For each analyzer:                  │
-│ 1. analyze(files, rootDir)         │
-│ 2. generateXxxFile(result)        │
-│ 3. writeFile(outputPath, content)  │
-└────────────────────────────────────┘
-    │
-    ▼
-┌────────────────────────────────────┐
-│ generateUnifiedContext()            │
-│ - Combines all results             │
-│ - Creates ai_context.md            │
-└────────────────────────────────────┘
-    │
-    ▼
-┌────────────────────────────────────┐
-│ Return: { success, filesCreated }  │
-└────────────────────────────────────┘
-```
-
----
-
-## Analyzer Details
-
-| Analyzer | Output | Description |
-|----------|--------|-------------|
-| `repoMapper` | repo_map.md, repo_map.json, summary.md | Directory tree & file stats |
-| `techStack` | tech_stack.md | Languages, frameworks, package managers |
-| `architecture` | architecture.md | MVC, Clean Architecture, Hexagonal, etc. |
-| `entrypoints` | entrypoints.md | CLI, API, server entry points |
-| `conventions` | conventions.md | Naming, testing, linting conventions |
-| `symbols` | symbols.json | Functions, classes, interfaces (NEW) |
-| `dependencies` | dependencies.json | Import graph (NEW) |
-| `aiRules` | ai_rules.md | Guidelines for AI (NEW) |

package/install.sh

@@ -1,188 +0,0 @@
-#!/usr/bin/env bash
-# af (AI-First) Installer
-# Usage: curl -fsSL https://raw.githubusercontent.com/julianperezpesce/ai-first/master/install.sh | bash
-set -e
-
-AF_VERSION="${AF_VERSION:-1.2.2}"
-
-RED='\033[0;31m'
-GREEN='\033[0;32m'
-YELLOW='\033[1;33m'
-BLUE='\033[0;34m'
-NC='\033[0m'
-
-log_info() { echo -e "${GREEN}✓${NC} $1"; }
-log_warn() { echo -e "${YELLOW}⚠${NC} $1"; }
-log_error() { echo -e "${RED}✗${NC} $1"; }
-log_step() { echo -e "${BLUE}→${NC} $1"; }
-
-# Detect npm's global bin directory
-get_npm_global_bin() {
-    npm config get prefix --global 2>/dev/null
-}
-
-# Try to create symlink in a PATH directory
-setup_symlink() {
-    local src="$1"
-    local name="af"
-    
-    # Try /usr/local/bin first (standard)
-    if [ -w /usr/local/bin ] 2>/dev/null; then
-        ln -sf "$src" /usr/local/bin/$name
-        echo "/usr/local/bin/$name"
-        return 0
-    fi
-    
-    # Try ~/.local/bin (Freedesktop standard)
-    if [ -w "$HOME/.local/bin" ] 2>/dev/null || mkdir -p "$HOME/.local/bin" 2>/dev/null; then
-        ln -sf "$src" "$HOME/.local/bin/$name"
-        echo "$HOME/.local/bin/$name"
-        return 0
-    fi
-    
-    # Try ~/bin (legacy)
-    if [ -w "$HOME/bin" ] 2>/dev/null || mkdir -p "$HOME/bin" 2>/dev/null; then
-        ln -sf "$src" "$HOME/bin/$name"
-        echo "$HOME/bin/$name"
-        return 0
-    fi
-    
-    return 1
-}
-
-# Add directory to PATH in shell RC if not already present
-ensure_path() {
-    local dir="$1"
-    local rcfile=""
-    
-    # Find the active shell RC file
-    if [ -n "$ZSH_VERSION" ]; then
-        rcfile="$HOME/.zshrc"
-    elif [ -n "$BASH_VERSION" ]; then
-        rcfile="$HOME/.bashrc"
-    else
-        rcfile="$HOME/.profile"
-    fi
-    
-    # Check if dir is already in PATH
-    if echo "$PATH" | tr ':' '\n' | grep -qx "$dir"; then
-        return 0
-    fi
-    
-    # Check if already added in RC
-    if [ -f "$rcfile" ] && grep -q "$dir" "$rcfile" 2>/dev/null; then
-        return 0
-    fi
-    
-    # Add to RC
-    echo "" >> "$rcfile"
-    echo "# Added by ai-first-cli installer" >> "$rcfile"
-    echo "export PATH=\"$dir:\$PATH\"" >> "$rcfile"
-    
-    log_warn "Added $dir to PATH in $rcfile"
-    log_warn "Run: source $rcfile"
-}
-
-check_node() {
-    if ! command -v node &> /dev/null; then
-        log_error "Node.js not installed. Install Node.js 18+ first: https://nodejs.org"
-        exit 1
-    fi
-    NODE_VERSION=$(node -v | cut -d'v' -f2 | cut -d'.' -f1)
-    if [ "$NODE_VERSION" -lt 18 ]; then
-        log_error "Node.js 18+ required. Current: $(node -v)"
-        exit 1
-    fi
-    log_info "Node.js $(node -v) detected"
-}
-
-install_af() {
-    log_step "Installing af@${AF_VERSION}..."
-    npm install -g "ai-first-cli@${AF_VERSION}" 2>&1
-    log_info "npm install completed"
-}
-
-find_af_binary() {
-    # Find the af binary in npm's global bin directory
-    local prefix
-    prefix=$(npm config get prefix --global 2>/dev/null || npm config get prefix 2>/dev/null)
-    
-    if [ -n "$prefix" ] && [ -f "$prefix/bin/af" ]; then
-        echo "$prefix/bin/af"
-        return 0
-    fi
-    
-    if [ -n "$prefix" ] && [ -f "$prefix/bin/ai-first" ]; then
-        echo "$prefix/bin/ai-first"
-        return 0
-    fi
-    
-    # Try common locations
-    for dir in "$prefix/bin" "$HOME/.npm-global/bin" "/usr/local/bin" "$HOME/.local/bin" "$HOME/bin"; do
-        if [ -f "$dir/af" ]; then
-            echo "$dir/af"
-            return 0
-        fi
-        if [ -f "$dir/ai-first" ]; then
-            echo "$dir/ai-first"
-            return 0
-        fi
-    done
-    
-    return 1
-}
-
-verify_install() {
-    log_step "Verifying installation..."
-    
-    local af_path
-    af_path=$(find_af_binary) || {
-        log_error "Could not find af binary after installation"
-        log_error "npm prefix: $(npm config get prefix 2>/dev/null)"
-        exit 1
-    }
-    
-    log_info "Found af at: $af_path"
-    
-    # Try to create symlink in PATH
-    local symlink
-    if symlink=$(setup_symlink "$af_path"); then
-        log_info "Created symlink: $symlink"
-    else
-        log_warn "Could not create symlink in standard PATH location"
-        # Try adding the binary's directory to PATH
-        local bindir
-        bindir=$(dirname "$af_path")
-        ensure_path "$bindir"
-    fi
-    
-    echo ""
-    echo "  ╔══════════════════════════════════════╗"
-    echo "  ║       af installation complete!     ║"
-    echo "  ╚══════════════════════════════════════╝"
-    echo ""
-    echo "  Commands:"
-    echo "    af init          Initialize AI context"
-    echo "    af index         Generate SQLite index"
-    echo "    af doctor        Check repository health"
-    echo "    af --help        Show all commands"
-    echo ""
-    echo "  Quick start:"
-    echo "    af init          # Generate context files"
-    echo "    af doctor        # Check repository health"
-    echo ""
-}
-
-echo ""
-echo "  ██╗  ██╗ ██████╗ ████████╗███████╗"
-echo "  ██║  ██║██╔═══██╗╚══██╔══╝██╔════╝"
-echo "  ███████║██║   ██║   ██║   █████╗  "
-echo "  ██╔══██║██║   ██║   ██║   ██╔══╝  "
-echo "  ██║  ██║╚██████╔╝   ██║   ███████╗"
-echo "  ╚═╝  ╚═╝ ╚═════╝    ╚═╝   ╚══════╝"
-echo "  AI-First CLI Installer v${AF_VERSION}"
-echo ""
-
-check_node
-install_af
-verify_install

package/run-all-tests.sh

@@ -1,184 +0,0 @@
-#!/bin/bash
-#
-# MASTER TEST SCRIPT - ai-first-cli
-# Ejecuta TODOS los tests: unitarios + funcionales + integracion
-# 
-
-set -e
-
-PROJECT_ROOT="$(cd "$(dirname "$0")" && pwd)"
-DIST_DIR="$PROJECT_ROOT/dist"
-CLI="$DIST_DIR/commands/ai-first.js"
-
-# Colors
-RED='\033[0;31m'
-GREEN='\033[0;32m'
-YELLOW='\033[1;33m'
-BLUE='\033[0;34m'
-NC='\033[0m'
-
-TESTS_PASSED=0
-TESTS_FAILED=0
-
-log_info() {
-    echo -e "${BLUE}[INFO]${NC} $1"
-}
-
-log_success() {
-    echo -e "${GREEN}[PASS]${NC} $1"
-    ((TESTS_PASSED++))
-}
-
-log_error() {
-    echo -e "${RED}[FAIL]${NC} $1"
-    ((TESTS_FAILED++))
-}
-
-# ============================================
-# PHASE 1: BUILD
-# ============================================
-echo ""
-echo "==================================================="
-echo "PHASE 1: BUILD"
-echo "==================================================="
-echo ""
-
-log_info "Building TypeScript..."
-if npm run build > /dev/null 2>&1; then
-    log_success "TypeScript build"
-else
-    log_error "TypeScript build FAILED"
-    exit 1
-fi
-
-# ============================================
-# PHASE 2: UNIT TESTS (Vitest)
-# ============================================
-echo ""
-echo "==================================================="
-echo "PHASE 2: UNIT TESTS (Vitest)"
-echo "==================================================="
-echo ""
-
-log_info "Running vitest..."
-if npx vitest run 2>&1 | grep -q "passed"; then
-    # Extract test count
-    VITEST_OUTPUT=$(npx vitest run 2>&1)
-    TEST_COUNT=$(echo "$VITEST_OUTPUT" | grep -oE '[0-9]+ passed' | head -1 | grep -oE '[0-9]+')
-    log_success "Unit tests: $TEST_COUNT passed"
-else
-    log_error "Unit tests FAILED"
-fi
-
-# ============================================
-# PHASE 3: FUNCTIONAL TESTS
-# ============================================
-echo ""
-echo "==================================================="
-echo "PHASE 3: FUNCTIONAL TESTS (11 Adapters)"
-echo "==================================================="
-echo ""
-
-ADAPTERS="django-app laravel-app fastapi-app flask-app rails-app spring-boot-app nestjs-backend express-api react-app salesforce-cli python-cli"
-SYMBOLS_OK=0
-
-log_info "Testing symbol extraction..."
-for adapter in $ADAPTERS; do
-    PROJECT_DIR="$PROJECT_ROOT/test-projects/$adapter"
-    if [ -f "$PROJECT_DIR/ai-context/symbols.json" ]; then
-        SYMBOL_COUNT=$(cat "$PROJECT_DIR/ai-context/symbols.json" | grep -o '"id"' | wc -l)
-        if [ "$SYMBOL_COUNT" -gt 0 ]; then
-            ((SYMBOLS_OK++))
-            log_success "$adapter: $SYMBOL_COUNT symbols"
-        else
-            log_error "$adapter: 0 symbols"
-        fi
-    else
-        log_error "$adapter: symbols.json not found"
-    fi
-done
-
-if [ "$SYMBOLS_OK" -eq 11 ]; then
-    log_success "All 11 adapters have symbols > 0"
-else
-    log_error "Only $SYMBOLS_OK/11 adapters have symbols"
-fi
-
-# ============================================
-# PHASE 4: INTEGRATION TESTS
-# ============================================
-echo ""
-echo "==================================================="
-echo "PHASE 4: INTEGRATION TESTS"
-echo "==================================================="
-echo ""
-
-COMMANDS="init map index doctor"
-TOTAL_TESTS=0
-PASSED_TESTS=0
-
-for adapter in $ADAPTERS; do
-    PROJECT_DIR="$PROJECT_ROOT/test-projects/$adapter"
-    
-    for cmd in $COMMANDS; do
-        ((TOTAL_TESTS++))
-        
-        case $cmd in
-            "init")
-                if [ -d "$PROJECT_DIR/ai-context" ] && [ -f "$PROJECT_DIR/ai-context/symbols.json" ]; then
-                    ((PASSED_TESTS++))
-                else
-                    log_error "$adapter: init failed"
-                fi
-                ;;
-            "map")
-                if [ -f "$PROJECT_DIR/ai-context/graph/module-graph.json" ]; then
-                    ((PASSED_TESTS++))
-                else
-                    log_error "$adapter: map failed"
-                fi
-                ;;
-            "index")
-                if [ -f "$PROJECT_DIR/ai-context/index.db" ]; then
-                    ((PASSED_TESTS++))
-                else
-                    log_error "$adapter: index failed"
-                fi
-                ;;
-            "doctor")
-                if [ -f "$PROJECT_DIR/ai-context/repo_map.json" ]; then
-                    ((PASSED_TESTS++))
-                else
-                    log_error "$adapter: doctor failed"
-                fi
-                ;;
-        esac
-    done
-done
-
-log_info "Integration tests: $PASSED_TESTS/$TOTAL_TESTS passed"
-if [ "$PASSED_TESTS" -eq "$TOTAL_TESTS" ]; then
-    log_success "All integration tests passed"
-else
-    log_error "Some integration tests failed"
-fi
-
-# ============================================
-# FINAL SUMMARY
-# ============================================
-echo ""
-echo "==================================================="
-echo "FINAL SUMMARY"
-echo "==================================================="
-echo ""
-echo "Tests Passed: $TESTS_PASSED"
-echo "Tests Failed: $TESTS_FAILED"
-echo ""
-
-if [ "$TESTS_FAILED" -eq 0 ]; then
-    echo -e "${GREEN}ALL TESTS PASSED!${NC}"
-    exit 0
-else
-    echo -e "${RED}SOME TESTS FAILED!${NC}"
-    exit 1
-fi

package/test-projects/django-app/.ai-dev/ai_context.md

@@ -1,92 +0,0 @@
-# AI Context
-
-> This file provides a comprehensive overview of the repository for AI coding assistants.
-
----
-
-## Quick Overview
-
-- **Pattern**: Flat / Simple Structure
-- **Languages**: Markdown, JSON, Python
-- **Frameworks**: None
-- **Total Files**: 41
-
----
-
-## Table of Contents
-
-1. [Tech Stack](#tech-stack)
-2. [Architecture](#architecture)
-3. [Key Entrypoints](#key-entrypoints)
-4. [Code Conventions](#code-conventions)
-5. [AI Rules](#ai-rules)
-6. [Repository Map](#repository-map)
-
----
-
-## Tech Stack
-
-**Languages**: Markdown, JSON, Python
-
----
-
-## Architecture
-
-## Architectural Pattern
-**Primary**: Flat / Simple Structure
-
-## Key Modules
-| Module | Responsibility |
-|--------|----------------|
-| `README.md` | Contains 0 files |
-| `ai` | Contains 23 files |
-| `blog` | Contains 6 files |
-| `django_app` | Contains 4 files |
-| `manage.py` | Contains 0 files |
-| `users` | Contains 6 files |
-
-
----
-
-## Key Entrypoints
-
----
-
-## Code Conventions
-
-## Naming Conventions
-- **Files**: PascalCase
-
-## Project Structure
-
-## Code Style
-- **Semicolons**: Required
-
-
----
-
-## AI Rules
-
-- Language: Use Markdown, JSON, Python
-- Architecture: Follow Flat / Simple Structure pattern
-- File naming: PascalCase
-
----
-
-## Repository Map
-
-See repo_map.md for the full structure.
-
----
-
-## Notes for AI Assistants
-
-1. Follow the established naming conventions (see conventions.md)
-2. Use the detected frameworks and libraries
-3. Target the correct entrypoints for modifications
-4. Maintain the detected architecture patterns
-5. Follow AI rules in ai_rules.md
-
----
-
-*Generated by ai-first*