comfygit-core 0.3.8.dev1__tar.gz

comfygit_core-0.3.8.dev1/.gitignore

@@ -0,0 +1,73 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+.ruff_cache/
+
+# Virtual Environment
+.venv/
+venv/
+ENV/
+env/
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+.project
+.pydevproject
+
+# Testing
+.tox/
+.coverage
+.coverage.*
+.cache
+.pytest_cache/
+nosetests.xml
+coverage.xml
+*.cover
+.hypothesis/
+
+# Project specific
+llm-context.md
+test-output.md
+*.md.bak
+.llm-context/
+backlog/
+.claude/
+.devcontainer/
+.test_data/
+.scratchpad/
+.llmd/
+.test_project
+.setup.sh
+
+# OS
+.DS_Store
+Thumbs.db
+*.log
+
+# Docs
+docs/archive
+docs/context
+docs/contexts

comfygit_core-0.3.8.dev1/.python-version

@@ -0,0 +1 @@
+3.10

comfygit_core-0.3.8.dev1/CLAUDE.md

@@ -0,0 +1,41 @@
+## Important Documents
+#### always read
+- @docs/codebase-map.md 
+#### only read if instructed
+- docs/layer-hierarchy.md
+- docs/prd.md
+
+## Core Package
+- Code under packages/core should be assumed to be a library and properly abstracted from client rendering code.
+- DO NOT couple this code with a particular frontend implementation like the CLI!
+- We should NOT see any print() or input() in the core libary code.
+
+## Python Environment Management
+
+- ALWAYS use uv and the commands below for python environment management! NEVER try to run the system python!
+- uv commands should be run in the root repo directory in order to use the repo's .venv
+
+## Development
+
+- `uv add <package>` - Install dependencies
+- `uv run ruff check --fix` - Lint and auto-fix with ruff
+- `uv pip list` - View dependencies
+- `uv run <command>` - Run cli tools locally installed (e.g. uv run comfydock)
+
+## Testing
+
+- New tests should go under tests/ under their respective category.
+- Read tests/README.md for info on how to create new integration tests.
+- Try to add new tests to existing test files rather than creating new files (unless necessary)
+- `uv run pytest tests/ -v` - Run all tests (full info)
+- `uv run pytest <filename>` - Run specific test file
+
+#### Testing comfygit cli
+- Use the existing testing workspace by prepending the env variable to cli commands:
+COMFYGIT_HOME=/home/akatzfey/projects/comfyhub/comfygit/packages/core/.comfygit_workspace
+
+## General
+Don't make any implementation overly complex. This is a one-person dev MVP project.
+We are still pre-customer - any unnecessary fallbacks, unnecessary versioning, testing overkill should be avoided.
+Simple, elegant, maintainable code is the goal.
+We DONT want any legacy or backwards compatible code.