name: 'TreeTrace'

description: 'Prompt-lineage visibility for coding & CLI agent sessions. Generates a structured local record of every correction, refusal, token, and tool from your agent transcript.'

author: 'Zion Boggan'

branding:

  icon: 'git-branch'

  color: 'green'

inputs:

  source:

    description: >

      Path to a transcript file (.jsonl or plain text) committed or produced in

      CI. Session logs live on dev machines, not in CI, so typical usage is

      regenerating PROMPT_TREE.md from a committed .treetrace/tree.json or an

      uploaded transcript artifact.

    required: false

    default: ''

  comment-pr:

    description: 'Post the tree summary as a PR comment (requires GITHUB_TOKEN).'

    required: false

    default: 'false'

runs:

  using: 'composite'

  steps:

    - name: Generate prompt tree

      shell: bash

      env:

        TT_SOURCE: ${{ inputs.source }}

      run: |

        set -euo pipefail

        if [ -n "$TT_SOURCE" ]; then

          npx --yes treetrace --file "$TT_SOURCE" --redact-auto --quiet

        elif [ -f .treetrace/tree.json ]; then

          echo "::notice::Using committed .treetrace/tree.json"

          node -e "

            const { readFileSync, writeFileSync } = require('fs');

            const data = JSON.parse(readFileSync('.treetrace/tree.json','utf8'));

            console.log('lineage present:', data.nodes.length, 'nodes. TREETRACE_REPORT.md and PROMPT_TREE.md should be committed alongside it');

          "

        else

          echo "::warning::No source transcript or .treetrace/tree.json found, nothing to do."

        fi

    - name: Comment on PR

      if: ${{ inputs.comment-pr == 'true' && github.event_name == 'pull_request' }}

      shell: bash

      env:

        GH_TOKEN: ${{ github.token }}

        PR_NUMBER: ${{ github.event.pull_request.number }}

      run: |

        set -euo pipefail

        if [ -f TREETRACE_REPORT.md ]; then

          {

            echo "### TreeTrace report"

            echo ""

            head -c 4000 TREETRACE_REPORT.md

            echo ""

            echo "_Full report: TREETRACE_REPORT.md_"

          } > /tmp/tt-comment.md

          gh pr comment "$PR_NUMBER" --body-file /tmp/tt-comment.md

        elif [ -f PROMPT_TREE.md ]; then

          {

            echo "### Prompt tree"

            echo ""

            head -c 4000 PROMPT_TREE.md

            echo ""

            echo "_Full lineage: PROMPT_TREE.md_"

          } > /tmp/tt-comment.md

          gh pr comment "$PR_NUMBER" --body-file /tmp/tt-comment.md

        fi