god-code 0.1.0__tar.gz

god_code-0.1.0/.gitignore

@@ -0,0 +1,12 @@
+__pycache__/
+*.pyc
+.venv/
+dist/
+*.egg-info/
+.agent_sessions/
+.pytest_cache/
+auth.json
+.env
+*.pem
+.idea/
+.vscode/

god_code-0.1.0/CHANGELOG.md

@@ -0,0 +1,34 @@
+# Changelog
+
+All notable changes to God Code will be documented in this file.
+
+## [0.1.0] - 2026-04-02
+
+### Added
+- CLI with `ask`, `chat`, `info`, `login`, `logout`, `status` commands
+- 10 tools: read_file, write_file, edit_file, list_dir, grep, glob, git, run_shell, run_godot, screenshot_scene
+- OpenAI-compatible API client with streaming and vision support
+- OAuth login via Codex CLI refresh token
+- Godot project parser (project.godot, autoloads, resolution)
+- .tscn scene parser, writer, and format validator with auto-fix
+- GDScript linter (naming, ordering, type annotations, anti-patterns)
+- Collision layer planner (standard 8-layer scheme)
+- Cross-file consistency checker (collision, signals, resource paths, groups)
+- Project dependency graph builder
+- Design pattern advisor (object pool, component, state machine)
+- Godot Playbook knowledge system (17 sections, context-aware injection)
+- Build discipline rules (incremental build-and-verify)
+- Error detection loop with Godot output parsing and fix suggestions
+- Conversation context compaction for long sessions
+- Path containment security (file ops restricted to project root)
+- Shell command sandboxing (dangerous pattern blocking)
+- API retry with exponential backoff (429 rate limits)
+- Content filter graceful handling (400 errors)
+- Session persistence to JSON
+
+### Security
+- File operations restricted to project root directory
+- Shell commands blocked for dangerous patterns (rm -rf /, sudo, etc.)
+- Git argument parsing via shlex.split()
+- OAuth tokens stored with 600 permissions
+- API key/token masked in status output

god_code-0.1.0/CONTRIBUTING.md

@@ -0,0 +1,54 @@
+# Contributing to God Code
+
+Thank you for your interest in contributing!
+
+## Getting Started
+
+```bash
+git clone https://github.com/888wing/god-code.git
+cd god-code
+python3 -m venv .venv
+source .venv/bin/activate
+pip install -e ".[dev]"
+python -m pytest tests/ -v
+```
+
+## Development Workflow
+
+1. Create a feature branch: `git checkout -b feature/your-feature`
+2. Write tests first (TDD encouraged)
+3. Implement the feature
+4. Run tests: `python -m pytest tests/ -v`
+5. Commit with descriptive messages
+6. Open a Pull Request
+
+## Code Style
+
+- Python 3.12+ with type annotations
+- Follow existing patterns in the codebase
+- Use `pydantic` for tool input/output models
+- New tools inherit from `BaseTool` in `godot_agent/tools/base.py`
+
+## Adding a New Tool
+
+1. Create `godot_agent/tools/your_tool.py`
+2. Implement a class inheriting `BaseTool` with `Input`, `Output`, and `execute()`
+3. Register it in `godot_agent/cli.py:build_registry()`
+4. Add tests in `tests/tools/test_your_tool.py`
+
+## Adding Godot Knowledge
+
+Edit `godot_agent/prompts/godot_playbook.py` to add new sections. Each section has:
+- Title
+- Keywords (for auto-selection)
+- Content (injected into system prompt when relevant)
+
+## Reporting Issues
+
+- Use GitHub Issues
+- Include: Python version, Godot version, god-code version, error output
+- For API errors: include the status code and error message (not your API key)
+
+## License
+
+By contributing, you agree that your contributions will be licensed under GPL-3.0.