#
#                █████
#               ░░███
#       ██████  ███████    ██████
#      ███░░███░░░███░    ░░░░░███
#     ░███ ░███  ░███      ███████
#     ░███ ░███  ░███ ███ ███░░███
#     ░░██████   ░░█████ ░░████████
#      ░░░░░░     ░░░░░   ░░░░░░░░
#
#   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-node
  description: Minimal Node repo that shows the check-only Node toolchain boundary plus declared package-manager ownership
  type: application
toolchains:
  node:
    version: "22"
    package_managers:
      pnpm: "10.0.0"
tasks:
  setup:
    description: Hydrate Node dependencies through the declared pnpm lane
    prepare:
      kind: dependency_hydration
      medium: package_dependencies
      source:
        kind: node_package_manager
        cwd: .
        manager: pnpm
        mode: install
        frozen_lockfile: true
    requirements:
      toolchains:
        - node
    effects:
      writes:
        - node_modules
        - .pnpm-store
      network: true
      network_kind: dependency_hydration
  dev:
    description: Start the local development task
    run: pnpm dev
    depends_on:
      - setup
    requirements:
      toolchains:
        - node
  test:
    description: Run the verification suite
    run: pnpm test
    depends_on:
      - setup
    requirements:
      toolchains:
        - node
workflows:
  default: app
  app:
    intent: local_development
    description: Canonical Node front door with explicit setup and run tasks
    setup:
      task: setup
    run:
      task: dev
    notes: |
      Use this when you want the repo front door, not just one command.
      `toolchains.node` keeps the Node runtime, `node` executable, and declared package managers
      under one owner.
agent:
  entrypoint: setup
  default_task: test
  safe_tasks:
    - setup
    - test
  verify_after_changes:
    - test
  writable_paths:
    - node_modules
    - .pnpm-store
    - src
    - tests
    - docs
  protected_paths:
    - ota.yaml
  notes: |
    Use `ota validate` before changes and `ota doctor` after edits.
    Use `ota workflows` to inspect the main repo path and `ota up --workflow app` to prepare it.
    Use `ota run test` as the main verification step for Node and TypeScript changes.
    Keep `toolchains.node` as the owner for the Node runtime, `node` executable, and declared
    Corepack package-manager activation.