ota.yaml

#
#                █████
#               ░░███
#       ██████  ███████    ██████
#      ███░░███░░░███░    ░░░░░███
#     ░███ ░███  ░███      ███████
#     ░███ ░███  ░███ ███ ███░░███
#     ░░██████   ░░█████ ░░████████
#      ░░░░░░     ░░░░░   ░░░░░░░░
#
#   Copyright (C) 2026 — 2026, Ota. All Rights Reserved.
#
#   DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
#
#   Licensed under the Apache License, Version 2.0. See LICENSE for the full license text.
#   You may not use this file except in compliance with that License.
#   Unless required by applicable law or agreed to in writing, software distributed under the
#   License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND,
#   either express or implied. See the License for the specific language governing permissions
#   and limitations under the License.
#
#   If you need additional information or have any questions, please email: os@ota.run

version: 1
project:
  name: basic-python
  description: Minimal Python repo that still shows workflow-scoped setup and verification
  type: application
runtimes:
  python: "3.12"
tasks:
  setup:
    description: Install Python dependencies from requirements.txt
    run: python -m pip install -r requirements.txt
    requirements:
      runtimes:
        python: "3.12"
      checks:
        - python-installed
  test:
    description: Run the Python test suite
    run: python -m pytest
    depends_on:
      - setup
    requirements:
      runtimes:
        python: "3.12"
workflows:
  default: verify
  verify:
    description: Canonical Python setup and verification path
    setup:
      task: setup
    run:
      task: test
    notes: |
      Use this when the repo front door is setup plus verification rather than a long-running dev server.
checks:
  - name: python-installed
    kind: precondition
    severity: error
    run: python --version
agent:
  entrypoint: setup
  default_task: test
  safe_tasks:
    - setup
    - test
  verify_after_changes:
    - test
  writable_paths:
    - docs
    - tests
  protected_paths:
    - ota.yaml
  notes: |
    Use `ota validate` before changes and `ota workflows` to inspect the setup-plus-test path.
    Keep dependency installation in `setup` and use `ota run test` to verify Python changes.