# Gitea Actions Runner Configuration Request

**Type:** feature  
**Date:** 2025-11-11  
**Status:** captured

---

## Description

We've just completed **Phase 3: Gitea Actions Workflows Setup** and have implemented two workflows:

1. **KB Lint Workflow** (`.github/workflows/kb-lint.yml`) - Validates KB file naming, frontmatter, and structure
2. **KB Index Update Workflow** (`.github/workflows/kb-index-update.yml`) - Auto-updates KB index on push to main

## Current Status

The workflows are properly configured and trigger correctly when KB files change. However, workflows are stuck in "Waiting" status because **no Gitea Actions runners are available** to execute them.

**Example**: We created a test KB file (`kb/01_projects/tendril/2025-11-11--test-kb-workflow--note.md`) to test the KB lint workflow. The workflow triggered correctly but has been waiting for over 3 minutes for a runner to become available.

## What We're Trying to Do

1. **Test KB Lint Workflow**: Validate that KB files follow naming conventions and frontmatter requirements
2. **Test KB Index Update Workflow**: Verify automatic index regeneration when KB files are added/modified
3. **Validate Phase 3 Implementation**: Confirm that Gitea Actions workflows are working correctly

## Request

Please configure Gitea Actions runners for the `Mycelium/tendril` repository so that workflows can execute.

### Required Runner Configuration

- **Platform**: `ubuntu-latest` (as specified in workflows)
- **Labels**: Should match `runs-on: ubuntu-latest` in workflow files
- **Repository**: `Mycelium/tendril`
- **Permissions**: 
  - KB Lint workflow needs `contents: read`
  - KB Index Update workflow needs `contents: write`

### Workflow Details

**KB Lint Workflow** (`.github/workflows/kb-lint.yml`):
- Triggers on: Push and pull requests when `kb/**/*.md` files change
- Purpose: Validates KB file naming pattern, frontmatter, and structure
- Permissions: `contents: read`

**KB Index Update Workflow** (`.github/workflows/kb-index-update.yml`):
- Triggers on: Push to `main` branch when `kb/**/*.md` files change
- Purpose: Automatically regenerates `kb/_index.md` when KB files are added/modified
- Permissions: `contents: write` (needs to commit and push index updates)

## Testing Plan

Once runners are configured, we will:

1. Verify KB lint workflow validates test file correctly
2. Test with invalid KB file to confirm validation catches errors
3. Test KB index update workflow on main branch
4. Clean up test file after validation

## References

- **Gitea Actions Documentation**: https://docs.gitea.com/usage/actions/
- **Gitea Runner Setup**: https://docs.gitea.com/usage/actions/runner/
- **Workflow Files**: 
  - `.github/workflows/kb-lint.yml`
  - `.github/workflows/kb-index-update.yml`
- **Project Documentation**: `docs/GITEA/Gitea-Actions-Guide.md`

## Additional Notes

- Workflows use standard GitHub Actions YAML format (Gitea Actions is compatible)
- All workflows are properly configured and trigger correctly
- The issue is solely that runners need to be registered/configured
- Test file will be deleted after workflow validation is complete

---

**Branch**: `docs/contributing-guide-and-workflow`  
**Related**: Phase 3 implementation, KB system setup