feat: project colors, timeline filters, sidebar fix, GitLooper agent, and misc improvements

- Fix sidebar double-highlight on /vacations/my (Gitea #6): add isNavItemActive() helper - Add project color picker (schema + API + modal + timeline rendering) - Add ProjectCombobox/ResourceCombobox to timeline toolbar - Show PENDING vacations on timeline with dashed/dimmed style - Add "show demand projects" preference with localStorage persistence - Add ProjectAssignmentsTable with total hours/cost columns - Extend vacation API to accept status arrays - Add GitLooper formal YAML agent configuration - Extend user admin with permission overrides UI - Add delete-assignment use case tests - Add status-styles.ts shared badge constants - Centralize formatMoney/formatCents in format.ts Co-Authored-By: claude-flow <ruv@ruv.net>
2026-03-17 10:22:52 +01:00
parent b0e55786c3
commit eb283147d1
34 changed files with 1545 additions and 255 deletions
@@ -0,0 +1,121 @@
+# GitLooper Strategy
+
+**Date:** 2026-03-17
+**Epic:** Gitea Integration + Autonomous Issue Processing
+
+## Overview
+
+GitLooper is a Claude Code slash command (`/gitlooper:gitlooper`) that connects to Planarchy's Gitea instance, reads open issues, triages them, and autonomously implements fixes/features using spawned sub-agents.
+
+## Architecture
+
+```
+User runs /gitlooper:gitlooper
+        │
+        ▼
+┌─────────────────────┐
+│  Phase 1: FETCH     │  Gitea REST API → list open issues
+│  & TRIAGE           │  Classify: bug / feature / ux
+│                     │  Estimate effort: S / M / L
+│                     │  Present table → user approves
+└────────┬────────────┘
+         │ user picks issues
+         ▼
+┌─────────────────────┐
+│  Phase 2: SOLVE     │  Per approved issue:
+│  (sequential)       │  1. Comment on Gitea: "Working on this..."
+│                     │  2. Analyze issue + screenshots
+│                     │  3. Spawn coder agent (worktree)
+│                     │  4. Spawn tester agent (verify)
+│                     │  5. Merge + commit
+└────────┬────────────┘
+         │
+         ▼
+┌─────────────────────┐
+│  Phase 3: REPORT    │  Comment resolution on Gitea
+│  & CLOSE            │  Close issue via API
+└────────┬────────────┘
+         │
+         ▼
+┌─────────────────────┐
+│  Phase 4: PUSH      │  git push origin main
+│  & SUMMARY          │  Final summary table
+└─────────────────────┘
+```
+
+## Gitea Connection
+
+- **Instance:** `https://gitea.hartmut-noerenberg.com`
+- **Repo:** `Hartmut/plANARCHY`
+- **Auth:** Personal access token stored in `~/.gitea-token`
+- **API Base:** `https://gitea.hartmut-noerenberg.com/api/v1`
+
+## Current Open Issues (2026-03-17)
+
+| # | Title | Type | Effort | Reporter | Priority |
+|---|-------|------|--------|----------|----------|
+| 3 | No Blueprints available in New Project Wizard | bug | S | Larissa | P1 |
+| 5 | Account not linked to a resource | bug | S | Larissa | P1 |
+| 7 | Dropdown menu broken in vacation management | bug | S | Larissa | P1 |
+| 6 | My Vacations and Vacation Mgmt selected simultaneously | bug | S | Larissa | P2 |
+| 10 | Sick leave not automatically added to timeline | bug | M | Larissa | P2 |
+| 8 | Assign different color to Public Holidays vs Annual Vacation | ux | S | Larissa | P3 |
+| 4 | Display Hours/Costs total per resource in Project Overview | feature | M | Larissa | P3 |
+| 2 | Keep search bar locations consistent on all pages | feature | M | Larissa | P3 |
+| 9 | Preferences: toggle "include demand projects" on page load | feature | M | Larissa | P4 |
+| 1 | Assign a color to a project | feature | L | Larissa | P4 |
+
+### Triage Notes
+
+**P1 — Bugs (blocking):**
+- **#3** — Blueprints likely not seeded in the new Gitea DB, or the query returns empty. Quick check of `blueprint.list` query.
+- **#5** — User account created but `Resource.userId` not linked. Need to link Larissa's account to her resource record.
+- **#7** — Chapter dropdown filter in VacationClient resets options after selecting one. Likely a state management bug in the filter component.
+
+**P2 — Bugs (non-blocking):**
+- **#6** — AppShell sidebar highlights both "My Vacations" and "Vacation Mgmt" simultaneously. URL path matching issue.
+- **#10** — Sick leave entries (vacation type SICK) not showing on timeline. The timeline `getEntries` query likely filters vacation types.
+
+**P3 — UX/Feature (quick wins):**
+- **#8** — VacationClient uses same color for all vacation types. Add type-specific colors.
+- **#4** — Add "Total Hours" and "Total Costs" columns to ProjectAssignmentsTable.
+- **#2** — Add search bars to Timeline page matching Allocations page layout.
+
+**P4 — Feature (larger scope):**
+- **#9** — User preferences system (new DB field or localStorage) for default filter state.
+- **#1** — Project color field + color picker in UI + timeline rendering by project color.
+
+## Agent Spawning Strategy
+
+### For bugs (S effort):
+Direct fix in main context — no worktree needed. Read, fix, test, commit.
+
+### For features (M effort):
+Spawn a **coder** agent with `isolation: "worktree"` to keep main clean. Review output before merging.
+
+### For features (L effort):
+Spawn a **planner** agent first to create implementation plan. Then spawn **coder** agent per task in the plan. Requires user approval at each stage.
+
+## Usage
+
+```bash
+# Triage all open issues (dry run)
+/gitlooper:gitlooper --dry-run
+
+# Work on all approved issues
+/gitlooper:gitlooper
+
+# Work on a specific issue
+/gitlooper:gitlooper 7
+
+# Parallel mode (use with care)
+/gitlooper:gitlooper --parallel
+```
+
+## Files Created
+
+| File | Purpose |
+|------|---------|
+| `.claude/commands/gitlooper/gitlooper.md` | Slash command definition |
+| `~/.gitea-token` | API token (chmod 600, not in repo) |
+| `docs/gitlooper-strategy.md` | This strategy document |