Taskfile.yaml

# Taskfile.yaml - development and test tasks for the generic devcontainer kit
#
# Why this exists:
# - keeps the kit's Docker and smoke-test commands close to the files they verify
# - provides a stable entrypoint for tests without adding root-level wrappers
#
# Inputs:
# - WORKSPACE selects the host path mounted into docker-run, defaulting to $PWD,
#   and is passed as DEVCONTAINER_WORKSPACE_FOLDER for entrypoint setup.
# - COMMAND selects the docker-run command, defaulting to devcontainer up.
# - CONTAINER_* values can align the image user with the caller.
#
# Related files:
# - Dockerfile.base
# - cmds/
# - entrypoint.sh
# - scripts/release-build.sh
# - scripts/stage-runtime-tree.sh
# - tests/run.sh
# - tests/devcontainer-reality-test.sh
# - scripts/chrome.sh
# - tests/browser-open-test.sh
# - tests/release-build.sh

version: '3'

vars:
  IMAGE: codegeist-devcontainer-kit:local
  WORKSPACE:
    sh: printf '%s' "${WORKSPACE:-$PWD}"
  COMMAND:
    sh: printf '%s' "${COMMAND:-devcontainer up --workspace-folder .}"
  CONTAINER_USER:
    sh: printf '%s' "${CONTAINER_USER:-${USER:-$(id -un)}}"
  CONTAINER_GROUP:
    sh: printf '%s' "${CONTAINER_GROUP:-${USER:-$(id -un)}}"
  CONTAINER_UID:
    sh: printf '%s' "${CONTAINER_UID:-${UID:-$(id -u)}}"
  CONTAINER_GID:
    sh: printf '%s' "${CONTAINER_GID:-${UID:-$(id -u)}}"

tasks:
  check:
    desc: Run fast deterministic contributor checks
    cmds:
      - >-
        bash -n
        "{{.TASKFILE_DIR}}"/cmds/*
        "{{.TASKFILE_DIR}}/entrypoint.sh"
        "{{.TASKFILE_DIR}}/initialize.sh"
        "{{.TASKFILE_DIR}}"/scripts/*.sh
        "{{.TASKFILE_DIR}}"/tests/*.sh
      - '"{{.TASKFILE_DIR}}/tests/release-build.sh"'
      - '"{{.TASKFILE_DIR}}/tests/runtime-worktree-task.sh"'

  docker-build:
    desc: Build the generic devcontainer kit image
    cmds:
      - >-
        bash -lc 'tmp_dir="$(mktemp -d)";
        cleanup() { rm -rf "$tmp_dir"; };
        trap cleanup EXIT;
        mkdir -p "$tmp_dir/.devcontainer";
        cp -R "{{.TASKFILE_DIR}}/." "$tmp_dir/.devcontainer/";
        rm -rf "$tmp_dir/.devcontainer/tests";
        docker build
        --build-arg CONTAINER_USER={{.CONTAINER_USER}}
        --build-arg CONTAINER_GROUP={{.CONTAINER_GROUP}}
        --build-arg CONTAINER_UID={{.CONTAINER_UID}}
        --build-arg CONTAINER_GID={{.CONTAINER_GID}}
        -f "$tmp_dir/.devcontainer/Dockerfile.base"
        -t {{.IMAGE}}
        "$tmp_dir"'

  docker-run:
    desc: Run the generic devcontainer kit image with nested Docker
    deps:
      - docker-build
    cmds:
      - >-
        docker run --rm -it
        --privileged
        --network host
        -e DEVCONTAINER_WORKSPACE_FOLDER={{.WORKSPACE}}
        -v {{.WORKSPACE}}:{{.WORKSPACE}}
        -w {{.WORKSPACE}}
        {{.IMAGE}}
        {{.COMMAND}}

  browser-open-test:
    desc: Start a temp Dev Containers CLI repo and open visible Chrome
    cmds:
      - '{{.TASKFILE_DIR}}/tests/browser-open-test.sh {{.CLI_ARGS}}'

  qemu-alpine-smoke:
    desc: Download and boot Alpine Linux through QEMU
    cmds:
      - '{{.TASKFILE_DIR}}/tests/qemu-alpine-smoke.sh'

  tests-run:
    desc: Run the generic devcontainer kit test suite
    cmds:
      - '{{.TASKFILE_DIR}}/tests/run.sh'

  devcontainer-reality-test:
    desc: Verify a staged test release and open its container Bash
    env:
      DEVCONTAINER_TEST_RELEASE_DIR: '{{default .CLI_ARGS .TEST_RELEASE_DIR}}'
    cmds:
      - '{{.TASKFILE_DIR}}/tests/devcontainer-reality-test.sh'

  test:release-build:
    desc: Stage the current worktree as a disposable runtime release
    env:
      RUNTIME_TREE_OUTPUT_DIR: '{{default .CLI_ARGS .TEST_RELEASE_DIR}}'
      RUNTIME_TREE_REPLACE: 'true'
    cmds:
      - '"{{.TASKFILE_DIR}}/scripts/stage-runtime-tree.sh"'

  test:release-build:reality:
    # When invoked inside the parent devcontainer, the reality and worktree
    # containers use its nested Docker daemon, not the SSH host Docker daemon.
    desc: Stage a test release, verify it, and open its container Bash
    vars:
      TEST_RELEASE_DIR: '{{default ".tmp/current-release" .CLI_ARGS}}'
    cmds:
      - task: test:release-build
        vars:
          TEST_RELEASE_DIR: '{{.TEST_RELEASE_DIR}}'
      - task: devcontainer-reality-test
        vars:
          TEST_RELEASE_DIR: '{{.TEST_RELEASE_DIR}}'

  release-build:
    desc: Update the runtime-only devcontainer release branch
    cmds:
      - '{{.TASKFILE_DIR}}/scripts/release-build.sh {{.CLI_ARGS}}'