specs/062-dbt.md

Rama main · réplica de lectura del repositorio original.

# Spec 062: dbt Action

## Status

Partial. Conformance covers Dagu's validation of the remote action reference.

## Scope

`dbt@v1` is an official remote action. This specification covers the
configuration boundary exposed by the Dagu CLI. Conformance tests do not
fetch the action or provision external runtimes.

dbt execution, adapter installation, environment merging, command flags,
and generated artifacts belong to the action repository’s tests.

Remote input validation is outside this suite. Successful CLI validation
alone does not establish that inputs are valid for the remote action.

## Goal

Workflow authors can validate versioned remote action references without
fetching action code or provisioning a runtime.

## Behavior

`dagu validate` accepts a versioned `dbt@v1` reference and its
`with` mapping without fetching the remote action.

## Errors

The unversioned `dbt` name is rejected as an unknown action with a
nonzero exit code.

Runtime failures, timeout, abort, and cleanup are outside this configuration
conformance scope and belong to action and lifecycle tests.

## Examples

```yaml
steps:
  - action: dbt@v1
    with:
      projectDir: .
      command: build
```

## Conformance

`conformance/spec062_dbt/` checks a configured, versioned reference and
rejects the unversioned name. Both cases use `dagu validate` and require no
network access.