aicodestat 0.0.1__tar.gz

aicodestat-0.0.1/PKG-INFO

@@ -0,0 +1,110 @@
+Metadata-Version: 2.4
+Name: aicodestat
+Version: 0.0.1
+Summary: A local-first metrics tool that analyzes how you use AI coding assistants.
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: fastapi>=0.104.0
+Requires-Dist: uvicorn[standard]>=0.24.0
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: rich>=13.0.0
+Requires-Dist: questionary>=2.0.0
+Requires-Dist: httpx>=0.25.0
+Requires-Dist: mcp>=1.0.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.4.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
+
+## CodeStat · AI Code Metrics
+
+> Quantify how much AI actually contributes to your codebase.
+
+[![CI](https://img.shields.io/github/actions/workflow/status/2hangchen/CodeStat/ci.yml?style=flat-square&label=CI)](https://github.com/2hangchen/CodeStat/actions)
+[![License](https://img.shields.io/github/license/2hangchen/CodeStat?style=flat-square)](LICENSE)
+
+`CodeStat` is a local metrics tool that analyzes how you use AI coding assistants:
+how many lines are generated by AI, how many are kept, and how this evolves over time.
+
+> 中文文档见：[`README.zh-CN.md`](./README.zh-CN.md)
+
+---
+
+## Features
+
+- **Global dashboard for all data**  
+  - AI generated lines, adopted lines, adoption & generation rates  
+  - File count, session count, quick bar chart overview
+
+- **Multi‑dimension queries**  
+  - **By file**: see how much of a file comes from AI and how much you kept  
+  - **By session**: analyze one coding session with detailed diff lines  
+  - **By project**: aggregate metrics for an entire repository
+
+- **Agent / model comparison**  
+  - Compare multiple sessions (agents / models / settings) side‑by‑side  
+  - See which one actually produces more adopted code instead of just more tokens
+
+- **Local‑first & privacy‑friendly**  
+  - All metrics are computed locally from your own diffs  
+  - No source code or prompts are sent to any remote service
+
+- **Nice CLI UX**  
+  - Rich‑based tables & colors, arrow‑key navigation  
+  - Minimal but informative header (MCP status + repo info)
+
+---
+
+## Demo
+
+> TODO: add real screenshots / GIFs from your terminal
+
+- **Global dashboard**
+
+  *(insert GIF or screenshot here)*
+
+- **Session metrics with diff lines**
+
+  *(insert GIF or screenshot here)*
+
+---
+
+## Quickstart
+
+### Install
+
+```bash
+git clone https://github.com/2hangchen/CodeStat.git
+cd CodeStat
+pip install -r requirements.txt
+```
+
+> Once published to PyPI you can alternatively run:  
+> `pip install codestat-ai`
+
+### Start the CLI
+
+```bash
+python .\cli\main.py
+```
+
+Use `↑/↓` to move, `Enter` to confirm.  
+Choose **“📈 Global Dashboard (All Data)”** to see an overview of your local metrics.
+
+---
+
+## Typical Workflows
+
+- **Measure your own AI usage**  
+  - Record one or more coding sessions with your IDE + MCP server  
+  - Run `CodeStat` and inspect:
+    - AI generated vs adopted lines
+    - Which files receive the most AI help
+
+- **Compare agents / models / prompts**  
+  - Map different sessions to different agents / models  
+  - Use **Compare Agents** to get a per‑session comparison table
+
+- **Project‑level health check**  
+  - For a given repo, run project metrics to see:
+    - Where AI contributes the most
+    - Whether AI‑generated code is actually being kept

aicodestat-0.0.1/README.md

@@ -0,0 +1,93 @@
+## CodeStat · AI Code Metrics
+
+> Quantify how much AI actually contributes to your codebase.
+
+[![CI](https://img.shields.io/github/actions/workflow/status/2hangchen/CodeStat/ci.yml?style=flat-square&label=CI)](https://github.com/2hangchen/CodeStat/actions)
+[![License](https://img.shields.io/github/license/2hangchen/CodeStat?style=flat-square)](LICENSE)
+
+`CodeStat` is a local metrics tool that analyzes how you use AI coding assistants:
+how many lines are generated by AI, how many are kept, and how this evolves over time.
+
+> 中文文档见：[`README.zh-CN.md`](./README.zh-CN.md)
+
+---
+
+## Features
+
+- **Global dashboard for all data**  
+  - AI generated lines, adopted lines, adoption & generation rates  
+  - File count, session count, quick bar chart overview
+
+- **Multi‑dimension queries**  
+  - **By file**: see how much of a file comes from AI and how much you kept  
+  - **By session**: analyze one coding session with detailed diff lines  
+  - **By project**: aggregate metrics for an entire repository
+
+- **Agent / model comparison**  
+  - Compare multiple sessions (agents / models / settings) side‑by‑side  
+  - See which one actually produces more adopted code instead of just more tokens
+
+- **Local‑first & privacy‑friendly**  
+  - All metrics are computed locally from your own diffs  
+  - No source code or prompts are sent to any remote service
+
+- **Nice CLI UX**  
+  - Rich‑based tables & colors, arrow‑key navigation  
+  - Minimal but informative header (MCP status + repo info)
+
+---
+
+## Demo
+
+> TODO: add real screenshots / GIFs from your terminal
+
+- **Global dashboard**
+
+  *(insert GIF or screenshot here)*
+
+- **Session metrics with diff lines**
+
+  *(insert GIF or screenshot here)*
+
+---
+
+## Quickstart
+
+### Install
+
+```bash
+git clone https://github.com/2hangchen/CodeStat.git
+cd CodeStat
+pip install -r requirements.txt
+```
+
+> Once published to PyPI you can alternatively run:  
+> `pip install codestat-ai`
+
+### Start the CLI
+
+```bash
+python .\cli\main.py
+```
+
+Use `↑/↓` to move, `Enter` to confirm.  
+Choose **“📈 Global Dashboard (All Data)”** to see an overview of your local metrics.
+
+---
+
+## Typical Workflows
+
+- **Measure your own AI usage**  
+  - Record one or more coding sessions with your IDE + MCP server  
+  - Run `CodeStat` and inspect:
+    - AI generated vs adopted lines
+    - Which files receive the most AI help
+
+- **Compare agents / models / prompts**  
+  - Map different sessions to different agents / models  
+  - Use **Compare Agents** to get a per‑session comparison table
+
+- **Project‑level health check**  
+  - For a given repo, run project metrics to see:
+    - Where AI contributes the most
+    - Whether AI‑generated code is actually being kept

aicodestat-0.0.1/aicodestat.egg-info/PKG-INFO

@@ -0,0 +1,110 @@
+Metadata-Version: 2.4
+Name: aicodestat
+Version: 0.0.1
+Summary: A local-first metrics tool that analyzes how you use AI coding assistants.
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: fastapi>=0.104.0
+Requires-Dist: uvicorn[standard]>=0.24.0
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: rich>=13.0.0
+Requires-Dist: questionary>=2.0.0
+Requires-Dist: httpx>=0.25.0
+Requires-Dist: mcp>=1.0.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.4.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
+
+## CodeStat · AI Code Metrics
+
+> Quantify how much AI actually contributes to your codebase.
+
+[![CI](https://img.shields.io/github/actions/workflow/status/2hangchen/CodeStat/ci.yml?style=flat-square&label=CI)](https://github.com/2hangchen/CodeStat/actions)
+[![License](https://img.shields.io/github/license/2hangchen/CodeStat?style=flat-square)](LICENSE)
+
+`CodeStat` is a local metrics tool that analyzes how you use AI coding assistants:
+how many lines are generated by AI, how many are kept, and how this evolves over time.
+
+> 中文文档见：[`README.zh-CN.md`](./README.zh-CN.md)
+
+---
+
+## Features
+
+- **Global dashboard for all data**  
+  - AI generated lines, adopted lines, adoption & generation rates  
+  - File count, session count, quick bar chart overview
+
+- **Multi‑dimension queries**  
+  - **By file**: see how much of a file comes from AI and how much you kept  
+  - **By session**: analyze one coding session with detailed diff lines  
+  - **By project**: aggregate metrics for an entire repository
+
+- **Agent / model comparison**  
+  - Compare multiple sessions (agents / models / settings) side‑by‑side  
+  - See which one actually produces more adopted code instead of just more tokens
+
+- **Local‑first & privacy‑friendly**  
+  - All metrics are computed locally from your own diffs  
+  - No source code or prompts are sent to any remote service
+
+- **Nice CLI UX**  
+  - Rich‑based tables & colors, arrow‑key navigation  
+  - Minimal but informative header (MCP status + repo info)
+
+---
+
+## Demo
+
+> TODO: add real screenshots / GIFs from your terminal
+
+- **Global dashboard**
+
+  *(insert GIF or screenshot here)*
+
+- **Session metrics with diff lines**
+
+  *(insert GIF or screenshot here)*
+
+---
+
+## Quickstart
+
+### Install
+
+```bash
+git clone https://github.com/2hangchen/CodeStat.git
+cd CodeStat
+pip install -r requirements.txt
+```
+
+> Once published to PyPI you can alternatively run:  
+> `pip install codestat-ai`
+
+### Start the CLI
+
+```bash
+python .\cli\main.py
+```
+
+Use `↑/↓` to move, `Enter` to confirm.  
+Choose **“📈 Global Dashboard (All Data)”** to see an overview of your local metrics.
+
+---
+
+## Typical Workflows
+
+- **Measure your own AI usage**  
+  - Record one or more coding sessions with your IDE + MCP server  
+  - Run `CodeStat` and inspect:
+    - AI generated vs adopted lines
+    - Which files receive the most AI help
+
+- **Compare agents / models / prompts**  
+  - Map different sessions to different agents / models  
+  - Use **Compare Agents** to get a per‑session comparison table
+
+- **Project‑level health check**  
+  - For a given repo, run project metrics to see:
+    - Where AI contributes the most
+    - Whether AI‑generated code is actually being kept

aicodestat-0.0.1/aicodestat.egg-info/SOURCES.txt

@@ -0,0 +1,40 @@
+README.md
+config.py
+local_mcp_server.py
+logging_config.py
+main.py
+pyproject.toml
+service_manager.py
+aicodestat.egg-info/PKG-INFO
+aicodestat.egg-info/SOURCES.txt
+aicodestat.egg-info/dependency_links.txt
+aicodestat.egg-info/entry_points.txt
+aicodestat.egg-info/requires.txt
+aicodestat.egg-info/top_level.txt
+cli/__init__.py
+cli/exporter.py
+cli/main.py
+cli/menus.py
+cli/views.py
+compute/__init__.py
+compute/cache.py
+compute/diff_engine.py
+compute/lcs_engine.py
+compute/metrics_service.py
+mcp/__init__.py
+mcp/agent_adapter.py
+mcp/api_schemas.py
+mcp/routes_after.py
+mcp/routes_before.py
+mcp/routes_tools.py
+storage/__init__.py
+storage/backup.py
+storage/db.py
+storage/models.py
+storage/scheduler.py
+tests/test_api.py
+tests/test_compute.py
+tests/test_storage.py
+utils/__init__.py
+utils/port_utils.py
+utils/time_utils.py

aicodestat-0.0.1/aicodestat.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

aicodestat-0.0.1/aicodestat.egg-info/entry_points.txt

@@ -0,0 +1,5 @@
+[console_scripts]
+code-stat = main:main
+code-stat-cli = cli.main:main
+code-stat-mcp = mcp_stdio_server:main
+local-mcp-server = local_mcp_server:main

aicodestat-0.0.1/aicodestat.egg-info/requires.txt

@@ -0,0 +1,11 @@
+fastapi>=0.104.0
+uvicorn[standard]>=0.24.0
+pydantic>=2.0.0
+rich>=13.0.0
+questionary>=2.0.0
+httpx>=0.25.0
+mcp>=1.0.0
+
+[dev]
+pytest>=7.4.0
+pytest-asyncio>=0.21.0

aicodestat-0.0.1/aicodestat.egg-info/top_level.txt

@@ -0,0 +1,10 @@
+cli
+compute
+config
+local_mcp_server
+logging_config
+main
+mcp
+service_manager
+storage
+utils

aicodestat-0.0.1/cli/__init__.py

@@ -0,0 +1,2 @@
+"""交互层（CLI）模块"""
+

aicodestat-0.0.1/cli/exporter.py

@@ -0,0 +1,111 @@
+"""Export query results to CSV/JSON"""
+import json
+import csv
+import logging
+from pathlib import Path
+from typing import Dict, Any, List
+from datetime import datetime
+from utils.time_utils import format_datetime
+
+logger = logging.getLogger(__name__)
+
+
+def export_to_json(data: Dict[str, Any], output_path: str) -> bool:
+    """
+    Export data as JSON format
+    
+    Args:
+        data: Data to export
+        output_path: Output file path
+    
+    Returns:
+        Whether successful
+    """
+    try:
+        output_file = Path(output_path)
+        output_file.parent.mkdir(parents=True, exist_ok=True)
+        
+        export_data = {
+            "export_time": format_datetime(datetime.now()),
+            "data": data
+        }
+        
+        with open(output_file, 'w', encoding='utf-8') as f:
+            json.dump(export_data, f, ensure_ascii=False, indent=2)
+        
+        logger.info(f"Data exported to JSON: {output_path}")
+        return True
+    except Exception as e:
+        logger.error(f"Failed to export to JSON: {e}")
+        return False
+
+
+def export_to_csv(metrics: Dict[str, Any], output_path: str) -> bool:
+    """
+    Export metrics data as CSV format
+    
+    Args:
+        metrics: Metrics data
+        output_path: Output file path
+    
+    Returns:
+        Whether successful
+    """
+    try:
+        output_file = Path(output_path)
+        output_file.parent.mkdir(parents=True, exist_ok=True)
+        
+        with open(output_file, 'w', newline='', encoding='utf-8') as f:
+            writer = csv.writer(f)
+            
+            # Write header row
+            writer.writerow(["Metric Name", "Value"])
+            
+            # Write metrics data
+            writer.writerow(["AI Generated Lines", metrics.get("ai_total_lines", 0)])
+            writer.writerow(["Adopted Lines", metrics.get("adopted_lines", 0)])
+            writer.writerow(["Code Adoption Rate (%)", metrics.get("adoption_rate", 0.0)])
+            writer.writerow(["Code Generation Rate (%)", metrics.get("generation_rate", 0.0)])
+            
+            if "file_count" in metrics:
+                writer.writerow(["Files Involved", metrics.get("file_count", 0)])
+            
+            if "session_count" in metrics:
+                writer.writerow(["Sessions", metrics.get("session_count", 0)])
+            
+            # If there are diff lines details, write them
+            diff_lines = metrics.get("diff_lines", [])
+            if diff_lines:
+                writer.writerow([])  # Empty row
+                writer.writerow(["Diff Lines Details"])
+                writer.writerow(["Diff Type", "Line Number", "Code Content"])
+                for diff_line in diff_lines:
+                    writer.writerow([
+                        diff_line.get("diff_type", ""),
+                        diff_line.get("line_number", ""),
+                        diff_line.get("line_content", "")
+                    ])
+        
+        logger.info(f"Data exported to CSV: {output_path}")
+        return True
+    except Exception as e:
+        logger.error(f"Failed to export to CSV: {e}")
+        return False
+
+
+def export_metrics(metrics: Dict[str, Any], output_path: str, format: str = "json") -> bool:
+    """
+    Export metrics data
+    
+    Args:
+        metrics: Metrics data
+        output_path: Output file path
+        format: Export format (json or csv)
+    
+    Returns:
+        Whether successful
+    """
+    if format.lower() == "csv":
+        return export_to_csv(metrics, output_path)
+    else:
+        return export_to_json(metrics, output_path)