New Automation Scripts - v2.0.1
Overview
The following scripts have been added to enhance automation capabilities across analysis, validation, maintenance, documentation, and utility categories.
Analysis Scripts
analyze_dependencies.py
Analyzes project dependencies across multiple package managers (Python, npm, composer).
python3 scripts/analysis/analyze_dependencies.py
python3 scripts/analysis/analyze_dependencies.py /path/to/project --json
python3 scripts/analysis/analyze_dependencies.py --check-outdated
code_metrics.py
Analyzes code metrics including lines of code, file counts, and language distribution.
python3 scripts/analysis/code_metrics.py
python3 scripts/analysis/code_metrics.py /path/to/project --json
Automation Scripts
setup_dev_environment.py
Quick setup script for new contributors to configure their development environment.
python3 scripts/automation/setup_dev_environment.py
python3 scripts/automation/setup_dev_environment.py --skip-install
check_outdated_actions.py
Checks for outdated Gitea Actions in workflow files.
python3 scripts/automation/check_outdated_actions.py
python3 scripts/automation/check_outdated_actions.py --workflow-dir path/to/workflows
Validation Scripts
check_markdown_links.py
Validates links in markdown files to ensure they are not broken. Returns exit code 1 if broken links are found.
python3 scripts/validate/check_markdown_links.py
python3 scripts/validate/check_markdown_links.py docs/ --skip-external
find_todos.py
Finds and reports TODO, FIXME, and other code comments across the codebase.
python3 scripts/validate/find_todos.py
python3 scripts/validate/find_todos.py --markers TODO FIXME --group-by file
check_license_headers.py
Checks and optionally fixes missing or incorrect GPL-3.0-or-later license headers. Returns exit code 1 if missing headers are found.
python3 scripts/validate/check_license_headers.py
python3 scripts/validate/check_license_headers.py --fix --year 2026
Maintenance Scripts
update_copyright_year.py
Updates copyright year in file headers across the codebase. Dry-run by default.
python3 scripts/maintenance/update_copyright_year.py
python3 scripts/maintenance/update_copyright_year.py --year 2026 --apply
clean_old_branches.py
Identifies and optionally deletes old Git branches. Protects main/master/develop.
python3 scripts/maintenance/clean_old_branches.py --days 90
python3 scripts/maintenance/clean_old_branches.py --delete-merged
python3 scripts/maintenance/clean_old_branches.py --delete-all --force
Documentation Scripts
generate_script_catalog.py
Generates a comprehensive catalog of all scripts in the repository.
python3 scripts/docs/generate_script_catalog.py
python3 scripts/docs/generate_script_catalog.py --output SCRIPT_CATALOG.md
check_doc_coverage.py
Checks documentation coverage by identifying undocumented scripts and templates.
python3 scripts/docs/check_doc_coverage.py
Utility Scripts
git_helper.sh
Helper script for common git operations with enhanced output.
bash scripts/run/git_helper.sh status # Enhanced status with statistics
bash scripts/run/git_helper.sh branch # Branch listing with dates
bash scripts/run/git_helper.sh history 20 # Commit history visualization
bash scripts/run/git_helper.sh search "fix bug" # Search commit messages
bash scripts/run/git_helper.sh undo-commit # Undo last commit (safely)
Summary
| Category | Count |
|---|---|
| Analysis | 2 |
| Automation | 2 |
| Validation | 3 |
| Maintenance | 2 |
| Documentation | 2 |
| Utility | 1 |
| Total | 11 scripts (~9,800 lines) |
All new scripts include: comprehensive docstrings, CLI argument parsing, --help messages, error handling, progress indicators, directory exclusions, and dry-run modes where applicable.
Related
- ARCHITECTURE -- Platform scripts architecture
- DRY_RUN_PATTERN -- Standard dry-run pattern
- WORKFLOW_STANDARDS -- CI/CD workflow conventions
Repo: moko-platform · moko-platform wiki
| Field | Value |
|---|---|
| Minimum Version | 04.07.00 |
| Platform | all |
| Applies To | moko-platform |
| Revision | Date | Author | Description |
|---|---|---|---|
| 1.0 | 2026-05-09 | Moko Consulting | Initial version |