@tdk-landscape/tdk-cli-core 1.3.44 → 1.3.48

package/.github/workflows/release-binaries.yml

@@ -0,0 +1,54 @@
+name: Release binaries and npm package
+
+on:
+  push:
+    branches: [main]
+    paths:
+      - "cli/package.json"
+
+permissions:
+  contents: read
+  id-token: write
+
+jobs:
+  release:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: oven-sh/setup-bun@v2
+        with:
+          bun-version: latest
+
+      - uses: actions/setup-node@v6
+        with:
+          node-version: 24.15.0
+          registry-url: "https://registry.npmjs.org"
+          package-manager-cache: false
+
+      - name: Update npm for trusted publishing
+        run: npm install -g npm@latest
+
+      - run: bun install --frozen-lockfile
+        working-directory: cli
+
+      - run: scripts/release-binaries.sh --publish
+        env:
+          GH_TOKEN: ${{ secrets.BINARY_RELEASE_TOKEN }}
+
+      # cli/package.json's prepack script (scripts/stage-npm-engine.sh) copies
+      # Tiltfile/engine/discovery/specs/ext into cli/ before packing, so the
+      # published tarball is self-contained the same way the binary release
+      # is. npm can't overwrite an already-published version, so skip instead
+      # of failing when this run didn't bump the version.
+      - name: Publish to npm
+        working-directory: cli
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+        run: |
+          PKG_VERSION=$(node -p "require('./package.json').version")
+          if npm view "@tdk-landscape/tdk-cli-core@${PKG_VERSION}" version >/dev/null 2>&1; then
+            echo "@tdk-landscape/tdk-cli-core@${PKG_VERSION} is already published, skipping."
+          else
+            npm publish --access public --provenance
+          fi

package/.pre-commit-config.yaml

@@ -0,0 +1,57 @@
+repos:
+  - repo: local
+    hooks:
+      # Fast unit tests for Docker/Compose generators
+      - id: pytest-fast-tests
+        name: Run fast unit tests
+        entry: python3 -m pytest -m fast --no-cov -q
+        language: system
+        pass_filenames: false
+        always_run: true
+        stages: [pre-commit]
+        description: |
+          Fast tests only (marked with @pytest.mark.fast):
+          - Docker/Compose generator bug tests
+          - Port anchor selection (*backend-port vs *frontend-port)
+          - EXPOSE validation (port numbers, not paths)
+          - Function signature validation (keyword args)
+          These are pure Python tests (no Tilt/Docker needed) and run in ~1s.
+
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v4.5.0
+    hooks:
+      - id: trailing-whitespace
+      - id: end-of-file-fixer
+      - id: check-yaml
+        exclude: ".autogenerated/"
+      - id: check-json
+        exclude: ".autogenerated/"
+      - id: check-added-large-files
+        args: ['--maxkb=500']
+
+  - repo: https://github.com/psf/black
+    rev: 23.12.1
+    hooks:
+      - id: black
+        language_version: python3
+        files: \.py$
+        exclude: ".autogenerated/|__pycache__/"
+
+  - repo: https://github.com/pycqa/flake8
+    rev: 7.0.0
+    hooks:
+      - id: flake8
+        files: \.py$
+        exclude: ".autogenerated/|__pycache__/"
+        args: ['--max-line-length=100', '--extend-ignore=E203,W503']
+
+  # Optional: Run on Starlark files (Tilt/Starlark syntax check)
+  - repo: local
+    hooks:
+      - id: check-star-syntax
+        name: Check Starlark file syntax
+        entry: python3 -c "import ast; [ast.parse(open(f).read()) for f in __import__('sys').argv[1:]]"
+        language: system
+        files: \.star$
+        pass_filenames: true
+        description: Basic Python syntax validation for Starlark files

package/Makefile

@@ -0,0 +1,92 @@
+# Makefile
+# Common development tasks
+
+.PHONY: help test-tilt-engine test test-coverage lint video video-build video-test video-validate video-generate
+
+help: ## Show this help message
+	@echo "Available targets:"
+	@grep -E '^[a-zA-Z_-]+:.*?## .*$$' $(MAKEFILE_LIST) | sort | awk 'BEGIN {FS = ":.*?## "}; {printf "  \033[36m%-20s\033[0m %s\n", $$1, $$2}'
+
+# Testing targets
+test-tilt-engine: ## Run tilt-engine test suite
+	@echo "🧪 Running tilt-engine tests..."
+	pytest tests/tilt-engine/ -v --tb=short
+
+test-tilt-engine-coverage: ## Run tilt-engine tests with coverage report
+	@echo "🧪 Running tilt-engine tests with coverage..."
+	pytest tests/tilt-engine/ -v --cov=tests/tilt-engine --cov-report=term-missing --cov-report=html
+
+test: ## Run all tests
+	@echo "🧪 Running all tests..."
+	pytest tests/ -v --tb=short
+
+test-coverage: ## Run all tests with coverage
+	@echo "🧪 Running all tests with coverage..."
+	pytest tests/ -v --cov --cov-report=term-missing --cov-report=html
+
+# Test categories
+test-snapshot: ## Run snapshot tests only
+	pytest tests/tilt-engine/test_snapshot_*.py -v -m snapshot
+
+test-daemon: ## Run daemon tests only
+	pytest tests/tilt-engine/test_daemon_*.py -v -m daemon
+
+test-health: ## Run health check tests only
+	pytest tests/tilt-engine/test_health_*.py -v -m health
+
+test-ide: ## Run IDE component tests only
+	pytest tests/tilt-engine/test_*.py -v -m ide
+
+test-safety: ## Run safety guard tests only
+	pytest tests/tilt-engine/test_*prune*.py tests/tilt-engine/test_*alias*.py -v -m safety
+
+test-cache: ## Run registry cache tests only
+	pytest tests/tilt-engine/test_cache_*.py -v -m cache
+
+# Fast tests (for pre-commit)
+test-fast: ## Run fast unit tests only (no external deps)
+	@echo "⚡ Running fast tests..."
+	pytest -m fast --no-cov -q
+
+test-generator: ## Run generator bug tests only
+	@echo "🔧 Running generator tests..."
+	pytest -m generator -v --no-cov
+
+# Pre-commit hooks
+pre-commit-install: ## Install pre-commit hooks
+	@echo "🔧 Installing pre-commit hooks..."
+	pip install pre-commit
+	pre-commit install
+
+pre-commit-run: ## Run pre-commit hooks on all files
+	@echo "🔍 Running pre-commit hooks..."
+	pre-commit run --all-files
+
+pre-commit-fast: ## Run only fast tests (pre-commit style)
+	@echo "⚡ Running fast pre-commit tests..."
+	pytest -m fast --no-cov -q
+
+# Video Generator targets
+video: ## Show video generator help
+	@cd video-generator && swift run tdk-video help
+
+video-build: ## Build the video generator
+	@echo "🔨 Building video generator..."
+	cd video-generator && swift build
+
+video-test: ## Run video generator tests
+	@echo "🧪 Running video generator tests..."
+	cd video-generator && swift test
+
+video-validate: ## Validate video generator system setup
+	@echo "🔍 Validating video generator setup..."
+	cd video-generator && swift run tdk-video validate
+
+video-generate: ## Generate the TDK CLI tutorial video (requires FFmpeg)
+	@echo "🎬 Generating TDK CLI tutorial video..."
+	@echo "   This will create TDK_Tutorial_1440p.mp4 (20 min, 2K)"
+	cd video-generator && swift run tdk-video generate
+
+video-generate-quick: ## Generate 1080p test video (faster)
+	@echo "🎬 Generating 1080p test video..."
+	cd video-generator && swift run tdk-video generate -o TDK_Tutorial_Test_1080p.mp4