chore: enhance .gitignore and update project configurations

- Expanded .gitignore to include additional macOS and Windows files, improving exclusion of unnecessary artifacts.
- Refined settings.local.json to streamline Bash command permissions.
- Updated GitHub workflows to specify working directories for improved CI/CD processes.
- Adjusted pyproject.toml to clarify project dependencies and enhance compatibility.
- Enhanced CLI project generation with improved path resolution and name validation.
- Cleaned up scaffold templates to ensure consistency and clarity in generated projects.

Author: Joongheon Park

.claude/settings.local.json

@@ -1,14 +1,10 @@
 {
   "permissions": {
     "allow": [
-      "Bash(dir:*)",
-      "Bash(uv pip install:*)",
-      "Bash(timeout /t 2)",
-      "Bash(nul)",
-      "Bash(uv run act:*)",
-      "Bash(.venv/Scripts/python.exe -m act_operator:*)",
-      "Bash(python -m act_operator:*)",
-      "Bash(uv sync:*)"
+      "Bash(tree:*)",
+      "Bash(cat:*)",
+      "Bash(uv run pytest:*)",
+      "Bash(uv run python:*)"
     ],
     "deny": [],
     "ask": []

.github/workflows/ruff.yml

@@ -5,6 +5,9 @@ on: [push, pull_request]
 jobs:
   ruff:
     runs-on: ubuntu-latest
+    defaults:
+      run:
+        working-directory: act_operator
     steps:
       - uses: actions/checkout@v5
 

.github/workflows/uv_lock_upgrade.yml

@@ -12,7 +12,7 @@ permissions:
   pull-requests: write
 
 env:
-  PYTHON_VERSION: "3.12"
+  PYTHON_VERSION: "3.12" # Updated to match project requirements
   WORKING_DIRECTORY: "act_operator"
 
 jobs:
@@ -30,20 +30,55 @@ jobs:
           cache-suffix: "uv-lock-upgrade"
 
       - name: Upgrade lock file
-        run: uv lock --upgrade
+        run: |
+          echo "📦 Upgrading dependencies..."
+          uv lock --upgrade
         working-directory: ${{ env.WORKING_DIRECTORY }}
 
+      - name: Check for changes
+        id: check_changes
+        run: |
+          if git diff --quiet; then
+            echo "No dependency updates available"
+            echo "has_changes=false" >> $GITHUB_OUTPUT
+          else
+            echo "Dependency updates found"
+            echo "has_changes=true" >> $GITHUB_OUTPUT
+            echo "📝 Changed files:"
+            git diff --name-only
+          fi
+
       - name: Create Pull Request
+        if: steps.check_changes.outputs.has_changes == 'true'
         uses: peter-evans/create-pull-request@v7
         with:
           token: ${{ secrets.GITHUB_TOKEN }}
-          commit-message: "chore(deps): upgrade dependencies with `uv lock --upgrade`"
-          title: "chore(deps): upgrade dependencies with `uv lock --upgrade`"
+          commit-message: "chore(deps): upgrade dependencies"
+          title: "chore(deps): upgrade dependencies"
           body: |
-            This PR updates the dependencies in the Act Operator package using `uv lock --upgrade`.
+            ## 📦 Dependency Updates
+
+            This PR updates the dependencies in Act-Operator using `uv lock --upgrade`.
+
+            ### Changed Files
+            - `act_operator/uv.lock`
 
-            This is an automated PR created by the UV Lock Upgrade workflow.
+            ### Review Checklist
+            - [ ] Review the dependency changes
+            - [ ] Run tests to ensure compatibility
+            - [ ] Check for any breaking changes in updated packages
+
+            ---
+            🤖 Automated PR by [UV Lock Upgrade workflow](${{ github.server_url }}/${{ github.repository }}/actions/workflows/uv_lock_upgrade.yml)
+
+            **Triggered by:** ${{ github.event_name }}
           branch: deps/uv-lock-upgrade
           delete-branch: true
           labels: |
             dependencies
+            automated
+
+      - name: No updates needed
+        if: steps.check_changes.outputs.has_changes == 'false'
+        run: |
+          echo "✅ All dependencies are up to date!"

.gitignore

@@ -1,30 +1,156 @@
-# Python cache and compiled files
+### macOS ###
+.DS_Store
+.AppleDouble
+.LSOverride
+._*
+.DocumentRevisions-V100
+.fseventsd
+.Spotlight-V100
+.TemporaryItems
+.Trashes
+.VolumeIcon.icns
+.com.apple.timemachine.donotpresent
+*.icloud
+
+### Windows ###
+Thumbs.db
+Thumbs.db:encryptable
+ehthumbs.db
+ehthumbs_vista.db
+*.stackdump
+[Dd]esktop.ini
+$RECYCLE.BIN/
+*.cab
+*.msi
+*.msix
+*.msm
+*.msp
+*.lnk
+
+### Python ###
+# Byte-compiled / optimized / DLL files
 __pycache__/
 *.py[cod]
 *$py.class
 
-# Packaging artifacts
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
 build/
+develop-eggs/
 dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
 *.egg-info/
+.installed.cfg
 *.egg
+MANIFEST
 
 # Virtual environments
+.env
 .venv/
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
 .python-version
 
-# Test and coverage outputs
+# Testing
 .pytest_cache/
-.coverage*
+.coverage
+.coverage.*
 htmlcov/
+.tox/
+.nox/
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+
+# Type checking
+.mypy_cache/
+.dmypy.json
+dmypy.json
+.pyre/
+.pytype/
+pyrightconfig.json
+
+# Linting
+.ruff_cache/
+
+# Logs
+*.log
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Jupyter Notebook
+.ipynb_checkpoints
+*.ipynb_checkpoints/
+
+# IPython
+profile_default/
+ipython_config.py
+
+# Django / Flask
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+instance/
+.webassets-cache
 
-# Cookiecutter logs
+# Sphinx documentation
+docs/_build/
+/site
+
+# PyBuilder
+.pybuilder/
+target/
+
+# Translations
+*.mo
+*.pot
+
+# Scrapy
+.scrapy
+
+# Celery
+celerybeat-schedule
+celerybeat.pid
+
+# SageMath
+*.sage.py
+
+# Cython debug symbols
+cython_debug/
+
+# Poetry
+poetry.toml
+
+# Cookiecutter
 cookiecutter.log
 
 # IDE settings
 .vscode/
 .idea/
+.spyderproject
+.spyproject
+.ropeproject
 
-# OS-generated files
-.DS_Store
-Thumbs.db
+# Act-Operator specific
+# Exclude test/sample projects created during development
+sample-act/
+*-act/
+# Temporary files
+*.bak