lite-kits 0.1.1__py3-none-any.whl → 0.3.1__py3-none-any.whl

lite_kits/kits/dev/{github/prompts → commands/.github}/stats.prompt.md

@@ -1,163 +1,163 @@
----
-description: Generate concise project metrics for AI agent orientation
----
-
-# Project Statistics
-
-**Purpose**: Provide quick project overview metrics for AI agents joining a project or assessing scope.
-
-## Execution Steps
-
-Execute the following steps to gather project statistics:
-
-### 1. Count Lines of Code
-
-**Preferred method** (if tokei installed):
-```powershell
-# Check if tokei is available
-Get-Command tokei -ErrorAction SilentlyContinue
-
-# If available, use tokei for fast, accurate counts
-tokei --output json
-```
-
-**Fallback method** (if tokei not available):
-```powershell
-# Python
-(Get-ChildItem -Recurse -Filter *.py | Get-Content | Measure-Object -Line).Lines
-
-# JavaScript/TypeScript
-(Get-ChildItem -Recurse -Include *.js,*.ts | Get-Content | Measure-Object -Line).Lines
-
-# Markdown
-(Get-ChildItem -Recurse -Filter *.md | Get-Content | Measure-Object -Line).Lines
-
-# All files combined
-(Get-ChildItem -Recurse -File | Get-Content | Measure-Object -Line).Lines
-```
-
-### 2. Count Files and Directories
-
-```powershell
-# Count files (excluding hidden)
-(Get-ChildItem -Recurse -File | Where-Object { -not $_.FullName.Contains('\.') }).Count
-
-# Count directories (excluding hidden)
-(Get-ChildItem -Recurse -Directory | Where-Object { -not $_.FullName.Contains('\.') }).Count
-```
-
-### 3. Get Git History Summary
-
-```powershell
-# Total commits
-(git log --oneline | Measure-Object).Count
-
-# Contributor count
-(git log --format='%aN' | Sort-Object -Unique).Count
-
-# Recent activity
-git log --oneline -5
-```
-
-If not a git repository, skip this section.
-
-### 4. Check for Test Coverage
-
-Look for common coverage report files:
-```powershell
-# Python coverage files
-Get-ChildItem -Path . -Include .coverage,coverage.xml -Recurse -ErrorAction SilentlyContinue
-Get-ChildItem -Path htmlcov -Directory -ErrorAction SilentlyContinue
-
-# JavaScript coverage
-Get-ChildItem -Path coverage,.nyc_output -Directory -ErrorAction SilentlyContinue
-
-# If coverage files exist, try to extract percentage
-# Python: coverage report | Select-String TOTAL
-# JavaScript: Get-Content coverage/coverage-summary.json | ConvertFrom-Json
-```
-
-### 5. Generate Concise Table Output
-
-Provide stats in this format (~20 lines max):
-
-```markdown
-## Project Statistics
-
-**Code**:
-- Language1: X,XXX LOC (NN%)
-- Language2: XXX LOC (NN%)
-- Language3: XX LOC (NN%)
-
-**Structure**:
-- NN files, NN directories
-- NNN commits, N contributors
-
-**Testing**:
-- Coverage: NN% (or N/A)
-- Tests: NN files (or N/A)
-
-**Next Action**: [Explore src/ / Review tests / Check docs]
-```
-
-## Important Notes
-
-- **Be concise**: Keep output under 20 lines
-- **Use tables**: Well-formatted markdown tables or lists
-- **Handle missing tools**:
-  - No tokei → Use Get-ChildItem/Measure-Object fallback, note "Basic LOC count"
-  - Not a git repo → Skip git section, note "No git history"
-  - No coverage → Show "N/A" gracefully
-
-- **Percentages**: Calculate language percentages from total LOC
-- **Large repos**: If >100k LOC, note "Large project" and consider sampling
-- **Speed**: Target <5 second execution time
-
-## Edge Cases
-
-- **No git repository**: Skip git section, show file/LOC stats only
-- **No test coverage reports**: Show "Coverage: N/A"
-- **Tokei not installed**: Use PowerShell fallback, note in output
-- **Very large repo (1M+ LOC)**: Sample or provide high-level summary only
-- **No code files**: "Appears to be a documentation-only or data project"
-
-## Example Output
-
-```markdown
-## Project Statistics
-
-**Code**:
-- Python: 2,453 LOC (87%)
-- Markdown: 342 LOC (12%)
-- YAML: 28 LOC (1%)
-- Total: 2,823 LOC
-
-**Structure**:
-- 45 files, 12 directories
-- 127 commits, 3 contributors
-
-**Testing**:
-- Coverage: 78% (via pytest-cov)
-- Tests: 23 test files
-
-**Next Action**: Explore src/ directory to understand core modules
-```
-
-```markdown
-## Project Statistics
-
-**Code** (tokei not available, using basic count):
-- Python: ~1,200 lines
-- Markdown: ~400 lines
-- Total: ~1,600 lines (approximate)
-
-**Structure**:
-- 32 files, 8 directories
-- Not a git repository
-
-**Testing**:
-- Coverage: N/A
-- Tests: N/A
-
-**Next Action**: Check if this is a standalone library or tool
-```
+---
+description: Generate concise project metrics for AI agent orientation
+---
+
+# Project Statistics
+
+**Purpose**: Provide quick project overview metrics for AI agents joining a project or assessing scope.
+
+## Execution Steps
+
+Execute the following steps to gather project statistics:
+
+### 1. Count Lines of Code
+
+**Preferred method** (if tokei installed):
+```powershell
+# Check if tokei is available
+Get-Command tokei -ErrorAction SilentlyContinue
+
+# If available, use tokei for fast, accurate counts
+tokei --output json
+```
+
+**Fallback method** (if tokei not available):
+```powershell
+# Python
+(Get-ChildItem -Recurse -Filter *.py | Get-Content | Measure-Object -Line).Lines
+
+# JavaScript/TypeScript
+(Get-ChildItem -Recurse -Include *.js,*.ts | Get-Content | Measure-Object -Line).Lines
+
+# Markdown
+(Get-ChildItem -Recurse -Filter *.md | Get-Content | Measure-Object -Line).Lines
+
+# All files combined
+(Get-ChildItem -Recurse -File | Get-Content | Measure-Object -Line).Lines
+```
+
+### 2. Count Files and Directories
+
+```powershell
+# Count files (excluding hidden)
+(Get-ChildItem -Recurse -File | Where-Object { -not $_.FullName.Contains('\.') }).Count
+
+# Count directories (excluding hidden)
+(Get-ChildItem -Recurse -Directory | Where-Object { -not $_.FullName.Contains('\.') }).Count
+```
+
+### 3. Get Git History Summary
+
+```powershell
+# Total commits
+(git log --oneline | Measure-Object).Count
+
+# Contributor count
+(git log --format='%aN' | Sort-Object -Unique).Count
+
+# Recent activity
+git log --oneline -5
+```
+
+If not a git repository, skip this section.
+
+### 4. Check for Test Coverage
+
+Look for common coverage report files:
+```powershell
+# Python coverage files
+Get-ChildItem -Path . -Include .coverage,coverage.xml -Recurse -ErrorAction SilentlyContinue
+Get-ChildItem -Path htmlcov -Directory -ErrorAction SilentlyContinue
+
+# JavaScript coverage
+Get-ChildItem -Path coverage,.nyc_output -Directory -ErrorAction SilentlyContinue
+
+# If coverage files exist, try to extract percentage
+# Python: coverage report | Select-String TOTAL
+# JavaScript: Get-Content coverage/coverage-summary.json | ConvertFrom-Json
+```
+
+### 5. Generate Concise Table Output
+
+Provide stats in this format (~20 lines max):
+
+```markdown
+## Project Statistics
+
+**Code**:
+- Language1: X,XXX LOC (NN%)
+- Language2: XXX LOC (NN%)
+- Language3: XX LOC (NN%)
+
+**Structure**:
+- NN files, NN directories
+- NNN commits, N contributors
+
+**Testing**:
+- Coverage: NN% (or N/A)
+- Tests: NN files (or N/A)
+
+**Next Action**: [Explore src/ / Review tests / Check docs]
+```
+
+## Important Notes
+
+- **Be concise**: Keep output under 20 lines
+- **Use tables**: Well-formatted markdown tables or lists
+- **Handle missing tools**:
+  - No tokei → Use Get-ChildItem/Measure-Object fallback, note "Basic LOC count"
+  - Not a git repo → Skip git section, note "No git history"
+  - No coverage → Show "N/A" gracefully
+
+- **Percentages**: Calculate language percentages from total LOC
+- **Large repos**: If >100k LOC, note "Large project" and consider sampling
+- **Speed**: Target <5 second execution time
+
+## Edge Cases
+
+- **No git repository**: Skip git section, show file/LOC stats only
+- **No test coverage reports**: Show "Coverage: N/A"
+- **Tokei not installed**: Use PowerShell fallback, note in output
+- **Very large repo (1M+ LOC)**: Sample or provide high-level summary only
+- **No code files**: "Appears to be a documentation-only or data project"
+
+## Example Output
+
+```markdown
+## Project Statistics
+
+**Code**:
+- Python: 2,453 LOC (87%)
+- Markdown: 342 LOC (12%)
+- YAML: 28 LOC (1%)
+- Total: 2,823 LOC
+
+**Structure**:
+- 45 files, 12 directories
+- 127 commits, 3 contributors
+
+**Testing**:
+- Coverage: 78% (via pytest-cov)
+- Tests: 23 test files
+
+**Next Action**: Explore src/ directory to understand core modules
+```
+
+```markdown
+## Project Statistics
+
+**Code** (tokei not available, using basic count):
+- Python: ~1,200 lines
+- Markdown: ~400 lines
+- Total: ~1,600 lines (approximate)
+
+**Structure**:
+- 32 files, 8 directories
+- Not a git repository
+
+**Testing**:
+- Coverage: N/A
+- Tests: N/A
+
+**Next Action**: Check if this is a standalone library or tool
+```