sinkstate/action.yml at master · profullstack/sinkstate · GitHub

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
name: sinkstate
description: Find the states your agent graph can enter but never leave, and fail the build when one appears.
author: Profullstack, Inc.

branding:
  icon: alert-triangle
  color: red

inputs:
  files:
    description: 'Graph files to analyse. A path, a comma/newline separated list, or a glob such as `graphs/**/*.json`.'
    required: true
  entry:
    description: 'Entry state, for formats that cannot declare one (n8n, mermaid flowcharts).'
    required: false
  goal:
    description: 'Goal ("done") states, comma separated.'
    required: false
  unsafe:
    description: 'States a safe path may not cross, comma separated.'
    required: false
  adapter:
    description: 'Force an adapter (json, langgraph, n8n, mermaid) instead of auto-detecting.'
    required: false
  require:
    description: 'Properties that must pass, comma separated.'
    required: false
    default: 'reachable,branch-stable'
  comment:
    description: 'Post the report as a pull request comment (updated in place, never appended).'
    required: false
    default: 'true'
  fail-on-error:
    description: 'Fail the job when a required property fails. Set false to report without blocking.'
    required: false
    default: 'true'
  token:
    description: 'Token used to comment. Needs `pull-requests: write`.'
    required: false
    default: ${{ github.token }}

outputs:
  dead:
    description: 'Total dead states across every analysed graph.'
    value: ${{ steps.sinkstate.outputs.dead }}
  stable:
    description: 'true when every required property passed on every graph.'
    value: ${{ steps.sinkstate.outputs.stable }}
  files-checked:
    description: 'How many graph files were analysed.'
    value: ${{ steps.sinkstate.outputs.files-checked }}

runs:
  using: composite
  steps:
    - id: sinkstate
      shell: bash
      run: node "$GITHUB_ACTION_PATH/action/run.mjs"
      env:
        INPUT_FILES: ${{ inputs.files }}
        INPUT_ENTRY: ${{ inputs.entry }}
        INPUT_GOAL: ${{ inputs.goal }}
        INPUT_UNSAFE: ${{ inputs.unsafe }}
        INPUT_ADAPTER: ${{ inputs.adapter }}
        INPUT_REQUIRE: ${{ inputs.require }}
        INPUT_COMMENT: ${{ inputs.comment }}
        INPUT_FAIL_ON_ERROR: ${{ inputs.fail-on-error }}
        INPUT_TOKEN: ${{ inputs.token }}