Taskfile.yml

version: '3'

set: ['pipefail']

vars:
  PYTEST_TMPDIR: '{{if eq OS "linux"}}/dev/shm/pytest-tmp-{{else}}/tmp/pytest-tmp-{{end}}{{ substr 0 8 (sha256sum .ROOT_DIR) }}'
  PYTEST_CACHEDIR: '{{if eq OS "linux"}}/dev/shm/pytest-cache-{{else}}/tmp/pytest-cache-{{end}}{{ substr 0 8 (sha256sum .ROOT_DIR) }}'

tasks:
  _tmpdir-setup:
    internal: true
    desc: Wipe and recreate pytest tmpdir so each run starts clean (platform-aware)
    cmds:
      - rm -rf {{.PYTEST_TMPDIR}}
      - mkdir -p {{.PYTEST_TMPDIR}} {{.PYTEST_CACHEDIR}}

  test-all:
    desc: Run all tests with parallel workers
    deps: [install-worktree, _tmpdir-setup]
    env:
      PYTHONDONTWRITEBYTECODE: "1"
      OMP_NUM_THREADS: "1"
      TMPDIR: "{{.PYTEST_TMPDIR}}"
    cmds:
      - |
        mkdir -p temp
        TEST_OUTPUT="temp/test-$(date +%Y-%m-%d_%H%M%S).txt"
        echo "Running all tests with -n 4"
        echo "Output: $TEST_OUTPUT"

        if [[ -d ".venv" ]]; then
          .venv/bin/lint-imports
          PYTEST_CMD=".venv/bin/python -m pytest"
        else
          lint-imports
          PYTEST_CMD="pytest"
        fi

        set -o pipefail
        set +e
        $PYTEST_CMD tests/ -q --tb=short -n 4 -m "not smoke" --disable-warnings -o "addopts=" --basetemp={{.PYTEST_TMPDIR}} -o "cache_dir={{.PYTEST_CACHEDIR}}" 2>&1 | tee "$TEST_OUTPUT"
        PYTEST_EXIT=$?
        set +o pipefail
        set -e

        echo ""
        echo "Test output saved to: $TEST_OUTPUT"
        exit $PYTEST_EXIT

  test-check:
    desc: Run all tests and return unambiguous PASS/FAIL (for automation)
    deps: [install-worktree, _tmpdir-setup]
    env:
      PYTHONDONTWRITEBYTECODE: "1"
      OMP_NUM_THREADS: "1"
      TMPDIR: "{{.PYTEST_TMPDIR}}"
    cmds:
      - |
        mkdir -p temp
        TEST_OUTPUT="temp/test-$(date +%Y-%m-%d_%H%M%S).txt"

        if [[ -d ".venv" ]]; then
          PYTEST_CMD=".venv/bin/python -m pytest"
        else
          PYTEST_CMD="pytest"
        fi

        set -o pipefail
        set +e
        $PYTEST_CMD tests/ -q --tb=short -n 4 -m "not smoke" --disable-warnings -o "addopts=" --basetemp={{.PYTEST_TMPDIR}} -o "cache_dir={{.PYTEST_CACHEDIR}}" 2>&1 | tee "$TEST_OUTPUT"
        PYTEST_EXIT=$?
        set +o pipefail
        set -e

        echo ""
        echo "Test output saved to: $TEST_OUTPUT"

        if [ "$PYTEST_EXIT" -ne 0 ]; then
          echo ""
          echo "TEST_RESULT=FAIL"
          echo "PYTEST_EXIT_CODE=$PYTEST_EXIT"
          exit 1
        else
          echo ""
          echo "TEST_RESULT=PASS"
          exit 0
        fi

  test-smoke:
    desc: Run smoke tests (requires ANTHROPIC_API_KEY)
    deps: [_tmpdir-setup]
    env:
      PYTHONDONTWRITEBYTECODE: "1"
      OMP_NUM_THREADS: "1"
      SMOKE_TEST: "1"
      TMPDIR: "{{.PYTEST_TMPDIR}}"
    cmds:
      - |
        mkdir -p temp
        TEST_OUTPUT="temp/smoke-$(date +%Y-%m-%d_%H%M%S).txt"
        echo "Running smoke tests"
        echo "Output: $TEST_OUTPUT"

        if [[ -d ".venv" ]]; then
          PYTEST_CMD=".venv/bin/python -m pytest"
        else
          PYTEST_CMD="pytest"
        fi

        set -o pipefail
        set +e
        $PYTEST_CMD tests/recipe/test_smoke_pipeline.py -m smoke -v --tb=short -o "addopts=" --basetemp={{.PYTEST_TMPDIR}} -o "cache_dir={{.PYTEST_CACHEDIR}}" 2>&1 | tee "$TEST_OUTPUT"
        PYTEST_EXIT=$?
        set +o pipefail
        set -e

        echo ""
        echo "Smoke test output saved to: $TEST_OUTPUT"
        exit $PYTEST_EXIT

  test-smoke-record:
    desc: Record smoke test scenario by running autoskillit order with recording enabled
    env:
      RECORD_SCENARIO: "1"
      RECORD_SCENARIO_DIR: '{{.RECORD_SCENARIO_DIR | default "tests/fixtures/scenarios/smoke-happy"}}'
      RECORD_SCENARIO_RECIPE: "smoke-test"
    cmds:
      - |
        mkdir -p "$RECORD_SCENARIO_DIR"
        echo "Recording smoke-test scenario"
        echo "  RECORD_SCENARIO_DIR=$RECORD_SCENARIO_DIR"
        echo ""
        autoskillit order smoke-test

  check-docs:
    desc: Verify documentation counts match source code
    cmds:
      - python scripts/check_doc_counts.py

  sync-plugin-version:
    desc: Sync plugin.json version from pyproject.toml
    cmds:
      - python scripts/sync_plugin_json.py

  sync-hooks-hash:
    desc: "Regenerate src/autoskillit/hooks/registry.sha256 from the live HOOK_REGISTRY"
    cmds:
      - uv run python -c "from autoskillit.hook_registry import HOOK_REGISTRY_HASH, HOOKS_DIR; (HOOKS_DIR / 'registry.sha256').write_text(HOOK_REGISTRY_HASH + '\n')"

  install-worktree:
    desc: Set up development environment (isolated venv in worktrees, direct install in main)
    status:
      - test -x .venv/bin/python
      - uv sync --check --all-extras 2>/dev/null
    cmds:
      - |
        # Detect if we're in a git worktree (worktrees have .git as a file, not a directory)
        if [[ -f ".git" ]]; then
          echo "Worktree detected — creating isolated venv"
          uv venv --clear .venv
          uv pip install -e '.[dev]' --python .venv/bin/python
        elif [[ -d ".venv" ]]; then
          echo "Main directory — installing into existing venv"
          uv pip install -e '.[dev]' --python .venv/bin/python
        else
          echo "Main directory — creating venv and installing"
          uv venv --clear .venv
          uv pip install -e '.[dev]' --python .venv/bin/python
        fi
        echo "Done: $(python --version 2>/dev/null || .venv/bin/python --version)"

  install-dev:
    desc: Install dev version of autoskillit from the integration branch
    cmds:
      - uv tool install --force "autoskillit[dev] @ git+https://github.com/TalonT-Org/AutoSkillit.git@integration"
      - "$(uv tool dir)/autoskillit/bin/autoskillit install"

  vendor-mermaid:
    desc: Download latest mermaid v11 UMD bundle to src/autoskillit/assets/mermaid/
    cmds:
      - mkdir -p src/autoskillit/assets/mermaid
      - |
        VERSION=$(curl -sfL https://unpkg.com/mermaid@11/package.json \
          | python3 -c "import sys, json; print(json.load(sys.stdin)['version'])")
        echo "Fetching mermaid ${VERSION}..."
        curl -sfL "https://unpkg.com/mermaid@${VERSION}/dist/mermaid.min.js" \
          -o src/autoskillit/assets/mermaid/mermaid.min.js
        echo "${VERSION}" > src/autoskillit/assets/mermaid/VERSION
        echo "Vendored mermaid ${VERSION} ($(wc -c < src/autoskillit/assets/mermaid/mermaid.min.js) bytes)"