Taskfile.yml

version: "3"

vars:
  REQUIRED_TASK_VERSION: 3.51.1
  MEDIAGO_DEPS_ROOT: '{{default (printf "%s/.deps" .ROOT_DIR) .MEDIAGO_DEPS_ROOT}}'
  MEDIAGO_WEB_RUNTIME_ROOT: '{{default (printf "%s/.task/web-core" .ROOT_DIR) .MEDIAGO_WEB_RUNTIME_ROOT}}'

tasks:
  security:js:
    desc: Fail on any workspace dependency vulnerability or audit execution error
    cmds:
      - task: internal:require-task-version
      - task: internal:security:js

  security:go:
    desc: Scan backend source with the installed official govulncheck tool
    cmds:
      - task: internal:require-task-version
      - task: internal:security:go

  internal:security:js:
    internal: true
    cmds:
      - pnpm security:js

  internal:security:go:
    internal: true
    cmds:
      - pnpm security:go

  doctor:
    desc: Diagnose the local MediaGo toolchain and runtime dependencies; Node >=24.14.0 is required to aggregate checks
    preconditions:
      - sh: >-
          node -e "const [major, minor] = process.versions.node.split('.').map(Number); process.exit(major > 24 || (major === 24 && minor >= 14) ? 0 : 1)"
        msg: Node 24.14.0 or newer is MediaGo's bootstrap prerequisite. Without a usable Node runtime, doctor cannot aggregate the remaining diagnostics. Install or switch Node (for example, mise use node@24.14.0), then retry.
    env:
      MEDIAGO_TASK_VERSION: "{{.TASK_VERSION}}"
      MEDIAGO_REQUIRED_TASK_VERSION: "{{.REQUIRED_TASK_VERSION}}"
      MEDIAGO_DEPS_ROOT: "{{.MEDIAGO_DEPS_ROOT}}"
    cmds:
      - node packages/tooling/src/bootstrap/task-doctor.ts

  setup:
    desc: Install Node and current-platform runtime dependencies
    cmds:
      - task: internal:require-task-version
      - task: internal:setup

  deps:node:
    desc: Install the pinned pnpm workspace dependencies
    cmds:
      - task: internal:require-task-version
      - task: internal:deps:node

  deps:runtime:
    desc: Install all current-platform runtime tools
    cmds:
      - task: internal:require-task-version
      - task: internal:deps:runtime

  deps:media-integration:
    desc: Install tools used by media integration tests
    cmds:
      - task: internal:require-task-version
      - task: internal:deps:media-integration

  deps:e2e:
    desc: Install tools used by end-to-end tests
    cmds:
      - task: internal:require-task-version
      - task: internal:deps:e2e

  dev:all:
    desc: Start every MediaGo development surface
    cmds:
      - task: internal:require-task-version
      - task: internal:dev:all

  dev:web:
    desc: Start the Web development Core and UI
    cmds:
      - task: internal:require-task-version
      - task: internal:dev:web

  dev:electron:
    desc: Start the Electron desktop application
    cmds:
      - task: internal:require-task-version
      - task: internal:dev:electron

  dev:extension:
    desc: Start the browser extension development server
    cmds:
      - task: internal:require-task-version
      - task: internal:dev:extension

  docs:dev:
    desc: Start the documentation development server
    cmds:
      - task: internal:require-task-version
      - task: internal:docs:dev

  check:
    desc: Run lint, formatting, and type checks
    cmds:
      - task: internal:require-task-version
      - task: internal:check

  test:
    desc: Run the TypeScript and Go test suites
    cmds:
      - task: internal:require-task-version
      - task: internal:test

  test:ts:
    desc: Run the TypeScript test suite
    cmds:
      - task: internal:require-task-version
      - task: internal:test:ts

  test:go:
    desc: Run the Go test suite
    cmds:
      - task: internal:require-task-version
      - task: internal:test:go

  test:integration:
    desc: Run media integration tests
    cmds:
      - task: internal:require-task-version
      - task: internal:test:integration

  test:e2e:
    desc: Run all Playwright end-to-end projects
    cmds:
      - task: internal:require-task-version
      - task: internal:test:e2e

  test:e2e:web:
    desc: Run the Playwright web project
    cmds:
      - task: internal:require-task-version
      - task: internal:test:e2e:web

  test:e2e:electron:
    desc: Run the Playwright Electron project
    cmds:
      - task: internal:require-task-version
      - task: internal:test:e2e:electron

  test:e2e:extension:
    desc: Run the Playwright extension project
    cmds:
      - task: internal:require-task-version
      - task: internal:test:e2e:extension

  build:electron:
    desc: Build the Electron desktop application
    cmds:
      - task: internal:require-task-version
      - task: internal:production:build:electron

  build:extension:
    desc: Build the browser extension
    cmds:
      - task: internal:require-task-version
      - task: internal:build:extension

  build:docs:
    desc: Build the documentation site
    cmds:
      - task: internal:require-task-version
      - task: internal:build:docs

  build:docker:
    desc: Build the local MediaGo Docker image
    cmds:
      - task: internal:require-task-version
      - task: internal:build:docker

  pack:extension:
    desc: Build and package the browser extension
    cmds:
      - task: internal:require-task-version
      - task: internal:pack:extension

  pack:electron:
    desc: Package the Electron desktop application
    cmds:
      - task: internal:require-task-version
      - task: internal:production:pack:electron

  release:electron:
    desc: Build Electron release artifacts
    cmds:
      - task: internal:require-task-version
      - task: internal:production:release:electron

  ci:quality:
    desc: Run the pull-request quality checks
    cmds:
      - task: internal:require-task-version
      - task: internal:ci:quality

  ci:test:ts:
    desc: Run the pull-request TypeScript tests
    cmds:
      - task: internal:require-task-version
      - task: internal:ci:test:ts

  ci:test:go:
    desc: Run the pull-request Go tests
    cmds:
      - task: internal:require-task-version
      - task: internal:ci:test:go

  ci:test:media:
    desc: Run the pull-request media integration tests
    cmds:
      - task: internal:require-task-version
      - task: internal:ci:test:media

  ci:test:e2e:
    desc: Run the pull-request Playwright end-to-end tests
    cmds:
      - task: internal:require-task-version
      - task: internal:ci:test:e2e

  ci:docs:build:
    desc: Build documentation for continuous integration
    cmds:
      - task: internal:require-task-version
      - task: internal:ci:docs:build

  ci:desktop:validate-request:
    desc: Validate the desktop workflow request
    cmds:
      - task: internal:require-task-version
      - task: internal:ci:desktop:validate-request

  ci:desktop:verify-source:
    desc: Verify the desktop workflow source and version
    cmds:
      - task: internal:require-task-version
      - task: internal:ci:desktop:verify-source

  ci:desktop:artifact-prefix:
    desc: Resolve the desktop workflow artifact prefix
    cmds:
      - task: internal:require-task-version
      - task: internal:ci:desktop:artifact-prefix

  ci:desktop:apply-version:
    desc: Apply the desktop workflow build version
    cmds:
      - task: internal:require-task-version
      - task: internal:ci:desktop:apply-version

  ci:desktop:create-test-stage:
    desc: Create a private desktop test staging archive
    cmds:
      - task: internal:require-task-version
      - task: internal:ci:desktop:create-test-stage

  ci:desktop:upload-test-stage:
    desc: Upload a desktop test stage to its private draft
    cmds:
      - task: internal:require-task-version
      - task: internal:ci:desktop:upload-test-stage

  ci:desktop:release:
    desc: Build desktop workflow release artifacts
    cmds:
      - task: internal:require-task-version
      - task: internal:ci:desktop:release

  ci:docker:validate-inputs:
    desc: Validate the Docker workflow inputs
    cmds:
      - task: internal:require-task-version
      - task: internal:ci:docker:validate-inputs

  ci:docker:resolve-parameters:
    desc: Resolve the Docker workflow build parameters
    cmds:
      - task: internal:require-task-version
      - task: internal:ci:docker:resolve-parameters

  ci:docker:verify-preview-private:
    desc: Verify that the Docker preview package is private
    cmds:
      - task: internal:require-task-version
      - task: internal:ci:docker:verify-preview-private

  ci:docker:detect-dockerhub:
    desc: Detect Docker Hub credentials for the Docker workflow
    cmds:
      - task: internal:require-task-version
      - task: internal:ci:docker:detect-dockerhub

  ci:docker:resolve-targets:
    desc: Resolve the Docker workflow image targets
    cmds:
      - task: internal:require-task-version
      - task: internal:ci:docker:resolve-targets

  ci:docker:write-summary:
    desc: Write the Docker workflow summary
    cmds:
      - task: internal:require-task-version
      - task: internal:ci:docker:write-summary

  ci:release:validate-request:
    desc: Validate the release workflow request
    cmds:
      - task: internal:require-task-version
      - task: internal:ci:release:validate-request

  ci:release:detect-release-state:
    desc: Detect the current GitHub Release state
    cmds:
      - task: internal:require-task-version
      - task: internal:ci:release:detect-release-state

  ci:release:reserve-test-version:
    desc: Reserve or recover a private test version
    cmds:
      - task: internal:require-task-version
      - task: internal:ci:release:reserve-test-version

  ci:release:calculate-version:
    desc: Calculate the release workflow version
    cmds:
      - task: internal:require-task-version
      - task: internal:ci:release:calculate-version

  ci:release:commit-version:
    desc: Commit the official release version
    cmds:
      - task: internal:require-task-version
      - task: internal:ci:release:commit-version

  ci:release:resolve-source:
    desc: Resolve the release workflow build source
    cmds:
      - task: internal:require-task-version
      - task: internal:ci:release:resolve-source

  ci:release:write-prepare-summary:
    desc: Write the release preparation summary
    cmds:
      - task: internal:require-task-version
      - task: internal:ci:release:write-prepare-summary

  ci:release:collect-electron-artifacts:
    desc: Collect and validate Electron release artifacts
    cmds:
      - task: internal:require-task-version
      - task: internal:ci:release:collect-electron-artifacts

  ci:release:download-test-stages:
    desc: Download private desktop stages from the owned draft
    cmds:
      - task: internal:require-task-version
      - task: internal:ci:release:download-test-stages

  ci:release:publish-desktop:
    desc: Publish the desktop GitHub Release
    cmds:
      - task: internal:require-task-version
      - task: internal:ci:release:publish-desktop

  ci:release:write-desktop-summary:
    desc: Write the desktop release summary
    cmds:
      - task: internal:require-task-version
      - task: internal:ci:release:write-desktop-summary

  ci:release:record-test-docker:
    desc: Record the private preview image on its test reservation
    cmds:
      - task: internal:require-task-version
      - task: internal:ci:release:record-test-docker

  ci:release:tag-docker-release:
    desc: Tag a Docker-only release
    cmds:
      - task: internal:require-task-version
      - task: internal:ci:release:tag-docker-release

  internal:require-task-version:
    internal: true
    preconditions:
      - sh: >-
          node -e "const [major, minor] = process.versions.node.split('.').map(Number); process.exit(major > 22 || (major === 22 && minor >= 18) ? 0 : 1)"
        msg: Node 22.18.0 or newer is required to validate the supported Task version. Install or switch Node, then retry.
    env:
      MEDIAGO_TASK_VERSION: "{{.TASK_VERSION}}"
      MEDIAGO_REQUIRED_TASK_VERSION: "{{.REQUIRED_TASK_VERSION}}"
    cmds:
      - node packages/tooling/src/bootstrap/task-version-gate.ts

  internal:setup:
    internal: true
    vars: &development-profile-vars
      MEDIAGO_PROFILE: '{{default "development" .MEDIAGO_PROFILE}}'
    env: &profile-env
      MEDIAGO_PROFILE: "{{.MEDIAGO_PROFILE}}"
    dotenv: &profile-dotenv
      - ".env.{{.MEDIAGO_PROFILE}}.local"
      - ".env.local"
      - ".env.{{.MEDIAGO_PROFILE}}"
      - ".env"
    requires: &profile-requires
      vars:
        - name: MEDIAGO_PROFILE
          enum: [development, test, production]
    deps:
      - task: internal:deps:node
      - task: internal:deps:runtime

  internal:deps:node:
    internal: true
    run: once
    preconditions:
      - sh: >-
          node -e "const [major, minor] = process.versions.node.split('.').map(Number); process.exit(major > 24 || (major === 24 && minor >= 14) ? 0 : 1)"
        msg: Node 24.14.0 or newer is required to install MediaGo's workspace dependencies. Install or switch Node (for example, mise use node@24.14.0), then retry.
    method: timestamp
    sources:
      - package.json
      - pnpm-lock.yaml
      - pnpm-workspace.yaml
      - docs/package.json
      - apps/*/package.json
      - apps/*/app/package.json
      - packages/*/package.json
      - packages/*/*/package.json
    generates:
      - node_modules/.pnpm/lock.yaml
    cmds:
      - pnpm install --frozen-lockfile

  internal:deps:runtime:
    internal: true
    run: once
    vars: &runtime-vars
      MEDIAGO_PLATFORM_KEY:
        sh: node packages/tooling/src/runtime-deps/print-platform-key.ts
    env: &runtime-env
      MEDIAGO_DEPS_ROOT: "{{.MEDIAGO_DEPS_ROOT}}"
      MEDIAGO_DEPS_DIR: "{{.MEDIAGO_DEPS_ROOT}}/{{.MEDIAGO_PLATFORM_KEY}}"
    deps:
      - task: internal:deps:node
    cmds:
      - pnpm deps:download:raw --tools ffmpeg,N_m3u8DL-RE,BBDown,aria2,yt-dlp,deno,mediago
      - 'node -e "console.log(''MEDIAGO_RUNTIME_READY'', process.env.MEDIAGO_DEPS_DIR)"'

  internal:deps:media-integration:
    internal: true
    vars: &test-runtime-vars
      MEDIAGO_PROFILE: '{{default "test" .MEDIAGO_PROFILE}}'
      MEDIAGO_PLATFORM_KEY:
        sh: node packages/tooling/src/runtime-deps/print-platform-key.ts
    env:
      MEDIAGO_PROFILE: "{{.MEDIAGO_PROFILE}}"
      MEDIAGO_DEPS_ROOT: "{{.MEDIAGO_DEPS_ROOT}}"
      MEDIAGO_DEPS_DIR: "{{.MEDIAGO_DEPS_ROOT}}/{{.MEDIAGO_PLATFORM_KEY}}"
    dotenv: *profile-dotenv
    requires: *profile-requires
    deps:
      - task: internal:deps:node
    cmds:
      - pnpm deps:download:raw --tools aria2,N_m3u8DL-RE,ffmpeg,BBDown
      - 'node -e "console.log(''MEDIAGO_RUNTIME_READY'', process.env.MEDIAGO_DEPS_DIR)"'

  internal:deps:e2e:
    internal: true
    vars: *test-runtime-vars
    env:
      MEDIAGO_PROFILE: "{{.MEDIAGO_PROFILE}}"
      MEDIAGO_DEPS_ROOT: "{{.MEDIAGO_DEPS_ROOT}}"
      MEDIAGO_DEPS_DIR: "{{.MEDIAGO_DEPS_ROOT}}/{{.MEDIAGO_PLATFORM_KEY}}"
    dotenv: *profile-dotenv
    requires: *profile-requires
    deps:
      - task: internal:deps:node
    cmds:
      - pnpm deps:download:raw --tools aria2
      - 'node -e "console.log(''MEDIAGO_RUNTIME_READY'', process.env.MEDIAGO_DEPS_DIR)"'

  internal:dev:all:
    internal: true
    vars: &development-runtime-vars
      MEDIAGO_PROFILE: '{{default "development" .MEDIAGO_PROFILE}}'
      MEDIAGO_PLATFORM_KEY:
        sh: node packages/tooling/src/runtime-deps/print-platform-key.ts
    env: &development-runtime-env
      MEDIAGO_PROFILE: "{{.MEDIAGO_PROFILE}}"
      MEDIAGO_DEPS_ROOT: "{{.MEDIAGO_DEPS_ROOT}}"
      MEDIAGO_DEPS_DIR: "{{.MEDIAGO_DEPS_ROOT}}/{{.MEDIAGO_PLATFORM_KEY}}"
    dotenv: *profile-dotenv
    requires: *profile-requires
    deps:
      - task: internal:deps:node
      - task: internal:deps:runtime
      - task: internal:core:build
      - task: internal:electron:prepare-development-runtime
    cmds:
      - 'node -e "console.log(''MEDIAGO_DEV_PROCESSES_STARTING'')"'
      - task: internal:dev:all:processes

  internal:dev:all:processes:
    internal: true
    deps:
      - task: internal:core:run:web
      - task: internal:electron:run
      - task: internal:ui:run:electron
      - task: internal:ui:run:web

  internal:electron:prepare-development-runtime:
    internal: true
    run: once
    vars: *development-profile-vars
    env: *profile-env
    dotenv: *profile-dotenv
    requires: *profile-requires
    deps:
      - task: internal:deps:node
    cmds:
      - pnpm exec tsx packages/tooling/src/electron/prepare-development-runtime.ts

  internal:dev:web:
    internal: true
    vars: *development-runtime-vars
    env: *development-runtime-env
    dotenv: *profile-dotenv
    requires: *profile-requires
    deps:
      - task: internal:deps:node
      - task: internal:deps:runtime
      - task: internal:core:build
    cmds:
      - task: internal:dev:web:processes

  internal:dev:web:processes:
    internal: true
    deps:
      - task: internal:core:run:web
      - task: internal:ui:run:web

  internal:dev:electron:
    internal: true
    vars: *development-runtime-vars
    env: *development-runtime-env
    dotenv: *profile-dotenv
    requires: *profile-requires
    deps:
      - task: internal:deps:node
      - task: internal:deps:runtime
      - task: internal:core:build
      - task: internal:electron:prepare-development-runtime
    cmds:
      - pnpm start:electron

  internal:core:run:web:
    internal: true
    vars:
      MEDIAGO_PLATFORM_KEY:
        sh: node packages/tooling/src/runtime-deps/print-platform-key.ts
      MEDIAGO_DEPS_DIR: '{{default (printf "%s/%s" .MEDIAGO_DEPS_ROOT .MEDIAGO_PLATFORM_KEY) .MEDIAGO_DEPS_DIR}}'
      CORE_EXE_SUFFIX:
        sh: >-
          node -e "process.stdout.write(process.platform === 'win32' ? '.exe' : '')"
    env:
      MEDIAGO_DEPS_DIR: "{{.MEDIAGO_DEPS_DIR}}"
      MEDIAGO_RUNTIME_ROOT: "{{.MEDIAGO_WEB_RUNTIME_ROOT}}"
    cmds:
      - '"{{.ROOT_DIR}}/apps/core/bin/mediago-core{{.CORE_EXE_SUFFIX}}" --port=9900 --enable-auth --log-level=debug'

  internal:electron:run:
    internal: true
    cmds:
      - pnpm exec cross-env APP_TARGET=electron turbo run dev -F @mediago/electron

  internal:ui:run:electron:
    internal: true
    cmds:
      - pnpm exec cross-env APP_TARGET=electron pnpm -F @mediago/ui run dev

  internal:ui:run:web:
    internal: true
    cmds:
      - pnpm exec cross-env APP_TARGET=server NODE_ENV=development pnpm -F @mediago/ui run dev

  internal:dev:extension:
    internal: true
    vars: *development-profile-vars
    env: *profile-env
    dotenv: *profile-dotenv
    requires: *profile-requires
    deps:
      - task: internal:deps:node
    cmds:
      - pnpm -F @mediago/extension run dev

  internal:docs:dev:
    internal: true
    vars: *development-profile-vars
    env: *profile-env
    dotenv: *profile-dotenv
    requires: *profile-requires
    deps:
      - task: internal:deps:node
    cmds:
      - pnpm -F @mediago/docs run docs:dev

  internal:check:
    internal: true
    vars: &test-profile-vars
      MEDIAGO_PROFILE: '{{default "test" .MEDIAGO_PROFILE}}'
    env: *profile-env
    dotenv: *profile-dotenv
    requires: *profile-requires
    deps:
      - task: internal:deps:node
    cmds:
      - pnpm lint
      - pnpm format:check
      - pnpm type:check

  internal:test:
    internal: true
    vars: *test-profile-vars
    env: *profile-env
    dotenv: *profile-dotenv
    requires: *profile-requires
    deps:
      - task: internal:deps:node
      - task: internal:test:ts
      - task: internal:test:go

  internal:test:ts:
    internal: true
    vars: *test-profile-vars
    env: *profile-env
    dotenv: *profile-dotenv
    requires: *profile-requires
    deps:
      - task: internal:deps:node
    cmds:
      - pnpm exec vitest run

  internal:test:go:
    internal: true
    vars: *test-profile-vars
    env: *profile-env
    dotenv: *profile-dotenv
    requires: *profile-requires
    dir: apps/core
    cmds:
      - go test ./...

  internal:test:integration:
    internal: true
    vars: *test-runtime-vars
    env:
      MEDIAGO_PROFILE: "{{.MEDIAGO_PROFILE}}"
      MEDIAGO_DEPS_ROOT: "{{.MEDIAGO_DEPS_ROOT}}"
      MEDIAGO_DEPS_DIR: "{{.MEDIAGO_DEPS_ROOT}}/{{.MEDIAGO_PLATFORM_KEY}}"
    dotenv: *profile-dotenv
    requires: *profile-requires
    deps:
      - task: internal:deps:media-integration
    cmds:
      - pnpm test:integration:media:run:raw

  internal:test:e2e:
    internal: true
    vars: *test-runtime-vars
    env: &test-runtime-env
      MEDIAGO_PROFILE: "{{.MEDIAGO_PROFILE}}"
      MEDIAGO_DEPS_ROOT: "{{.MEDIAGO_DEPS_ROOT}}"
      MEDIAGO_DEPS_DIR: "{{.MEDIAGO_DEPS_ROOT}}/{{.MEDIAGO_PLATFORM_KEY}}"
    dotenv: *profile-dotenv
    requires: *profile-requires
    deps: &e2e-deps
      - task: internal:deps:e2e
      - task: internal:test:e2e:build
      - task: internal:test:e2e:chromium
    cmds:
      - pnpm test:e2e:raw

  internal:test:e2e:web:
    internal: true
    vars: *test-runtime-vars
    env: *test-runtime-env
    dotenv: *profile-dotenv
    requires: *profile-requires
    deps: *e2e-deps
    cmds:
      - pnpm test:e2e:web:raw

  internal:test:e2e:electron:
    internal: true
    vars: *test-runtime-vars
    env: *test-runtime-env
    dotenv: *profile-dotenv
    requires: *profile-requires
    deps: *e2e-deps
    cmds:
      - pnpm test:e2e:electron:raw

  internal:test:e2e:extension:
    internal: true
    vars: *test-runtime-vars
    env: *test-runtime-env
    dotenv: *profile-dotenv
    requires: *profile-requires
    deps: *e2e-deps
    cmds:
      - pnpm test:e2e:extension:raw

  internal:core:build:
    internal: true
    run: once
    deps:
      - task: internal:deps:node
    cmds:
      - pnpm core:build

  internal:core:build:production:
    internal: true
    run: once
    deps:
      - task: internal:deps:node
    cmds:
      - pnpm core:build:production

  internal:test:e2e:build:
    internal: true
    vars: *test-profile-vars
    env: *profile-env
    dotenv: *profile-dotenv
    requires: *profile-requires
    deps:
      - task: internal:core:build
    cmds:
      - pnpm test:e2e:build:raw

  internal:test:e2e:chromium:
    internal: true
    deps:
      - task: internal:deps:node
    cmds:
      - pnpm exec playwright install chromium

  internal:build:electron:
    internal: true
    deps:
      - task: internal:build:electron:workspace

  internal:build:electron:workspace:
    internal: true
    vars: &production-profile-vars
      MEDIAGO_PROFILE: '{{default "production" .MEDIAGO_PROFILE}}'
    env: *profile-env
    dotenv: *profile-dotenv
    requires: *profile-requires
    deps:
      - task: internal:deps:node
      - task: internal:core:build:production
    cmds:
      - pnpm build:electron:raw

  internal:production:build:electron:
    internal: true
    deps: &production-metadata-bootstrap-deps
      - task: internal:deps:node
    cmds:
      - task: internal:production:build:electron:validated

  internal:production:build:electron:validated:
    internal: true
    vars:
      MEDIAGO_PROFILE: '{{default "production" .MEDIAGO_PROFILE}}'
      APP_NAME:
        sh: node packages/tooling/src/task/task-production-metadata.ts APP_NAME
    env: *profile-env
    dotenv: *profile-dotenv
    requires:
      vars:
        - name: MEDIAGO_PROFILE
          enum: [development, test, production]
        - name: APP_NAME
          enum: [present]
    cmds:
      - task: internal:build:electron

  internal:build:extension:
    internal: true
    vars: *production-profile-vars
    env: *profile-env
    dotenv: *profile-dotenv
    requires: *profile-requires
    deps:
      - task: internal:deps:node
    cmds:
      - pnpm -F @mediago/extension run build

  internal:build:docs:
    internal: true
    vars: *production-profile-vars
    env: *profile-env
    dotenv: *profile-dotenv
    requires: *profile-requires
    deps:
      - task: internal:deps:node
    cmds:
      - pnpm -F @mediago/docs run docs:build

  internal:build:docker:
    internal: true
    vars: *production-profile-vars
    env: *profile-env
    dotenv: *profile-dotenv
    requires: *profile-requires
    deps:
      - task: internal:docker:daemon
    cmds:
      - docker build -t mediago:local .

  internal:docker:daemon:
    internal: true
    preconditions:
      - sh: docker info >/dev/null 2>&1
        msg: Docker daemon is unavailable. Start Docker and retry task build:docker.

  internal:pack:extension:
    internal: true
    vars: *production-profile-vars
    env: *profile-env
    dotenv: *profile-dotenv
    requires: *profile-requires
    deps:
      - task: internal:build:extension
    cmds:
      - pnpm pack:extension:raw

  internal:pack:electron:
    internal: true
    vars: &production-runtime-vars
      MEDIAGO_PROFILE: '{{default "production" .MEDIAGO_PROFILE}}'
      MEDIAGO_PLATFORM_KEY:
        sh: node packages/tooling/src/runtime-deps/print-platform-key.ts
    env: &production-runtime-env
      MEDIAGO_PROFILE: "{{.MEDIAGO_PROFILE}}"
      MEDIAGO_DEPS_ROOT: "{{.MEDIAGO_DEPS_ROOT}}"
      MEDIAGO_DEPS_DIR: "{{.MEDIAGO_DEPS_ROOT}}/{{.MEDIAGO_PLATFORM_KEY}}"
    dotenv: *profile-dotenv
    requires: *profile-requires
    deps: &electron-package-deps
      - task: internal:deps:runtime
      - task: internal:build:electron
    cmds:
      - pnpm -F @mediago/electron run pack

  internal:production:pack:electron:
    internal: true
    deps: *production-metadata-bootstrap-deps
    cmds:
      - task: internal:production:pack:electron:validated

  internal:production:pack:electron:validated:
    internal: true
    vars: &production-package-metadata-vars
      MEDIAGO_PROFILE: '{{default "production" .MEDIAGO_PROFILE}}'
      APP_NAME:
        sh: node packages/tooling/src/task/task-production-metadata.ts APP_NAME
      APP_ID:
        sh: node packages/tooling/src/task/task-production-metadata.ts APP_ID
      APP_COPYRIGHT:
        sh: node packages/tooling/src/task/task-production-metadata.ts APP_COPYRIGHT
    env: *profile-env
    dotenv: *profile-dotenv
    requires: &production-package-metadata-requires
      vars:
        - name: MEDIAGO_PROFILE
          enum: [development, test, production]
        - name: APP_NAME
          enum: [present]
        - name: APP_ID
          enum: [present]
        - name: APP_COPYRIGHT
          enum: [present]
    cmds:
      - task: internal:pack:electron

  internal:release:electron:
    internal: true
    vars: *production-runtime-vars
    env: *production-runtime-env
    dotenv: *profile-dotenv
    requires: *profile-requires
    deps: *electron-package-deps
    cmds:
      - pnpm -F @mediago/electron run release

  internal:production:release:electron:
    internal: true
    deps: *production-metadata-bootstrap-deps
    cmds:
      - task: internal:production:release:electron:validated

  internal:production:release:electron:validated:
    internal: true
    vars: *production-package-metadata-vars
    env: *profile-env
    dotenv: *profile-dotenv
    requires: *production-package-metadata-requires
    cmds:
      - task: internal:release:electron

  internal:ci:quality:
    internal: true
    deps:
      - task: internal:check

  internal:ci:test:ts:
    internal: true
    deps:
      - task: internal:test:ts

  internal:ci:test:go:
    internal: true
    deps:
      - task: internal:test:go

  internal:ci:test:media:
    internal: true
    deps:
      - task: internal:test:integration

  internal:ci:test:e2e:
    internal: true
    vars: *test-runtime-vars
    env: *test-runtime-env
    dotenv: *profile-dotenv
    requires: *profile-requires
    deps:
      - task: internal:deps:e2e
      - task: internal:test:e2e:build
    cmds:
      - node packages/tooling/src/github/prepare-playwright-apt.ts
      - pnpm exec playwright install-deps chromium
      - pnpm exec playwright install chromium
      - pnpm type:check:e2e
      - xvfb-run -a pnpm test:e2e:raw --project="${MEDIAGO_E2E_PROJECT:-*}"

  internal:ci:docs:build:
    internal: true
    deps:
      - task: internal:build:docs

  internal:ci:desktop:validate-request:
    internal: true
    cmds:
      - node packages/tooling/src/github/desktop-workflow.ts validate-request

  internal:ci:desktop:verify-source:
    internal: true
    cmds:
      - node packages/tooling/src/github/desktop-workflow.ts verify-source

  internal:ci:desktop:artifact-prefix:
    internal: true
    cmds:
      - node packages/tooling/src/github/desktop-workflow.ts artifact-prefix

  internal:ci:desktop:apply-version:
    internal: true
    cmds:
      - node packages/tooling/src/github/desktop-workflow.ts apply-version

  internal:ci:desktop:create-test-stage:
    internal: true
    cmds:
      - node packages/tooling/src/github/desktop-workflow.ts create-test-stage

  internal:ci:desktop:upload-test-stage:
    internal: true
    cmds:
      - node packages/tooling/src/github/desktop-workflow.ts upload-test-stage

  internal:ci:desktop:release:
    internal: true
    vars: *production-runtime-vars
    env: *production-runtime-env
    dotenv: *profile-dotenv
    requires: *profile-requires
    deps:
      - task: internal:release:electron

  internal:ci:docker:validate-inputs:
    internal: true
    cmds:
      - node packages/tooling/src/github/docker-workflow.ts validate-inputs

  internal:ci:docker:resolve-parameters:
    internal: true
    cmds:
      - node packages/tooling/src/github/docker-workflow.ts resolve-parameters

  internal:ci:docker:verify-preview-private:
    internal: true
    cmds:
      - node packages/tooling/src/github/docker-workflow.ts verify-preview-private

  internal:ci:docker:detect-dockerhub:
    internal: true
    cmds:
      - node packages/tooling/src/github/docker-workflow.ts detect-dockerhub

  internal:ci:docker:resolve-targets:
    internal: true
    cmds:
      - node packages/tooling/src/github/docker-workflow.ts resolve-targets

  internal:ci:docker:write-summary:
    internal: true
    cmds:
      - node packages/tooling/src/github/docker-workflow.ts write-summary

  internal:ci:release:validate-request:
    internal: true
    cmds:
      - node packages/tooling/src/github/release-workflow.ts validate-request

  internal:ci:release:detect-release-state:
    internal: true
    cmds:
      - node packages/tooling/src/github/release-workflow.ts detect-release-state

  internal:ci:release:reserve-test-version:
    internal: true
    cmds:
      - node packages/tooling/src/github/release-workflow.ts reserve-test-version

  internal:ci:release:calculate-version:
    internal: true
    cmds:
      - node packages/tooling/src/github/release-workflow.ts calculate-version

  internal:ci:release:commit-version:
    internal: true
    cmds:
      - node packages/tooling/src/github/release-workflow.ts commit-version

  internal:ci:release:resolve-source:
    internal: true
    cmds:
      - node packages/tooling/src/github/release-workflow.ts resolve-source

  internal:ci:release:write-prepare-summary:
    internal: true
    cmds:
      - node packages/tooling/src/github/release-workflow.ts write-prepare-summary

  internal:ci:release:collect-electron-artifacts:
    internal: true
    cmds:
      - 'node packages/tooling/src/electron-artifacts/cli.ts electron-artifacts release-files "$VERSION" "$UPDATER_CHANNEL"'

  internal:ci:release:download-test-stages:
    internal: true
    cmds:
      - node packages/tooling/src/github/release-workflow.ts download-test-stages

  internal:ci:release:publish-desktop:
    internal: true
    cmds:
      - node packages/tooling/src/github/release-workflow.ts publish-desktop

  internal:ci:release:write-desktop-summary:
    internal: true
    cmds:
      - node packages/tooling/src/github/release-workflow.ts write-desktop-summary

  internal:ci:release:record-test-docker:
    internal: true
    cmds:
      - node packages/tooling/src/github/release-workflow.ts record-test-docker

  internal:ci:release:tag-docker-release:
    internal: true
    cmds:
      - node packages/tooling/src/github/release-workflow.ts tag-docker-release

  ci:release:prepare-recovery:
    desc: Validate the original beta release and reusable artifacts
    cmds:
      - task: internal:require-task-version
      - task: internal:ci:release:prepare-recovery

  ci:release:apply-recovery-tooling:
    desc: Apply reviewed packaging tools to the original product commit
    cmds:
      - task: internal:require-task-version
      - task: internal:ci:release:apply-recovery-tooling

  internal:ci:release:prepare-recovery:
    internal: true
    cmds:
      - node packages/tooling/src/github/release-recovery.ts prepare

  internal:ci:release:apply-recovery-tooling:
    internal: true
    cmds:
      - node packages/tooling/src/github/release-recovery.ts apply-tooling