Initial commit

STATUS.md

@@ -0,0 +1,184 @@
+# Implementation Status
+
+## ✅ Completed
+
+### Core Implementations
+- [x] **Python implementation** (`python/main.py`)
+  - CLI with argparse
+  - YAML config loading
+  - Git operations via subprocess
+  - Embedded licenses (MIT, GPLv3, AGPLv3, Unlicense)
+  - HTML entity decoding
+  - Cross-platform config path
+  - Force remote reset
+  - Network-aware push with warnings
+  - Tests passing
+
+- [x] **Rust implementation** (`rust/src/main.rs`)
+  - CLI with clap (derive API)
+  - YAML config via serde_yaml
+  - Git operations via git2 crate
+  - Embedded licenses via include_str!
+  - HTML entity decoding via html-escape
+  - Cross-platform config path
+  - Identical behavior to Python version
+
+- [x] **Go implementation** (`go/main.go`)
+  - CLI with cobra
+  - YAML config via gopkg.in/yaml.v3
+  - Git operations via subprocess
+  - Embedded licenses via //go:embed
+  - HTML entity decoding
+  - Cross-platform config path
+  - Identical behavior to Python/Rust versions
+
+### Git Flow
+- [x] Detect or initialize git repository
+- [x] Ensure `main` branch is default
+- [x] Remove all existing remotes
+- [x] Force set `origin` to templated URL
+- [x] Add LICENSE (if missing or --force)
+- [x] Add/overwrite .gitignore from embedded template
+- [x] Commit changes with "Initial commit"
+- [x] Create and checkout dev branch (default: "dev")
+- [x] Attempt push to remote with network error handling
+
+### Gitea Workflows
+- [x] Workflow directory structure (`.gitea/workflows/`)
+- [x] Changelog config moved to `.gitea/changelog_config.json`
+- [x] **Python workflows**:
+  - [x] `test-python.yml` (name: "Test Python")
+  - [x] `test-python-docker-build.yml` (workflow_run trigger)
+  - [x] `python_package-release.yml`
+  - [x] `docker-release.yml`
+- [x] **Rust workflows**:
+  - [x] `test-rust.yml` (name: "Test Rust")
+  - [x] `test-rust-docker-build.yml` (workflow_run trigger)
+  - [x] `cargo-release.yml`
+- [x] **Go workflows**:
+  - [x] `test-go.yml` (name: "Test Go")
+  - [x] `test-go-docker-build.yml` (workflow_run trigger)
+  - [x] `go-release.yml`
+
+### Configuration
+- [x] Default config file at `~/.config/GMS/.config.yaml`
+- [x] Windows path support (`%USERPROFILE%\.config\GMS\.config.yaml`)
+- [x] Auto-create config with defaults
+- [x] CLI argument overrides
+- [x] Template substitution in git URL (`{owner}`, `{repo}`)
+- [x] License placeholder substitution (`{year}`, `{fullname}`)
+
+### Documentation
+- [x] Comprehensive README.md
+- [x] BUILD.md with build instructions for all three languages
+- [x] EXAMPLES.md with usage examples
+- [x] Inline code documentation
+- [x] Workflow comments and descriptions
+
+### Asset Embedding
+- [x] Python embed_assets.py helper script
+- [x] Rust include_str! for licenses and .gitignore
+- [x] Go //go:embed for licenses and .gitignore
+- [x] HTML entity decoding for GPL/AGPL/Unlicense
+
+## 🔄 Partial / In Progress
+
+### Workflow Scaffolding
+- [x] Directory creation (`.gitea/`, `.gitea/workflows/`)
+- [x] Workflow file templates created
+- [ ] Dynamic workflow generation based on deploy_type
+  - Currently prints warnings and creates directories
+  - TODO: Copy appropriate workflow files based on flag
+- [ ] Language detection for automatic workflow selection
+
+### Testing
+- [x] Python unit tests (test_main.py)
+- [ ] Rust unit tests
+- [ ] Go unit tests
+- [ ] Integration tests for git operations
+- [ ] End-to-end workflow tests
+
+### Build System
+- [x] Python pyproject.toml with hatchling
+- [x] Rust Cargo.toml
+- [x] Go go.mod
+- [ ] PyInstaller spec for Python binary
+- [ ] GitHub Actions / Gitea workflows for building releases
+- [ ] Automated cross-platform builds
+
+## ❌ Not Implemented
+
+### Features
+- [ ] Interactive mode (prompt for missing args)
+- [ ] Dry-run mode (preview changes without applying)
+- [ ] Backup existing files before overwriting
+- [ ] Git hooks installation
+- [ ] Pre-commit configuration
+- [ ] Custom workflow templates via config
+- [ ] Multiple remote support (beyond origin)
+
+### Workflow Features
+- [ ] Dockerfile generation (currently just warns)
+- [ ] Language-specific .gitignore variants
+- [ ] Automatic dependency file generation (requirements.txt, Cargo.toml, etc.)
+- [ ] Container registry selection
+- [ ] Branch protection rules setup
+- [ ] Issue/PR templates
+
+### Advanced Git Operations
+- [ ] GPG signing setup
+- [ ] Git LFS initialization
+- [ ] Submodule configuration
+- [ ] Sparse checkout setup
+
+### Tooling
+- [ ] Shell completion scripts (bash, zsh, fish, PowerShell)
+- [ ] Man pages
+- [ ] GUI wrapper
+- [ ] VS Code extension integration
+
+## 🐛 Known Issues
+
+1. **Python package structure**: Required `python/__init__.py` and `[tool.hatch.build.targets.wheel]` in pyproject.toml
+2. **Workflow generation**: Currently only creates directories, doesn't copy workflow files dynamically
+3. **Git push errors**: Warnings are shown but might not be clear enough
+4. **HTML entities**: Only basic entities decoded (<, >, &, ") - may miss others
+5. **License mapping**: "GPLv3" string doesn't match "GPL-3.0.txt" filename automatically in all cases
+
+## 📋 Next Steps
+
+### High Priority
+1. Implement dynamic workflow file copying based on `--deploy-type`
+2. Add Rust and Go unit tests
+3. Create PyInstaller build script
+4. Test on Linux and macOS
+5. Fix license enum mapping inconsistencies
+
+### Medium Priority
+6. Add integration tests for git operations
+7. Create release workflows in `.gitea/workflows/` for this repo
+8. Document required Gitea secrets more clearly
+9. Add shell completion scripts
+10. Create example Dockerfiles for each language
+
+### Low Priority
+11. Add interactive mode
+12. Support custom workflow templates
+13. Add dry-run mode
+14. Create GUI wrapper
+15. Write man pages
+
+## 📊 Test Coverage
+
+- Python: ~60% (basic unit tests only)
+- Rust: 0% (no tests yet)
+- Go: 0% (no tests yet)
+- Integration: 0% (not implemented)
+
+## 🎯 Goals
+
+- [ ] 100% behavioral parity across Python/Rust/Go
+- [ ] 80%+ test coverage for all implementations
+- [ ] Full workflow generation support
+- [ ] Automated release builds
+- [ ] Cross-platform verified (Windows, Linux, macOS)