analysis_results.json

{
  "repo_name": "build-influence",
  "repo_path": "/Users/drorivry/develop/build-influence",
  "metadata": {
    "type": "git",
    "branches": [
      "main"
    ],
    "current_branch": "main"
  },
  "file_tree": [
    {
      "path": "requirements.txt",
      "absolute_path": "/Users/drorivry/develop/build-influence/requirements.txt",
      "size": 75,
      "type": "documentation",
      "ai_doc_insights": {
        "summary": "The requirements.txt file lists Python packages for a command-line application or library that involves configuration management, logging, progress tracking, and testing.",
        "features": [
          "Command-line interface creation",
          "Logging and monitoring",
          "Configuration file support (YAML, dotenv)",
          "Progress bar display",
          "Testing framework"
        ],
        "setup_steps": [
          "Install dependencies with pip: pip install -r requirements.txt"
        ],
        "usage_examples": [
          "python your_app.py --help",
          "pytest tests/",
          "python -m typer your_app.cli"
        ]
      }
    },
    {
      "path": "config.yaml",
      "absolute_path": "/Users/drorivry/develop/build-influence/config.yaml",
      "size": 1857,
      "type": "configuration"
    },
    {
      "path": "todo.md",
      "absolute_path": "/Users/drorivry/develop/build-influence/todo.md",
      "size": 12596,
      "type": "documentation",
      "ai_doc_insights": {
        "summary": "A comprehensive implementation checklist for a Code Repository Content Marketing System, guiding the creation of a tool that analyzes code repositories, generates and publishes technical marketing content, and manages user interaction and workflow.",
        "features": [
          "Project setup and dependency management",
          "Logging and configuration system",
          "CLI interface for all operations",
          "Repository analysis and parsing (code, documentation, features)",
          "Content generation using AI with platform adaptation",
          "User interaction (interview mode, content review, approval workflow)",
          "Integration with MCP and publication platforms (Dev.to, Twitter/X, LinkedIn)",
          "Scheduling and retry systems",
          "Comprehensive error handling",
          "Unit, integration, and end-to-end testing",
          "Performance optimization and caching",
          "Extensive user and developer documentation"
        ],
        "setup_steps": [
          "Create project directory structure",
          "Set up Python 3.12 virtual environment",
          "Create requirements.txt with dependencies (LiteLLM, MCP client, Loguru, Pytest, asyncio packages)",
          "Create setup.py for packaging",
          "Write initial README.md",
          "Create main entry script (main.py)",
          "Set up version control (git) and .gitignore"
        ],
        "usage_examples": [
          "Run repository analysis via CLI command",
          "Generate content for a repository using CLI",
          "Publish generated content to Dev.to, Twitter/X, or LinkedIn",
          "Configure user preferences and platform settings via CLI",
          "Schedule posts for future publication",
          "Preview and review content before approval and publishing"
        ]
      }
    },
    {
      "path": "README.md",
      "absolute_path": "/Users/drorivry/develop/build-influence/README.md",
      "size": 302,
      "type": "documentation",
      "ai_doc_insights": {
        "summary": "A system to analyze code repositories and automatically generate content for various platforms, helping developers build influence.",
        "features": [],
        "setup_steps": [],
        "usage_examples": []
      }
    },
    {
      "path": "analysis_results.json",
      "absolute_path": "/Users/drorivry/develop/build-influence/analysis_results.json",
      "size": 21687,
      "type": "configuration"
    },
    {
      "path": "setup.py",
      "absolute_path": "/Users/drorivry/develop/build-influence/setup.py",
      "size": 426,
      "type": "code",
      "ai_code_insights": {
        "purpose": "Defines the packaging and installation configuration for the 'build_influence' Python project using setuptools.",
        "key_elements": [],
        "dependencies": [
          "from setuptools import setup, find_packages"
        ],
        "interesting_aspects": [
          "uses entry_points to define a console script"
        ]
      }
    },
    {
      "path": ".gitignore",
      "absolute_path": "/Users/drorivry/develop/build-influence/.gitignore",
      "size": 2099,
      "type": "other"
    },
    {
      "path": "SPEC.md",
      "absolute_path": "/Users/drorivry/develop/build-influence/SPEC.md",
      "size": 4284,
      "type": "documentation",
      "ai_doc_insights": {
        "summary": "A fully automated system that analyzes code repositories and generates platform-specific content to boost project visibility and personal/professional branding across dev.to, Twitter/X, and LinkedIn.",
        "features": [
          "Analyzes personal and professional code repositories (GitHub, GitLab, local, etc.)",
          "Parses code, documentation, and README files",
          "Identifies technical highlights (architecture, features, tech stack, innovations)",
          "Generates tailored content for dev.to, Twitter/X, and LinkedIn",
          "AI-driven analysis: architecture recognition, innovation detection, performance review, etc.",
          "Supports 'interview mode' for interactive context gathering",
          "Configurable approval workflow and content review interface",
          "Integrates with MCP for up-to-date technology info and publication APIs",
          "Error handling with retries and notifications",
          "Flexible configuration (platforms, workflow, scheduling, tone, monitoring)",
          "Unit, integration, and acceptance testing strategy"
        ],
        "setup_steps": [
          "Set up Python 3.12 environment",
          "Install required dependencies: LiteLLM, MCP client/server, loguru, pytest, asyncio",
          "Configure MCP client/server per documentation",
          "Connect to code repositories (local, GitHub, GitLab, etc.)",
          "Set platform preferences, approval workflow, and publication scheduling"
        ],
        "usage_examples": [
          "Ingest a local repository and automatically generate a technical deep-dive for dev.to, a highlight tweet for Twitter/X, and a professional summary for LinkedIn.",
          "Enable interview mode to provide additional project context before content generation.",
          "Review and approve (or edit) generated content via the user interface before publication.",
          "Automatically publish approved content to all selected platforms through MCP integration.",
          "Configure the system to monitor a repository and schedule publication for future releases (future enhancement)."
        ]
      }
    },
    {
      "path": "prompt_plan.md",
      "absolute_path": "/Users/drorivry/develop/build-influence/prompt_plan.md",
      "size": 19712,
      "type": "documentation",
      "ai_doc_insights": {
        "summary": "The document outlines a detailed, phased implementation plan for a Code Repository Content Marketing System that automates the process of analyzing code repositories, generating AI-enhanced technical content, and publishing it across multiple platforms with user interaction and approval workflows.",
        "features": [
          "Automated repository analysis (code, documentation, technical features)",
          "AI-powered content generation with platform-specific adaptation",
          "Content review, editing, and approval workflow",
          "Multi-platform publication and scheduling (Dev.to, Twitter/X, LinkedIn)",
          "Robust logging, configuration, and error handling",
          "Interactive user interview mode for context gathering",
          "Extensible modular architecture for future enhancements"
        ],
        "setup_steps": [
          "Set up Python project structure with dependencies (LiteLLM, MCP, Loguru, Pytest, Asyncio)",
          "Implement logging (Loguru) and configuration management (YAML/JSON, env overrides)",
          "Create a basic CLI interface (Click or Typer) for main app functions",
          "Build foundation for repository parsing (local path, metadata, file categorization)",
          "Add code file parsing (language detection, function/class extraction, metrics)",
          "Enhance parser for documentation and README extraction",
          "Implement technical feature analysis and scoring"
        ],
        "usage_examples": [
          "Analyze a local Git repository and generate a technical deep-dive article for Dev.to",
          "Generate LinkedIn announcement content for a new release and schedule it for publication",
          "Run the CLI in interview mode to provide missing project context and customize content focus",
          "Review and edit AI-generated Twitter threads before approval and posting",
          "Configure approval workflow to require manual review for all LinkedIn posts"
        ]
      }
    },
    {
      "path": ".cursor/rules/clean-code.mdc",
      "absolute_path": "/Users/drorivry/develop/build-influence/.cursor/rules/clean-code.mdc",
      "size": 1865,
      "type": "other"
    },
    {
      "path": ".cursor/rules/tech-stack.mdc",
      "absolute_path": "/Users/drorivry/develop/build-influence/.cursor/rules/tech-stack.mdc",
      "size": 581,
      "type": "other"
    },
    {
      "path": ".cursor/rules/tailwind.mdc",
      "absolute_path": "/Users/drorivry/develop/build-influence/.cursor/rules/tailwind.mdc",
      "size": 2213,
      "type": "other"
    },
    {
      "path": ".cursor/rules/python.mdc",
      "absolute_path": "/Users/drorivry/develop/build-influence/.cursor/rules/python.mdc",
      "size": 3488,
      "type": "other"
    },
    {
      "path": ".cursor/rules/nextjs.mdc",
      "absolute_path": "/Users/drorivry/develop/build-influence/.cursor/rules/nextjs.mdc",
      "size": 1766,
      "type": "other"
    },
    {
      "path": ".cursor/rules/cloudflare-worker-typescript.mdc",
      "absolute_path": "/Users/drorivry/develop/build-influence/.cursor/rules/cloudflare-worker-typescript.mdc",
      "size": 2094,
      "type": "other"
    },
    {
      "path": "logs/build_influence.log",
      "absolute_path": "/Users/drorivry/develop/build-influence/logs/build_influence.log",
      "size": 1007459,
      "type": "other"
    },
    {
      "path": "src/build_influence.egg-info/PKG-INFO",
      "absolute_path": "/Users/drorivry/develop/build-influence/src/build_influence.egg-info/PKG-INFO",
      "size": 59,
      "type": "other"
    },
    {
      "path": "src/build_influence.egg-info/SOURCES.txt",
      "absolute_path": "/Users/drorivry/develop/build-influence/src/build_influence.egg-info/SOURCES.txt",
      "size": 574,
      "type": "documentation",
      "ai_doc_insights": {
        "summary": "Lists all files included in the build_influence Python package distribution.",
        "features": [
          "Tracks package contents for distribution",
          "Helps with package installation and deployment"
        ],
        "setup_steps": [
          "Generated automatically during package build process",
          "No manual setup required"
        ],
        "usage_examples": []
      }
    },
    {
      "path": "src/build_influence.egg-info/entry_points.txt",
      "absolute_path": "/Users/drorivry/develop/build-influence/src/build_influence.egg-info/entry_points.txt",
      "size": 60,
      "type": "documentation",
      "ai_doc_insights": {
        "summary": "Defines a console script entry point for running the build_influence CLI application.",
        "features": [
          "Provides a command-line interface via the 'build-influence' command."
        ],
        "setup_steps": [
          "Install the package to register the console script."
        ],
        "usage_examples": [
          "build-influence --help"
        ]
      }
    },
    {
      "path": "src/build_influence.egg-info/top_level.txt",
      "absolute_path": "/Users/drorivry/develop/build-influence/src/build_influence.egg-info/top_level.txt",
      "size": 16,
      "type": "documentation",
      "ai_doc_insights": {
        "summary": "A function or script to build or calculate influence, likely in a graph or network context.",
        "features": [
          "Calculates or constructs influence structures",
          "May process network or graph data",
          "Possibly updates or annotates nodes/edges with influence values"
        ],
        "setup_steps": [],
        "usage_examples": []
      }
    },
    {
      "path": "src/build_influence.egg-info/dependency_links.txt",
      "absolute_path": "/Users/drorivry/develop/build-influence/src/build_influence.egg-info/dependency_links.txt",
      "size": 1,
      "type": "documentation",
      "ai_doc_insights": {
        "error": "Empty file"
      }
    },
    {
      "path": "src/build_influence/__init__.py",
      "absolute_path": "/Users/drorivry/develop/build-influence/src/build_influence/__init__.py",
      "size": 35,
      "type": "code",
      "ai_code_insights": {
        "purpose": "Serves as the main package initializer for Build Influence.",
        "key_elements": [],
        "dependencies": [],
        "interesting_aspects": []
      }
    },
    {
      "path": "src/build_influence/cli.py",
      "absolute_path": "/Users/drorivry/develop/build-influence/src/build_influence/cli.py",
      "size": 8046,
      "type": "code",
      "ai_code_insights": {
        "purpose": "Implements a command-line interface (CLI) for the Build Influence tool, allowing users to analyze code repositories, generate and publish content, configure settings, and view logs.",
        "key_elements": [
          "callback",
          "analyze",
          "generate",
          "publish",
          "configure",
          "logs"
        ],
        "dependencies": [
          "import typer",
          "from loguru import logger",
          "import os",
          "from typing_extensions import Annotated",
          "import json",
          "from build_influence.utils import setup_logging",
          "from build_influence.config import config",
          "from build_influence.analysis import RepositoryAnalyzer"
        ],
        "interesting_aspects": [
          "Uses Typer for declarative CLI definition and automatic help generation",
          "Early logging setup via a @app.callback() function for global side effects",
          "Dynamic loading and printing of AI-generated code/doc insights",
          "Basic real-time log tailing (follow mode) implemented in Python",
          "Type-annotated CLI arguments/options for enhanced clarity and validation"
        ]
      }
    },
    {
      "path": "src/build_influence/analysis/feature_identifier.py",
      "absolute_path": "/Users/drorivry/develop/build-influence/src/build_influence/analysis/feature_identifier.py",
      "size": 8429,
      "type": "code",
      "ai_code_insights": {
        "purpose": "Identifies and summarizes high-level technical features from code analysis results using an LLM, synthesizing context and parsing AI output robustly.",
        "key_elements": [
          "FeatureIdentifier",
          "identify_features",
          "_synthesize_context",
          "_build_feature_prompt"
        ],
        "dependencies": [
          "from typing import Dict, Any, Optional",
          "import litellm",
          "import json",
          "from loguru import logger",
          "from build_influence.config import config",
          "from build_influence.utils import setup_logging"
        ],
        "interesting_aspects": [
          "Robust handling and cleaning of LLM JSON responses, including markdown stripping and partial JSON parsing.",
          "Synthesizes context with length limits and prioritizes most important file insights.",
          "Uses dynamic prompt construction for LLM.",
          "Handles LLM API errors and parsing exceptions gracefully.",
          "Demonstrates concrete example usage for local testing."
        ]
      }
    },
    {
      "path": "src/build_influence/analysis/analyzer.py",
      "absolute_path": "/Users/drorivry/develop/build-influence/src/build_influence/analysis/analyzer.py",
      "size": 21896,
      "type": "code",
      "ai_code_insights": {
        "purpose": "Performs automated analysis of a local code repository, using AI (LiteLLM) to extract insights from code and documentation files, build file trees, extract metadata, and identify high-level features.",
        "key_elements": [
          "RepositoryAnalyzer",
          "_is_excluded",
          "analyze",
          "_extract_metadata",
          "_build_file_tree",
          "_categorize_file",
          "_analyze_file_content_with_ai",
          "_analyze_code_file_with_ai",
          "_analyze_doc_file_with_ai"
        ],
        "dependencies": [
          "import subprocess",
          "from pathlib import Path",
          "from typing import List, Dict, Any",
          "import litellm",
          "import json",
          "from tqdm import tqdm",
          "from loguru import logger",
          "from build_influence.config import config",
          "from build_influence.analysis.feature_identifier import FeatureIdentifier"
        ],
        "interesting_aspects": [
          "Uses AI (LiteLLM) to analyze code and documentation files and extract structured JSON insights.",
          "Implements file type categorization and exclusion rules for repository traversal.",
          "Builds a file tree and integrates high-level feature identification using a separate 'FeatureIdentifier' class.",
          "Handles AI prompt/response parsing and error management robustly.",
          "Includes progress reporting via tqdm and logging with loguru.",
          "Supports both code and documentation AI analysis via adaptable prompt templates."
        ]
      }
    },
    {
      "path": "src/build_influence/analysis/__init__.py",
      "absolute_path": "/Users/drorivry/develop/build-influence/src/build_influence/analysis/__init__.py",
      "size": 175,
      "type": "code",
      "ai_code_insights": {
        "purpose": "Initializes the repository analysis module by exposing key classes for external use.",
        "key_elements": [
          "RepositoryAnalyzer",
          "FeatureIdentifier"
        ],
        "dependencies": [
          "from .analyzer import RepositoryAnalyzer",
          "from .feature_identifier import FeatureIdentifier"
        ],
        "interesting_aspects": [
          "uses __all__ to define public API"
        ]
      }
    },
    {
      "path": "src/build_influence/publication/__init__.py",
      "absolute_path": "/Users/drorivry/develop/build-influence/src/build_influence/publication/__init__.py",
      "size": 21,
      "type": "code",
      "ai_code_insights": {
        "purpose": "Defines the publication module; currently, it is a placeholder with no implemented logic.",
        "key_elements": [],
        "dependencies": [],
        "interesting_aspects": []
      }
    },
    {
      "path": "src/build_influence/config/__init__.py",
      "absolute_path": "/Users/drorivry/develop/build-influence/src/build_influence/config/__init__.py",
      "size": 65,
      "type": "code",
      "ai_code_insights": {
        "purpose": "Re-exports the 'config' object from the loader module for external use.",
        "key_elements": [
          "config"
        ],
        "dependencies": [
          "from .loader import config"
        ],
        "interesting_aspects": []
      }
    },
    {
      "path": "src/build_influence/config/loader.py",
      "absolute_path": "/Users/drorivry/develop/build-influence/src/build_influence/config/loader.py",
      "size": 4155,
      "type": "code",
      "ai_code_insights": {
        "purpose": "Loads application configuration from YAML file and environment variables, applies overrides, provides unified config object with dot notation access, and basic validation.",
        "key_elements": [
          "load_config",
          "config"
        ],
        "dependencies": [
          "import os",
          "import yaml",
          "from dotenv import load_dotenv",
          "from loguru import logger",
          "from box import Box",
          "from build_influence.utils.logging import setup_logging"
        ],
        "interesting_aspects": [
          "uses 'Box' for dot notation access to nested config",
          "environment variable pattern for overriding config values",
          "applies defaults and structure even if config file is missing",
          "logs warnings/errors for missing configs and validation"
        ]
      }
    },
    {
      "path": "src/build_influence/utils/logging.py",
      "absolute_path": "/Users/drorivry/develop/build-influence/src/build_influence/utils/logging.py",
      "size": 1876,
      "type": "code",
      "ai_code_insights": {
        "purpose": "Configures application-wide logging using Loguru, supporting console and file outputs with rotation and retention based on environment variables.",
        "key_elements": [
          "setup_logging"
        ],
        "dependencies": [
          "import sys",
          "import os",
          "from loguru import logger"
        ],
        "interesting_aspects": [
          "Uses Loguru for advanced logging features like async logging, rotation, retention, and enhanced exception diagnostics.",
          "Reads logging configuration from environment variables for flexibility.",
          "Ensures log directory exists before writing file logs.",
          "Custom log formatting for both console and file outputs."
        ]
      }
    },
    {
      "path": "src/build_influence/utils/__init__.py",
      "absolute_path": "/Users/drorivry/develop/build-influence/src/build_influence/utils/__init__.py",
      "size": 83,
      "type": "code",
      "ai_code_insights": {
        "purpose": "Provides logging setup utility for the module by exposing setup_logging.",
        "key_elements": [
          "setup_logging"
        ],
        "dependencies": [
          "from .logging import setup_logging"
        ],
        "interesting_aspects": []
      }
    },
    {
      "path": "src/build_influence/generation/__init__.py",
      "absolute_path": "/Users/drorivry/develop/build-influence/src/build_influence/generation/__init__.py",
      "size": 28,
      "type": "code",
      "ai_code_insights": {
        "purpose": "Defines the Content Generation module (no code present).",
        "key_elements": [],
        "dependencies": [],
        "interesting_aspects": []
      }
    }
  ],
  "files_analyzed_count": 21,
  "high_level_features": {
    "identified_features": [
      "Automated code repository analysis",
      "AI-powered technical content generation",
      "Platform-specific content publishing (dev.to, Twitter/X, LinkedIn)",
      "Command-line interface (CLI)",
      "User interaction and approval workflow",
      "Configuration management",
      "Progress tracking and logging",
      "Pluggable and modular architecture"
    ],
    "architectural_patterns": [
      "Modular package structure",
      "CLI application pattern",
      "Layered architecture (analysis, publication, CLI)",
      "AI/LLM integration for code analysis and content synthesis"
    ],
    "target_audience": "Developers and technical project maintainers seeking to increase project visibility and automate technical marketing tasks",
    "selling_points": [
      "Fully automated content marketing from code repositories",
      "Reduces manual effort in generating and sharing technical content",
      "Leverages AI/LLMs for high-quality, tailored content",
      "Multi-platform publishing in a single workflow",
      "Facilitates personal and project branding for developers"
    ],
    "confidence_score": 0.95
  }
}