vibe-action 0.0.2

Command router — execute shell commands and LLM prompts via simple YAML actions.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100

# Tag System

Tags connect pipeline steps. When you write `{tag_name}` in an action, the engine replaces it with the output of the step that has `tag: tag_name`.

## Basic Example

```yaml
actions:
  - tag: tag_files
    type: cmd
    expect: list<string>
    action: ls *.rs

  - tag: tag_summary
    type: llm
    expect: string
    action: Summarize these files - {tag_files|join}
```

Step `tag_summary` depends on `tag_files`. The engine runs `tag_files` first, then passes its output to `tag_summary`.
The `|join` modifier collapses the `list<string>` result into a single string — without it, `tag_summary` would execute once for each file in the list.

## Automatic Dependency Ordering

You don't need to write steps in execution order. The engine:

1. Scans all actions for `{tag}` references
2. Builds a directed acyclic graph (DAG)
3. Sorts topologically using Kahn's algorithm
4. Detects circular dependencies and reports errors

```yaml
actions:
  # These can be in any order — the engine sorts them:
  - tag: tag_commit
    type: cmd
    action: git commit -m '{tag_message}'

  - tag: tag_files
    type: cmd
    action: git diff --name-only

  - tag: tag_message
    type: llm
    action: Write a commit message for: {tag_files}
```

Execution order: `tag_files` → `tag_message` → `tag_commit`

## List Expansion

When a step expects `list<string>` and receives a list from a tag, the engine runs the action **for each element**:

```yaml
actions:
  - tag: tag_files
    type: cmd
    expect: list<string>
    action: git diff --name-only
    # Returns: ["main.rs", "lib.rs"]

  - tag: tag_diff
    type: cmd
    expect: list<string>
    action: git diff {tag_files}
    # Runs twice: git diff main.rs, git diff lib.rs
    # Returns: ["diff for main", "diff for lib"]
```

## Multiple Dependencies

A step can reference multiple tags:

```yaml
- tag: tag_report
  type: llm
  expect: string
  action: |
    Compare these two files:
    File A: {tag_file_a}
    File B: {tag_file_b}
```

The engine waits for both `tag_file_a` and `tag_file_b` before running `tag_report`.

## Circular Dependencies

Circular references are detected at startup and reported as errors:

```yaml
# ❌ This will fail validation:
- tag: tag_a
  action: echo {tag_b}
- tag: tag_b
  action: echo {tag_a}
```

```
Error: Circular dependency detected involving tag: 'tag_a'
```