chore(installer): overhaul install scripts — portable paths, TRT verification, pin alignment

.charlie/config.yml

@@ -0,0 +1,9 @@
+checkCommands:
+  fix: ruff check --fix . && ruff format .
+  lint: pip install ruff && ruff check .
+  # Type checking not yet configured - add when ready:
+  # types: pip install pyrefly && pyrefly check
+  # Tests not yet available - add when CPU-compatible tests exist:
+  # test: pip install pytest && pytest tests/ -x -q --ignore=tests/gpu/
+beta:
+  canApprovePullRequests: false

.charlie/instructions/code-style.md

@@ -0,0 +1,13 @@
+# StreamDiffusion Code Style
+
+Charlie reads CLAUDE.md automatically for project context. These are additional rules.
+
+## Rules
+
+- [R1] Follow existing patterns in the codebase — check surrounding code before suggesting changes
+- [R2] Ensure ruff lint and format checks pass: `ruff check . && ruff format --check .` (line-length 119)
+- [R3] CUDA kernels and device operations must include error checking — never ignore return codes
+- [R4] TensorRT engine building/loading code must handle version compatibility explicitly
+- [R5] Use type hints for all new public functions and class methods
+- [R6] TouchDesigner extension methods must follow the TD callback pattern (onXxx naming)
+- [R7] Do not commit CLAUDE.md, MEMORY.md, or .claude/ — these are local-only files

.claude/hooks/git-commit-enforcer.py

@@ -0,0 +1,118 @@
+#!/usr/bin/env python3
+"""
+PreToolUse hook to enforce safe git commits via commit_enhanced.sh
+instead of raw 'git commit' commands.
+
+This hook intercepts any 'git commit' bash command and redirects it
+to scripts/git/commit_enhanced.sh for validation and safety checks.
+
+Benefits:
+- Automatic lint validation (ruff, black, isort)
+- Local file exclusion (CLAUDE.md, MEMORY.md, _archive/)
+- Commit message format validation
+- Branch-specific protection
+"""
+
+import json
+import os
+import re
+import sys
+
+
+def main():
+    try:
+        input_data = json.load(sys.stdin)
+    except (json.JSONDecodeError, ValueError):
+        sys.exit(0)
+
+    tool_name = input_data.get("tool_name", "")
+    tool_input = input_data.get("tool_input", {})
+    command = tool_input.get("command", "")
+
+    # Only intercept Bash tool
+    if tool_name != "Bash":
+        sys.exit(0)
+
+    # Detect git commit patterns
+    # Match: git commit, git commit -m, git commit --message, etc.
+    git_commit_pattern = r"\bgit\s+commit\b"
+    if not re.search(git_commit_pattern, command):
+        sys.exit(0)
+
+    # Respect --no-verify flag - user explicitly wants to bypass hooks
+    no_verify_pattern = r"\b(--no-verify|-n)\b"
+    if re.search(no_verify_pattern, command):
+        # Allow raw command to pass through
+        sys.exit(0)
+
+    # SMART DETECTION: Allow legitimate git commit cases to pass through
+    # Only intercept standard new commits (git commit -m "message")
+    ALLOWED_PATTERNS = [
+        r"--amend",  # Amending previous commit
+        r"--no-edit",  # Merge/rebase completion
+        r"--allow-empty",  # Empty commits (rare but valid)
+        r"--fixup",  # Fixup commits for rebase
+        r"--squash",  # Squash commits for rebase
+    ]
+
+    # Check if any allowed pattern is present
+    for pattern in ALLOWED_PATTERNS:
+        if re.search(pattern, command):
+            # Allow special commit types to pass through
+            sys.exit(0)
+
+    # ONLY intercept: git commit -m "message" (standard new commits)
+    # This is the pattern that should go through commit_enhanced.bat
+    if not re.search(r'-m\s+["\']', command):
+        # No -m flag = likely interactive or special case
+        sys.exit(0)
+
+    # Extract commit message if present
+    # Patterns: -m "message", -m 'message', --message "message"
+    message = ""
+
+    # Try -m with quotes
+    msg_match = re.search(r'-m\s+["\']([^\'"]+)["\']', command)
+    if msg_match:
+        message = msg_match.group(1)
+    else:
+        # Try --message with quotes
+        msg_match = re.search(r'--message\s+["\']([^\'"]+)["\']', command)
+        if msg_match:
+            message = msg_match.group(1)
+        else:
+            # Try -m without quotes (single word)
+            msg_match = re.search(r'-m\s+([^\s"\']+)', command)
+            if msg_match:
+                message = msg_match.group(1)
+
+    # Build safe commit command
+    project_dir = os.environ.get("CLAUDE_PROJECT_DIR", "F:/RD_PROJECTS/COMPONENTS/claude-context-local")
+    safe_script = f"{project_dir}/scripts/git/commit_enhanced.sh"
+
+    # Construct updated command - shell script runs natively in Git Bash
+    if message:
+        updated_command = f'./scripts/git/commit_enhanced.sh "{message}"'
+    else:
+        # No message provided - script will prompt or use default
+        updated_command = "./scripts/git/commit_enhanced.sh"
+
+    # Return hook decision with updated command
+    output = {
+        "hookSpecificOutput": {
+            "hookEventName": "PreToolUse",
+            "permissionDecision": "allow",
+            "permissionDecisionReason": (
+                "Routing through safe commit handler (commit_enhanced.sh) "
+                "for validation, lint checks, and local file protection"
+            ),
+            "updatedInput": {"command": updated_command},
+        }
+    }
+
+    print(json.dumps(output))
+    sys.exit(0)
+
+
+if __name__ == "__main__":
+    main()

.gitattributes

@@ -0,0 +1,45 @@
+# Line endings
+*.sh text eol=lf
+*.py text eol=lf
+*.md text eol=lf
+*.yml text eol=lf
+*.yaml text eol=lf
+*.json text eol=lf
+*.toml text eol=lf
+*.txt text eol=lf
+*.bat text eol=crlf
+*.cmd text eol=crlf
+
+# Merge strategies
+*.py merge=diff3
+*.json merge=diff3
+*.yaml merge=diff3
+*.yml merge=diff3
+*.toml merge=diff3
+*.md merge=diff3
+CHANGELOG.md merge=union
+
+# Binary files (ML models, images, compiled artifacts)
+*.onnx binary
+*.engine binary
+*.trt binary
+*.pth binary
+*.pt binary
+*.safetensors binary
+*.pkl binary
+*.pb binary
+*.h5 binary
+
+# Images
+*.png binary
+*.jpg binary
+*.jpeg binary
+*.gif binary
+*.ico binary
+*.webp binary
+
+# Archives
+*.zip binary
+*.tar binary
+*.gz binary
+*.whl binary

.githooks/pre-commit

@@ -0,0 +1,61 @@
+#!/bin/sh
+# Pre-commit hook to prevent accidental commit of local-only files
+# Prevents commits of CLAUDE.md, MEMORY.md, .claude/ directory
+# Allows DELETIONS (D) but blocks additions (A) or modifications (M)
+
+echo "Checking for local-only files..."
+
+# Check if any local-only files are being ADDED or MODIFIED (not deleted)
+PROBLEMATIC_FILES=$(git diff --cached --name-status | grep -E "^[AM]\s+(CLAUDE\.md|MEMORY\.md|\.claude/)")
+
+if [ -n "$PROBLEMATIC_FILES" ]; then
+    echo "ERROR: Attempting to add or modify local-only files!"
+    echo ""
+    echo "The following files must remain local only:"
+    echo "- CLAUDE.md (development context, project-specific AI instructions)"
+    echo "- MEMORY.md (session memory)"
+    echo "- .claude/ (Claude Code configuration, hooks, skills)"
+    echo ""
+    echo "Problematic files:"
+    echo "$PROBLEMATIC_FILES"
+    echo ""
+    echo "DELETIONS are allowed (removing from git tracking)"
+    echo "ADDITIONS/MODIFICATIONS are blocked (privacy protection)"
+    echo ""
+    echo "To fix this, reset the problematic files:"
+    echo "  git reset HEAD <file>"
+    echo ""
+    exit 1
+fi
+
+# Check for deletions (which are allowed and expected)
+DELETED_FILES=$(git diff --cached --name-status | grep -E "^D\s+(CLAUDE\.md|MEMORY\.md|\.claude/)")
+if [ -n "$DELETED_FILES" ]; then
+    echo "  Local-only files being removed from git tracking (as intended)"
+fi
+
+echo "  No local-only files detected"
+echo "  Privacy protection active"
+
+# Optional: Check code quality for Python files (non-blocking)
+PYTHON_FILES=$(git diff --cached --name-only --diff-filter=ACM | grep '\.py$')
+
+if [ -n "$PYTHON_FILES" ]; then
+    echo ""
+    echo "Checking code quality (non-blocking)..."
+
+    if command -v ruff > /dev/null 2>&1; then
+        if ! ruff check $PYTHON_FILES > /dev/null 2>&1; then
+            echo "  WARNING: ruff found lint issues in staged Python files"
+            echo "  Run 'ruff check --fix .' to auto-fix, or 'ruff check .' to see details"
+            echo "  (Commit will proceed - fix lint issues when ready)"
+        else
+            echo "  Code quality checks passed"
+        fi
+    else
+        echo "  ruff not found - skipping lint check (install: pip install ruff)"
+    fi
+fi
+
+echo ""
+exit 0

.github/CODEOWNERS

@@ -0,0 +1,14 @@
+# Default owners for all files
+* @forkni
+
+# CUDA/TensorRT specific code
+*.cu @forkni
+*.cuh @forkni
+*tensorrt* @forkni
+*trt* @forkni
+
+# CI/CD workflows
+.github/ @forkni
+
+# Core streaming pipeline
+src/streamdiffusion/ @forkni

.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,114 @@
+name: Bug Report
+description: Report a bug or unexpected behavior
+labels: ["bug", "status/needs-triage"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for taking the time to report a bug! Please fill out the form below.
+
+  - type: textarea
+    id: description
+    attributes:
+      label: Bug Description
+      description: A clear and concise description of the bug.
+      placeholder: What happened? What did you expect to happen?
+    validations:
+      required: true
+
+  - type: textarea
+    id: steps
+    attributes:
+      label: Steps to Reproduce
+      description: Steps to reproduce the behavior.
+      placeholder: |
+        1. Load model '...'
+        2. Set parameters '...'
+        3. Run inference '...'
+        4. See error
+    validations:
+      required: true
+
+  - type: textarea
+    id: error
+    attributes:
+      label: Error Output
+      description: Paste the full error output or traceback.
+      render: shell
+
+  - type: markdown
+    attributes:
+      value: "## Environment"
+
+  - type: input
+    id: gpu
+    attributes:
+      label: GPU Model
+      placeholder: e.g. NVIDIA RTX 3090, A100 80GB
+    validations:
+      required: true
+
+  - type: input
+    id: cuda
+    attributes:
+      label: CUDA Version
+      placeholder: e.g. 11.8
+    validations:
+      required: true
+
+  - type: input
+    id: driver
+    attributes:
+      label: NVIDIA Driver Version
+      placeholder: e.g. 525.85.12
+    validations:
+      required: true
+
+  - type: input
+    id: tensorrt
+    attributes:
+      label: TensorRT Version (if applicable)
+      placeholder: e.g. 8.6.1
+
+  - type: input
+    id: python
+    attributes:
+      label: Python Version
+      placeholder: e.g. 3.10.12
+    validations:
+      required: true
+
+  - type: input
+    id: torch
+    attributes:
+      label: PyTorch Version
+      placeholder: e.g. 2.0.1+cu118
+    validations:
+      required: true
+
+  - type: dropdown
+    id: os
+    attributes:
+      label: Operating System
+      options:
+        - Ubuntu 22.04
+        - Ubuntu 20.04
+        - Windows 11
+        - Windows 10
+        - macOS (MPS)
+        - Other Linux
+        - Other
+    validations:
+      required: true
+
+  - type: input
+    id: branch
+    attributes:
+      label: Branch / Commit
+      placeholder: e.g. SDTD_031_stable, main, commit hash
+
+  - type: textarea
+    id: context
+    attributes:
+      label: Additional Context
+      description: Any other context, config files, or screenshots.