feat: add GitHub Action for CI/CD usage

Author: nikolay-e

.github/actions/treemapper/README.md

@@ -0,0 +1,67 @@
+# TreeMapper GitHub Action
+
+Export your codebase for AI/LLM context in CI/CD pipelines.
+
+## Usage
+
+```yaml
+- uses: nikolay-e/treemapper/.github/actions/treemapper@main
+  with:
+    path: './src'
+    format: 'yaml'
+    output: 'context.yaml'
+```
+
+## Inputs
+
+| Input | Description | Default |
+|-------|-------------|---------|
+| `path` | Directory to analyze | `.` |
+| `format` | Output format (yaml/json/txt/md) | `yaml` |
+| `output` | Output file path | `tree.yaml` |
+| `max-depth` | Maximum traversal depth | unlimited |
+| `no-content` | Skip file contents | `false` |
+| `max-file-bytes` | Skip large files (bytes) | 10MB |
+| `ignore-file` | Custom ignore file | - |
+| `no-default-ignores` | Disable default ignores | `false` |
+
+## Outputs
+
+| Output | Description |
+|--------|-------------|
+| `output-file` | Path to generated file |
+| `token-count` | Approximate token count |
+
+## Examples
+
+### Upload as artifact
+
+```yaml
+- uses: nikolay-e/treemapper/.github/actions/treemapper@main
+  with:
+    output: 'codebase.yaml'
+
+- uses: actions/upload-artifact@v4
+  with:
+    name: llm-context
+    path: codebase.yaml
+```
+
+### PR comment with token count
+
+```yaml
+- uses: nikolay-e/treemapper/.github/actions/treemapper@main
+  id: treemap
+  with:
+    path: './src'
+
+- uses: actions/github-script@v7
+  with:
+    script: |
+      github.rest.issues.createComment({
+        owner: context.repo.owner,
+        repo: context.repo.repo,
+        issue_number: context.issue.number,
+        body: `📊 Codebase: ${{ steps.treemap.outputs.token-count }}`
+      })
+```

.github/actions/treemapper/action.yml

@@ -0,0 +1,100 @@
+name: 'TreeMapper'
+description: 'Export codebase structure and contents for AI/LLM context'
+author: 'nikolay-e'
+
+branding:
+  icon: 'folder'
+  color: 'blue'
+
+inputs:
+  path:
+    description: 'Directory to analyze'
+    required: false
+    default: '.'
+  format:
+    description: 'Output format (yaml, json, txt, md)'
+    required: false
+    default: 'yaml'
+  output:
+    description: 'Output file path'
+    required: false
+    default: 'tree.yaml'
+  max-depth:
+    description: 'Maximum traversal depth'
+    required: false
+  no-content:
+    description: 'Skip file contents (structure only)'
+    required: false
+    default: 'false'
+  max-file-bytes:
+    description: 'Skip files larger than N bytes (0 for unlimited)'
+    required: false
+  ignore-file:
+    description: 'Path to custom ignore file'
+    required: false
+  no-default-ignores:
+    description: 'Disable default ignores'
+    required: false
+    default: 'false'
+  python-version:
+    description: 'Python version to use'
+    required: false
+    default: '3.11'
+
+outputs:
+  output-file:
+    description: 'Path to generated output file'
+    value: ${{ steps.run.outputs.output-file }}
+  token-count:
+    description: 'Approximate token count'
+    value: ${{ steps.run.outputs.token-count }}
+
+runs:
+  using: 'composite'
+  steps:
+    - name: Set up Python
+      uses: actions/setup-python@v5
+      with:
+        python-version: ${{ inputs.python-version }}
+
+    - name: Install treemapper
+      shell: bash
+      run: pip install treemapper
+
+    - name: Run treemapper
+      id: run
+      shell: bash
+      run: |
+        ARGS="${{ inputs.path }}"
+        ARGS="$ARGS -f ${{ inputs.format }}"
+        ARGS="$ARGS -o ${{ inputs.output }}"
+
+        if [ -n "${{ inputs.max-depth }}" ]; then
+          ARGS="$ARGS --max-depth ${{ inputs.max-depth }}"
+        fi
+
+        if [ "${{ inputs.no-content }}" = "true" ]; then
+          ARGS="$ARGS --no-content"
+        fi
+
+        if [ -n "${{ inputs.max-file-bytes }}" ]; then
+          ARGS="$ARGS --max-file-bytes ${{ inputs.max-file-bytes }}"
+        fi
+
+        if [ -n "${{ inputs.ignore-file }}" ]; then
+          ARGS="$ARGS -i ${{ inputs.ignore-file }}"
+        fi
+
+        if [ "${{ inputs.no-default-ignores }}" = "true" ]; then
+          ARGS="$ARGS --no-default-ignores"
+        fi
+
+        # Capture stderr for token count
+        OUTPUT=$(treemapper $ARGS 2>&1 >/dev/null) || true
+        TOKEN_COUNT=$(echo "$OUTPUT" | grep -oE '^~?[0-9,]+ tokens' | head -1 || echo "unknown")
+
+        echo "output-file=${{ inputs.output }}" >> $GITHUB_OUTPUT
+        echo "token-count=$TOKEN_COUNT" >> $GITHUB_OUTPUT
+
+        # Actually run it
+        treemapper $ARGS