firefrost-gaming/firefrost-operations-manual

Files

Claude fa5ca37330 feat: implement needs-board-sync label workflow

IMPLEMENTED: Label-based project board sync workflow

Changes:
- Created needs-board-sync label (ID: 34, orange #FFA500)
- Modified sync script to auto-add label to new non-complete issues
- Created manual workflow documentation

Why this approach:
- Gitea Projects REST API does NOT exist even in 1.25.5
- Gemini was incorrect about API availability in 1.22+
- Projects API still in development (PR #36824, targeting 1.26.0+)
- Confirmed via swagger spec: zero /projects endpoints exist

How it works:
1. Sync script creates issues with needs-board-sync label
2. Filter by label in Gitea UI
3. Drag to project board (Backlog column)
4. Remove label after syncing
5. Takes 30-60 seconds per sync session

Future automation:
When Gitea 1.26.0+ releases with Projects API, we'll modify
the sync script to use /projects/ endpoints and remove this
manual workflow.

Related: Gitea successfully upgraded to 1.25.5 earlier this session

Signed-off-by: The Chronicler <claude@firefrostgaming.com>

2026-03-21 08:09:37 +00:00

3.8 KiB

Raw Blame History

Manual Workflow: Syncing New Issues to Project Board

Created: March 21, 2026
Status: ACTIVE (until Gitea Projects API becomes available)
Estimated Time: 30-60 seconds per sync session

Why This Workflow Exists

The Problem:

Gitea's Projects REST API doesn't exist yet (not even in 1.25.5)
Gemini was incorrect about API availability in 1.22+
Projects API is in development (PR #36824, targeting 1.26.0+)

The Solution:

Automated sync script adds needs-board-sync label to new issues
Manual step: drag labeled issues to project board
Remove label after adding to board

The Workflow

Step 1: Run Task Sync Script

Whenever you add tasks to docs/core/tasks.md:

cd /home/claude/firefrost-operations-manual
python3 scripts/sync-tasks-to-issues.py

What happens:

Script creates Gitea issues for new tasks
Automatically adds needs-board-sync label (orange) to non-complete tasks
Issues with status/done do NOT get the sync label

Step 2: Filter Issues in Gitea

Open https://git.firefrostgaming.com/firefrost-gaming/firefrost-operations-manual/issues
Click "Labels" dropdown
Select needs-board-sync (orange label)
You'll see all issues that need to be added to the project board

Step 3: Add to Project Board

Open the Firefrost Operations project board: https://git.firefrostgaming.com/orgs/firefrost-gaming/projects/1
For each issue with needs-board-sync label:
- Drag the issue card to the appropriate column:
  - Backlog - Default for most new tasks
  - Michael - Tasks - If assigned to Michael
  - Meg - Tasks - If assigned to Meg
  - Holly - Tasks - If assigned to Holly
- Or click the issue → "Projects" dropdown → Select "Firefrost Operations" → Choose column

Step 4: Remove Label

After adding to board:

Open the issue
Click the needs-board-sync label to remove it
Issue is now synced!

Pro tip: You can bulk-remove labels:

Select multiple issues (checkboxes on left)
Actions dropdown → "Remove label" → needs-board-sync

Quick Reference

Label created: March 21, 2026
Label ID: 34
Label color: #FFA500 (orange)
Description: "New issue needs to be added to project board"

Filter URL: https://git.firefrostgaming.com/firefrost-gaming/firefrost-operations-manual/issues?labels=34

Project Board: https://git.firefrostgaming.com/orgs/firefrost-gaming/projects/1

When This Workflow Will Become Automated

Current Gitea version: 1.25.5
Projects API availability: Not yet (in development)
Target version: 1.26.0+ (estimated)

When 1.26.0+ is released:

Upgrade Gitea to version with Projects API
Modify sync script to use /projects/ endpoints
Auto-add new issues to "Backlog" column via API
Remove needs-board-sync label logic
Archive this manual workflow document

Troubleshooting

Q: Why don't I see the needs-board-sync label on some new issues?
A: Issues marked as ✅ COMPLETE in tasks.md don't get the label (they're already done, no need to add to board)

Q: Can I filter by multiple labels?
A: Yes! Click multiple labels to see issues with ALL selected labels

Q: What if I forget to remove the label?
A: No problem - the label is just a reminder. It doesn't affect anything if you leave it on.

Q: Can I change the label color?
A: Yes! Go to Repository → Labels → Edit the needs-board-sync label

scripts/sync-tasks-to-issues.py - Automated sync script
docs/tasks/gitea-upgrade/ - Gitea 1.25.5 upgrade documentation
docs/reference/cockpit-quick-reference.md - Server access guide

Created by: The Chronicler (Session 37)
Last Updated: March 21, 2026
Status: ACTIVE - Manual workflow until Projects API available

3.8 KiB Raw Blame History