name: sourcey.build
description: Build a Sourcey documentation site for a configured project.
source:
  type: cli-tool
  command: node
  args:
    - ./run.mjs
  timeout_seconds: 180
  input_mode: none
inputs:
  project:
    type: string
    required: true
    description: Project root containing Sourcey inputs.
  homepage_url:
    type: string
    required: true
    description: Canonical project homepage URL to include in docs context.
  brand_name:
    type: string
    required: true
    description: Human-facing brand or project name for the generated docs context.
  docs_inputs:
    type: json
    required: true
    description: Structured docs inputs, for example {"mode":"config","config":"sourcey.config.ts"} or {"mode":"openapi","spec":"openapi.yaml"}.
  output_dir:
    type: string
    required: false
    description: Output directory for Sourcey docs; defaults to <project>/.sourcey/runx-docs.
  sourcey_bin:
    type: string
    required: false
    description: Explicit Sourcey executable or JS entrypoint; defaults to SOURCEY_BIN or sourcey on PATH.
scopes:
  - sourcey.build
runx:
  artifacts:
    wrap_as: sourcey_build_report